Pinterest API: Pines — Comentarios por ID de pin

Qué hace este endpoint

Qué puedes construir con este método de API

Revisa primero el resultado y los flujos habituales y luego pasa a los parámetros y a un ejemplo de solicitud funcional.

En qué te ayuda este endpoint

La respuesta incluye los elementos de la conversación, datos públicos de los autores, señales de interacción y campos de paginación.

Cuándo usarlo

Usa «Comentarios por ID de pin» cuando necesites el texto de la conversación, los autores, las marcas de tiempo y la paginación secuencial.

Casos de uso habituales

Monitorización de conversaciones

Sigue las reacciones de la audiencia bajo el contenido y en torno a los objetos seleccionados.

Moderación

Envía mensajes públicos a colas de revisión, clasificación y control de calidad.

Análisis de comentarios

Usa el texto de las conversaciones y sus metadatos en informes y estudios de audiencia.

Versiones disponibles

Versión de la respuesta

Ambas versiones resuelven la misma tarea y aceptan los mismos parámetros. Usa el selector para comparar la estructura de la respuesta y elegir la versión que espera tu cliente.

Versión de la respuesta V2

Cambia de versión en esta página para comparar las estructuras de respuesta manteniendo la misma URL de documentación.

Qué se mantiene igual

La autenticación, los parámetros obligatorios y la forma de la solicitud son iguales en V1 y V2. En la práctica, eliges la versión al construir la ruta del endpoint y al interpretar la respuesta.

Qué cambia entre versiones

La diferencia principal está en el envoltorio de la respuesta. Usa V2 para integraciones nuevas y mantén V1 solo cuando necesites compatibilidad con un contrato de cliente existente.

Cómo usarlo

Cómo llamar al método

Usa la misma cabecera de clave de API y los mismos parámetros de consulta en ambas versiones. Esta documentación muestra primero el conjunto de parámetros común y después las rutas y fragmentos de código de cada versión.

Parámetros de entrada

Parámetros comunes

Parámetro	Obligatorio	Tipo	Ejemplo	Descripción
`pin_id`	Sí	`str`	`99360735500167749`	Pinterest pin identifier. Example: 99360735500167749.
`aggregated_pin_id`	No	`str \| None`	`99360735500167749`	Optional aggregated pin identifier used for Pinterest comments. Example: 99360735500167749.
`cursor`	No	`str \| None`	`cursor-next-page`	Cursor de la página siguiente devuelto por la respuesta anterior. Omítelo para la primera página.
`is_reversed`	No	`bool`	`False`	Whether to reverse the Pinterest comments order. Example: false.

Ruta de solicitud por versión

V2

Elige una versión cuando copies la ruta exacta del endpoint, la URL de ejemplo y el fragmento de código. La lista de parámetros de arriba no cambia.

GET /api/v2/pinterest.com/pins/comments-by-pin-id

Formato normalizado

Vista previa de la solicitud

URL base https://www.scrapestorm.net

Endpoint /api/v2/pinterest.com/pins/comments-by-pin-id

Parámetros obligatorios

pin_id

Parámetros opcionales

aggregated_pin_id cursor is_reversed

URL de ejemplo

https://www.scrapestorm.net/api/v2/pinterest.com/pins/comments-by-pin-id?pin_id=99360735500167749

Ejemplos de código

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/pinterest.com/pins/comments-by-pin-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'pin_id=99360735500167749' \
  # Optional parameters:
  # --data-urlencode 'aggregated_pin_id=99360735500167749'
  # --data-urlencode 'cursor=cursor-next-page'
  # --data-urlencode 'is_reversed=False'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/pinterest.com/pins/comments-by-pin-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "pin_id": "99360735500167749",
}

# Optional parameters
# params["aggregated_pin_id"] = "99360735500167749"
# params["cursor"] = "cursor-next-page"
# params["is_reversed"] = "False"

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v2/pinterest.com/pins/comments-by-pin-id";

const params = new URLSearchParams({
  pin_id: "99360735500167749",
});

// Optional parameters
// params.set("aggregated_pin_id", "99360735500167749");
// params.set("cursor", "cursor-next-page");
// params.set("is_reversed", "False");

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const payload = await response.json();
console.log(payload);

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  pin_id: "99360735500167749",
};

// Optional parameters
// params.aggregated_pin_id = "99360735500167749";
// params.cursor = "cursor-next-page";
// params.is_reversed = "False";

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "pin_id" => "99360735500167749",
];

// Optional parameters
// $query["aggregated_pin_id"] = "99360735500167749";
// $query["cursor"] = "cursor-next-page";
// $query["is_reversed"] = "False";

