pinterest/
pins

ピンの直接URLやpin.itリンクから公開Pinterestピンを取得し、コンテンツ、投稿者情報、メディア、タイムスタンプ、表示中の指標を正規化レコードとして返します。

Pinterest Pins API

ピンURLで指定
投稿者とメディアの情報
表示中の指標のスナップショット
結果1件あたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Pinterest Pins

Pinterestピンは、タイトル、説明文、投稿者情報、画像または動画の参照、カテゴリ、ハッシュタグ、表示中のエンゲージメントを含む公開のビジュアル投稿です。これらのレコードは、選定したコンテンツのアーカイブ、クリエイティブやトピックのリサーチ、出典の記録、取得時点ごとの比較に活用できます。

Pinterest Pins API の主な機能

  • ピンの直接URLと短縮URL1つ以上の公開Pinterest /pin/{id} URLまたはpin.it短縮リンクを処理し、取得範囲を送信したピンに限定します。
  • コンテンツと投稿者のフィールドを紐付けピンのタイトルと本文を、元URL、公開されている投稿者情報、プロフィールURL、正規化された画像・動画の参照とあわせて返します。
  • 取得時刻付きの表示中の指標取得可能ないいね数・コメント数と投稿者のフォロワー数を collected_at とともに保持し、変動する公開値のスナップショット時刻を明確にします。
  • ピンの分類情報取得可能な post_type、categories、hashtags を extra に保持し、ピン本文に混ぜることなく形式やトピックの分析に使えるようにします。

Pinterest Pins API のパラメータ

パラメータ必須説明
urls必須必須。公開Pinterest /pin/{id} URLまたはpin.it短縮リンクのリストです。その他のPinterestパスやPinterest以外のホストは受け付けません。

Pinterest Pins API の使い方

必要な公開ピンを指定して送信し、非同期タスクを追跡して、正規化されたピンレコードをカーソルページネーションで読み取ります。

  1. 1つ以上の公開Pinterest /pin/{id} URLまたはpin.it短縮リンクを用意します。
  2. リンクを urls として /v1/pinterest/pins に送信し、task_id を保存します。
  3. 処理が成功するか失敗が返るまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間は next_cursor で次のページを取得します。
curl -X POST "https://api.socq.ai/v1/pinterest/pins" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/pin/123456789/"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Pinterest Pins API の主なユースケース

  • 選定したピンのアーカイブ: 指定したURLリストについて、ピンID、元URL、タイトル、本文、投稿者フィールド、メディアの参照、公開日時を保存します。
  • クリエイティブとトピックの分析: メディアの種類、post_type、categories、hashtags、タイトル、本文を使い、選定したピン間で形式やテーマを比較します。
  • 取得時点ごとの指標比較: 表示中のいいね数・コメント数を投稿者のフォロワー数とあわせて比較し、collected_at で各観測の時点を特定します。

Pinterest Pins API 活用のヒント

  • すべての項目に公開 /pin/{id} URLまたはpin.itリンクを使用してください。プロフィール、検索、アイデアなどのPinterestパスは、このエンドポイントの入力条件を満たしません。
  • 直接リンクと短縮リンクが同じピンを指す可能性がある場合は、返された id の値で重複を排除してください。
  • 公開ピンではすべての値が公開されているとは限らないため、media、created_at、categories、hashtags、post_type、個々の指標は任意フィールドとして扱ってください。
  • 表示中の指標とあわせて collected_at を保存し、後続の実行結果を取得時点ごとの個別スナップショットとして解釈できるようにしてください。

Pinterest Pins API 以外に別の種類の公開Pinterestデータが必要な場合は、これらのAPIをご利用ください。

  • Pinterest User Pins API — プロフィールURLから公開ピンを探します。プロフィールごとの取得上限を指定でき、正規化されたコンテンツ、クリエイター、メディア、タイムスタンプ、表示中の指標を返します。
  • Pinterest Profiles API — プロフィールURLから、公開プロフィールのアカウント情報、プロフィール文、画像、Webサイト、表示中のアカウントのカウント、取得情報を取得します。
  • Pinterest Search API — テキストクエリで公開ピンを検索します。取得件数の上限を指定でき、正規化されたコンテンツ、クリエイター、メディア、分類、タイムスタンプ、表示中の指標を返します。
  • Pinterest User Boards API — プロフィールURLからPinterestのボードを一覧にし、名前、説明、カバー画像、作成日と、ピン・フォロワー・セクション・コラボレーターの数を返します。
  • Pinterest Board Pins API — ボードのURLから、Pinterestボードのピンを並び順どおりに、ピンのテキスト、保存したアカウント、フルサイズ画像、ピンのリンクとともに取得します。
  • Pinterest Topic API — アイデアページのURLから、各トピックの月間検索数、更新日時、配下に提案される細かいトピックを読み取ります。

他のプラットフォームを見る

Pinterestのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Pinterest Pins API — よくある質問

Pinterest Pins APIは、送信したPinterestピンの直接URLまたは対応する短縮リンクから公開ピンのレコードを取得します。正規化されたコンテンツ、投稿者情報、メディア、タイムスタンプ、カテゴリ、ハッシュタグ、表示中の指標を返します。

パスが /pin/{id} で始まるPinterestドメインのHTTPまたはHTTPS URLを送信するか、pin.it短縮リンクを使用してください。プロフィール、検索、アイデアなどのパスは受け付けません。

取得されません。このエンドポイントは urls に含まれる対応済みの公開ピンリンクのみを照会し、投稿者のプロフィールをフィードとして展開することはありません。

正規化された media 配列には、公開されている画像または動画の参照が含まれます。元のレコードで利用可能なメディアURLが公開されていない場合は空になります。

公開ピンでは、メディア、公開日時、カテゴリ、ハッシュタグ、投稿タイプ、表示中の指標のすべてが公開されているとは限らないため、任意の値が null または空になることがあります。

完了した結果に含まれるピンレコード1件につき0.5 SocQクレジットです。結果が空の場合、結果に対する課金は発生しません。