Pinterest API: Pin 图 — 按 Pin ID 获取评论

此端点的作用

利用此 API 方法可以构建什么

先查看结果和常见工作流，然后再了解参数和可运行的请求示例。

此端点可以帮助您

响应包含对话条目、公开的作者数据、互动信号和分页字段。

何时使用

当您需要讨论文本、作者、时间戳和顺序分页时，请使用“按 Pin ID 获取评论”。

常见使用场景

对话监控

跟踪受众在内容下方以及围绕所选对象的反应。

内容审核

将公开消息送入审核、分类和质量控制队列。

反馈分析

在报告和受众研究中使用讨论文本和元数据。

可用版本

响应版本

两个版本完成相同的任务，接受相同的参数。使用切换按钮比较响应结构，并选择您的客户端所需的版本。

响应版本 V2

在本页面切换版本，即可在同一文档 URL 下比较响应结构。

保持不变的部分

V1 和 V2 的身份验证、必填参数和请求结构均相同。实际上，您只需在构建端点路径和解析响应时选择版本。

版本之间的差异

主要区别在于响应结构。新集成请使用 V2；仅在需要兼容现有客户端契约时保留 V1。

使用方法

如何调用该方法

两个版本使用相同的 API 密钥请求头和相同的查询参数。本文档先展示共享的参数集合，然后展示各版本特定的端点路径和代码片段。

输入参数

共享参数

参数	必填	类型	示例	说明
`pin_id`	是	`str`	`99360735500167749`	Pinterest pin identifier. Example: 99360735500167749.
`aggregated_pin_id`	否	`str \| None`	`99360735500167749`	Optional aggregated pin identifier used for Pinterest comments. Example: 99360735500167749.
`cursor`	否	`str \| None`	`cursor-next-page`	上一次响应返回的下一页游标。获取第一页时请省略。
`is_reversed`	否	`bool`	`False`	Whether to reverse the Pinterest comments order. Example: false.

各版本的请求路径

V2

复制确切的端点路径、示例 URL 和代码片段时请选择版本。上方的参数列表保持不变。

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

规范化格式

请求预览

基础 URL https://www.scrapestorm.net

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

必填参数

pin_id

可选参数

aggregated_pin_id cursor is_reversed

示例 URL

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

代码示例

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)
}

各版本的请求路径

V1

复制确切的端点路径、示例 URL 和代码片段时请选择版本。上方的参数列表保持不变。

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

平台原生格式

请求预览

基础 URL https://www.scrapestorm.net

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

必填参数

pin_id

可选参数

aggregated_pin_id cursor is_reversed

示例 URL

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

代码示例

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)
}

响应示例

按版本查看真实响应

预览保留了关键字段和集合中的前几项，便于您快速浏览响应结构。切换版本会改变 JSON 格式。

响应示例

V2 响应 JSON

已验证示例

此简明 JSON 示例来自 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
        }
      ]
    }
  }
}

响应示例

V1 响应 JSON

已验证示例

此简明 JSON 示例来自 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"
  }
}

继续处理Pin 图

相邻的方法可让您用其他标识符解析同一对象、打开详情或转到汇总视图。

下一步

继续评估

将本文档作为第一个决策点，然后在将端点接入常规使用之前，继续了解价格、平台覆盖范围和集成规则。

打开 Pinterest 平台页面

在实现之前，比较相邻的实体、API 方法分组和相关文档。

打开平台页面

比较 API 方法价格

在扩大使用规模之前，查看此 API 方法在公开价格表中的位置。

查看价格

查看集成规则

通过入门文档确认身份验证、版本管理、重试以及模拟环境与正式环境的差异。

打开文档

常见问题

团队在实现前常问的问题

借助这些解答，判断此 API 方法是否适合您的工作流、版本选择和上线计划。

此 Pinterest API 方法返回哪些数据？

该方法针对Pin 图执行“按 Pin ID 获取评论”操作。下方的简明响应示例展示了确切的字段结构。

应该选择 V1 还是 V2？

新集成请选择 V2，因为它提供规范化的结构。仅在兼容已使用平台原生格式的客户端时使用 V1。

第一个请求需要准备什么？

创建 API 密钥，在请求头中发送它，并提供表格中的必填参数。代码示例中已包含正确的路径和请求结构。

Pinterest API: Pin 图 — 按 Pin ID 获取评论

利用此 API 方法可以构建什么

此端点可以帮助您

何时使用

常见使用场景

对话监控

内容审核

反馈分析

响应版本

保持不变的部分

版本之间的差异

如何调用该方法

输入参数

各版本的请求路径

代码示例

各版本的请求路径

代码示例

按版本查看真实响应

V2 响应 JSON

V1 响应 JSON

继续处理Pin 图

Pin 图: 按 Pin ID 获取详情

继续评估

打开 Pinterest 平台页面

比较 API 方法价格

查看集成规则

团队在实现前常问的问题