try {
    $response = $client->request("GET", "/api/v2/pinterest.com/pins/comments-by-pin-id", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "time"
)

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v2/pinterest.com/pins/comments-by-pin-id"

    params := url.Values{}
    params.Set("pin_id", "99360735500167749")

    // Optional parameters
    // params.Set("is_reversed", "False")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

Ruta de solicitud por versión

V1

Elige una versión cuando copies la ruta exacta del endpoint, la URL de ejemplo y el fragmento de código. La lista de parámetros de arriba no cambia.

GET /api/v1/pinterest.com/pins/comments-by-pin-id

Formato nativo de la plataforma

Vista previa de la solicitud

URL base https://www.scrapestorm.net

Endpoint /api/v1/pinterest.com/pins/comments-by-pin-id

Parámetros obligatorios

pin_id

Parámetros opcionales

aggregated_pin_id cursor is_reversed

URL de ejemplo

https://www.scrapestorm.net/api/v1/pinterest.com/pins/comments-by-pin-id?pin_id=99360735500167749

Ejemplos de código

curl --request GET \
  --url "https://www.scrapestorm.net/api/v1/pinterest.com/pins/comments-by-pin-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'pin_id=99360735500167749' \
  # Optional parameters:
  # --data-urlencode 'aggregated_pin_id=99360735500167749'
  # --data-urlencode 'cursor=cursor-next-page'
  # --data-urlencode 'is_reversed=False'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v1/pinterest.com/pins/comments-by-pin-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "pin_id": "99360735500167749",
}

# Optional parameters
# params["aggregated_pin_id"] = "99360735500167749"
# params["cursor"] = "cursor-next-page"
# params["is_reversed"] = "False"

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v1/pinterest.com/pins/comments-by-pin-id";

const params = new URLSearchParams({
  pin_id: "99360735500167749",
});

// Optional parameters
// params.set("aggregated_pin_id", "99360735500167749");
// params.set("cursor", "cursor-next-page");
// params.set("is_reversed", "False");

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const payload = await response.json();
console.log(payload);

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  pin_id: "99360735500167749",
};

// Optional parameters
// params.aggregated_pin_id = "99360735500167749";
// params.cursor = "cursor-next-page";
// params.is_reversed = "False";

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "pin_id" => "99360735500167749",
];

// Optional parameters
// $query["aggregated_pin_id"] = "99360735500167749";
// $query["cursor"] = "cursor-next-page";
// $query["is_reversed"] = "False";

try {
    $response = $client->request("GET", "/api/v1/pinterest.com/pins/comments-by-pin-id", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "time"
)

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v1/pinterest.com/pins/comments-by-pin-id"

    params := url.Values{}
    params.Set("pin_id", "99360735500167749")

    // Optional parameters
    // params.Set("is_reversed", "False")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

Ejemplo de respuesta

Respuesta en vivo por versión

La vista previa conserva los campos clave y los primeros elementos de la colección para que puedas revisar rápidamente la forma de la respuesta. Al cambiar de versión cambia el formato del JSON.

Ejemplo de respuesta

V2 JSON de respuesta

Ejemplo verificado

Este ejemplo JSON compacto procede de la última ejecución de verificación correcta de V2.

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "pin_id": "99360735500167749",
    "is_reversed": false
  },
  "data": {
    "comments": {
      "count": 10,
      "items": [
        {
          "url": null,
          "comment_id": "4928161013185919842",
          "text": null,
          "emails": [],
          "created_at": "2017-10-13T14:37:17+00:00",
          "author": {
            "url": "https://www.pinterest.com/agauvin000/",
            "user_id": "431501345455978386",
            "username": "agauvin000",
            "display_name": "André Gauvin",
            "is_private": false,
            "avatar_url": "https://example.com/image.jpg"
          },
          "like_count": 8,
          "reply_count": 4,
          "helpful_count": 0,
          "is_edited": null,
          "thumbnail_url": "https://example.com/image.jpg",
          "images": [
            {
              "url": "https://i.pinimg.com/originals/e3/a5/7e/e3a57eb71f35406322f327b1e338ede2.jpg",
              "width": 640,
              "height": 480
            },
            {
              "url": "https://i.pinimg.com/150x150/e3/a5/7e/e3a57eb71f35406322f327b1e338ede2.jpg",
              "width": 150,
              "height": 150
            }
          ]
        },
        {
          "url": null,
          "comment_id": "5237823761574576454",
          "text": "me gusta todo esto gracias",
          "emails": [],
          "created_at": "2022-06-18T14:55:42+00:00",
          "author": {
            "url": "https://www.pinterest.com/cartagena2522/",
            "user_id": "1053349937753928775",
            "username": "cartagena2522",
            "display_name": "Maria Pineda",
            "is_private": false,
            "avatar_url": "https://example.com/image.jpg"
          },
          "like_count": 1,
          "reply_count": 0,
          "helpful_count": 0,
          "is_edited": false,
          "thumbnail_url": null,
          "images": []
        },
        {
          "_more_items": 8
        }
      ]
    }
  }
}

