Pinterest API: ピン — ピン ID によるコメント

Q: この Pinterest API メソッドはどのようなデータを返しますか？

このメソッドは ピン に対して「ピン ID によるコメント」を実行します。以下のコンパクトなレスポンス例で、フィールドの正確な構造を確認できます。

このエンドポイントの機能

この API メソッドで構築できるもの

まず結果と一般的なワークフローを確認し、次にパラメーターと動作するリクエスト例に進んでください。

このエンドポイントが役立つこと

レスポンスには、会話の要素、投稿者の公開データ、エンゲージメントのシグナル、ページネーションのフィールドが含まれます。

使用に適した場面

会話のテキスト、投稿者、タイムスタンプ、継続的なページネーションが必要な場合に「ピン 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"
  }
}

ピンで作業を続ける

関連するメソッドでは、同じオブジェクトを別の識別子で解決したり、詳細を開いたり、集計ビューに切り替えたりできます。

次のステップ

評価を続ける

このドキュメントを最初の判断材料とし、継続的な利用のためにエンドポイントを接続する前に、料金、プラットフォームのカバー範囲、連携ルールを確認してください。

Pinterest のプラットフォームページを開く

実装の前に、関連するエンティティ、API メソッドのグループ、関連ドキュメントを比較してください。

プラットフォームページを開く

API メソッドの料金を比較する

利用を拡大する前に、公開料金表でこのメソッドの位置付けを確認してください。

料金を見る

連携ルールを確認する

入門ドキュメントで、認証、バージョン、再試行、テストと本番の違いを確認してください。

ドキュメントを開く

よくある質問

チームが実装前に尋ねる質問

これらの回答を参考に、この API メソッドがワークフロー、バージョンの選択、導入計画に合うかどうかを判断してください。

この Pinterest API メソッドはどのようなデータを返しますか？

このメソッドはピンに対して「ピン ID によるコメント」を実行します。以下のコンパクトなレスポンス例で、フィールドの正確な構造を確認できます。

V1 と V2 のどちらを選ぶべきですか？

新しい連携では、正規化された構造を提供する V2 を選んでください。V1 は、既にプラットフォーム固有の形式を処理しているクライアントとの互換性のためにのみ使用してください。

最初のリクエストには何が必要ですか？

API キーを作成し、リクエストヘッダーで送信し、表の必須パラメーターを指定してください。コード例には、正しいパスとリクエスト構造が既に含まれています。

Pinterest API: ピン — ピン ID によるコメント

この API メソッドで構築できるもの

このエンドポイントが役立つこと

使用に適した場面

主なユースケース

会話の監視

モデレーション

コメントの分析

レスポンスのバージョン

共通する点

バージョン間で異なる点

メソッドの呼び出し方

入力パラメーター

バージョン別のリクエストパス

コード例

バージョン別のリクエストパス

コード例

バージョン別のライブレスポンス

V2 レスポンスの JSON

V1 レスポンスの JSON

ピン で作業を続ける

ピン: ピン ID による詳細

評価を続ける

Pinterest のプラットフォームページを開く

API メソッドの料金を比較する

連携ルールを確認する

チームが実装前に尋ねる質問

ピンで作業を続ける