Ejemplo de respuesta

V1 JSON de respuesta

Ejemplo verificado

Este ejemplo JSON compacto procede de la última ejecución de verificación correcta de V1.

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "is_reversed": false,
    "pin_id": "99360735500167749"
  },
  "data": {
    "resource_response": {
      "status": "success",
      "code": 0,
      "message": "ok",
      "endpoint_name": "v3_get_aggregated_pin_data_unified_comments",
      "data": [
        {
          "node_id": "VXNlckRpZEl0RGF0YTo0OTI4MTYxMDEzMTg1OTE5ODQy",
          "done_at": "Fri, 13 Oct 2017 14:37:17 +0000",
          "tagged_users": [],
          "tags": [],
          "videos": [],
          "comment_count": 4,
          "marked_helpful_by_me": false,
          "text_tags": [],
          "type": "userdiditdata",
          "image_signatures": [
            "e3a57eb71f35406322f327b1e338ede2"
          ],
          "highlighted_by_pin_owner": false,
          "details": "",
          "helpful_count": 0,
          "liked_by_me": false,
          "like_count": 8,
          "user": {
            "node_id": "VXNlcjo0MzE1MDEzNDU0NTU5NzgzODY=",
            "full_name": "André Gauvin",
            "type": "user",
            "image_medium_url": "https://i.pinimg.com/75x75_RS/2a/2f/0b/2a2f0b0edac8d491acfd9cded95dfa7b.jpg",
            "is_private_profile": false,
            "first_name": "André",
            "id": "431501345455978386",
            "username": "agauvin000"
          },
          "images": [
            {
              "originals": "…",
              "150x150": "…"
            }
          ],
          "id": "4928161013185919842"
        },
        {
          "node_id": "QWdncmVnYXRlZENvbW1lbnQ6NTIzNzgyMzc2MTU3NDU3NjQ1NA==",
          "is_translatable": false,
          "tagged_users": [],
          "created_at": "Sat, 18 Jun 2022 14:55:42 +0000",
          "tags": [],
          "comment_count": 0,
          "marked_helpful_by_me": false,
          "is_edited": false,
          "type": "aggregatedcomment",
          "text": "me gusta todo esto gracias",
          "highlighted_by_pin_owner": false,
          "media": null,
          "reaction_counts": {
            "1": 1
          },
          "comment_tag": null,
          "helpful_count": 0,
          "user": {
            "node_id": "VXNlcjoxMDUzMzQ5OTM3NzUzOTI4Nzc1",
            "full_name": "Maria Pineda",
            "type": "user",
            "image_medium_url": "https://i.pinimg.com/75x75_RS/c4/ec/38/c4ec38692be3094dddc8acf035efdf74.jpg",
            "is_private_profile": false,
            "first_name": "Maria",
            "id": "1053349937753928775",
            "username": "cartagena2522"
          },
          "reaction_by_me": 0,
          "id": "5237823761574576454"
        },
        {
          "_more_items": 8
        }
      ],
      "bookmark": "Y2JVSG80ZUdaRVJUSlBSRUV5VFZSbmVrNUVZM2hQUkZGNlRucFJjVkl4UmsxTGJuaHFUbnBqZVU1cVpHbE9ha1UxV1ZSbk5VMUhXVEJOUkd0NFRXMU5lazF0UlhwUFIwbDRXV3BaTWsxVVJtMU9lazEzVGxkSk5VNTZSbXRPVkVwb1RVU…",
      "x_pinterest_sli_endpoint_name": "v3_get_aggregated_pin_data_unified_comments",
      "http_status": 200
    },
    "client_context": {
      "analysis_ua": {
        "app_type": 5,
        "app_version": "",
        "browser_name": "Chrome",
        "browser_version": "145.0.0",
        "device_type": null,
        "device": "Other",
        "os_name": "Windows 10",
        "os_version": "10"
      },
      "app_type_detailed": 5,
      "app_version": "e86b6e0",
      "autologin": null,
      "browser_locale": "en-US",
      "browser_name": "Chrome",
      "browser_type": 1,
      "browser_version": "145.0.0",
      "country": "US",
      "country_from_hostname": "US",
      "country_from_ip": "US",
      "csp_nonce": "e328214a8d970a9cd5310dec4667d9e2",
      "current_url": "https://www.pinterest.com/resource/UnifiedCommentsResource/get/?source_url=/pin/99360735500167749/&data=%7B%22options%22:%7B%22aggregated_pin_id%22:%224793404135709870511%22,%22…",
      "debug": false,
      "deep_link": "",
      "enabled_advertiser_countries": [
        "AR",
        "AT",
        {
          "_more_items": 24
        }
      ],
      "facebook_token": null,
      "full_path": "/resource/UnifiedCommentsResource/get/?source_url=/pin/99360735500167749/&data=%7B%22options%22:%7B%22aggregated_pin_id%22:%224793404135709870511%22,%22comment_featured_ids%22:%…",
      "http_referrer": "https://www.pinterest.com/",
      "impersonator_user_id": null,
      "invite_code": "",
      "invite_sender_id": "",
      "is_authenticated": false,
      "is_bot": "false",
      "_more_fields": "33 more fields"
    },
    "resource": {
      "name": "UnifiedCommentsResource",
      "options": {
        "bookmarks": [
          "Y2JVSG80ZUdaRVJUSlBSRUV5VFZSbmVrNUVZM2hQUkZGNlRucFJjVkl4UmsxTGJuaHFUbnBqZVU1cVpHbE9ha1UxV1ZSbk5VMUhXVEJOUkd0NFRXMU5lazF0UlhwUFIwbDRXV3BaTWsxVVJtMU9lazEzVGxkSk5VNTZSbXRPVkVwb1RVU…"
        ],
        "aggregated_pin_id": "4793404135709870511",
        "comment_featured_ids": [],
        "page_size": 10,
        "redux_normalize_feed": true,
        "is_reversed": false
      }
    },
    "request_identifier": "1680618347184374"
  }
}

Métodos relacionados

Sigue trabajando con Pines

Los métodos cercanos te permiten resolver el mismo objeto con otro identificador, abrir detalles o pasar a una vista agregada.

Qué hacer después

Continúa la evaluación

Usa esta documentación como primer punto de decisión y luego revisa los precios, la cobertura de la plataforma y las reglas de integración antes de conectar el endpoint para un uso recurrente.

Abre la página de la plataforma Pinterest

Compara entidades cercanas, grupos de métodos de API y documentación relacionada antes de implementar.

Abrir la página de la plataforma

Compara los precios de los métodos de API

Comprueba dónde se sitúa este método en la tabla pública de precios antes de escalar el uso.

Ver precios

Revisa las reglas de integración

Usa la documentación inicial para confirmar la autenticación, las versiones, los reintentos y las diferencias entre prueba y producción.

Abrir la documentación

Preguntas frecuentes

Preguntas que los equipos hacen antes de implementar

Usa estas respuestas para decidir si este método de API encaja con tu flujo, tu elección de versión y tu plan de despliegue.

¿Qué datos devuelve este método de la API de Pinterest?

El método realiza «Comentarios por ID de pin» para Pines. El ejemplo compacto de respuesta de abajo muestra la estructura exacta de los campos.

¿Debo elegir V1 o V2?

Elige V2 para integraciones nuevas porque ofrece una estructura normalizada. Usa V1 solo por compatibilidad con clientes que ya consumen el formato nativo de la plataforma.

¿Qué necesito para la primera solicitud?

Crea una clave de API, envíala en la cabecera de la solicitud e indica los parámetros obligatorios de la tabla. Los ejemplos de código ya contienen la ruta y la estructura de solicitud correctas.

Pinterest API: Pines — Comentarios por ID de pin

Qué puedes construir con este método de API

En qué te ayuda este endpoint

Cuándo usarlo

Casos de uso habituales

Monitorización de conversaciones

Moderación

Análisis de comentarios

Versión de la respuesta

Qué se mantiene igual

Qué cambia entre versiones

Cómo llamar al método

Parámetros de entrada

Ruta de solicitud por versión

Ejemplos de código

Ruta de solicitud por versión

Ejemplos de código

Respuesta en vivo por versión

V2 JSON de respuesta

V1 JSON de respuesta

Sigue trabajando con Pines

Pines: Detalles por ID de pin

Continúa la evaluación

Abre la página de la plataforma Pinterest

Compara los precios de los métodos de API

Revisa las reglas de integración

Preguntas que los equipos hacen antes de implementar