pinterest/
topic

アイデアページのURLからPinterestのトピックを調べ、各トピックの名前、Pinterestが示す月間検索数、更新日時、提案されるより細かいトピックを返します。

Pinterest Topic API

アイデアページURLを入力
月間検索数
リンク付きの関連トピック
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Pinterest Topic

Pinterestのトピックは、ホームデコのようなテーマを軸にピンをまとめたアイデアページで、Pinterestが示す月間検索数、その数値の更新日、クリスマスや古着風といったより細かいトピックが添えられています。数値はそのテーマがPinterestでどれだけ求められているかを示し、細かいトピックは人々が組み合わせるスタイル、行事、素材を指し示すため、キーワード調査やコンテンツ企画の土台になります。

Pinterest Topic API の主な機能

  • トピックごとの月間検索数search_count はPinterestがそのトピックについて示す月間検索数で、どれだけ頻繁に探されているかを直接測れます。
  • 固有リンク付きの細分化トピックrelated_topics にはPinterestが提案するサブトピックが並び、それぞれにフルネーム、DIY のような短いラベル、アイデアページの url が付きます。
  • 数値の更新日時updated_at にはPinterestがトピックを最後に更新した日時が入るため、検索数がどれだけ新しいかがわかります。
  • 1回のリクエストで多数のトピックurls には複数のアイデアページを一度に指定でき、それぞれがページアドレス内のトピック id をキーにちょうど1行を返します。

Pinterest Topic API のパラメータ

パラメータ必須説明
urls必須数値IDを含む /ideas/{topic}/{id}/ 形式のPinterestアイデアページのリンクです(例:https://www.pinterest.com/ideas/home-decor/935249274030/)。

Pinterest Topic API の使い方

アイデアページのリンクを送信し、トピックごとに1行を受け取ります。

  1. Pinterestからアイデアページのリンクをコピーし、urls に入れて /v1/pinterest/topic に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items の各要素から1つずつトピックを読み取り、has_more が true の場合は results.next_cursor で残りを取得します。
curl -X POST "https://api.socq.ai/v1/pinterest/topic" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/ideas/home-decor/935249274030/"]}'

# One row and 0.5 credits per topic.

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

  • 需要の大きさによるコンテンツ案の優先順位付け: 候補トピックのリストについて search_count を集め、ピンやボードを企画する前に、よく検索されているものから取り組みます。
  • 広いテーマの中のロングテールの切り口探し: ホームデコ(home decor)配下の Christmas、Thrifted、Earthy Cottage といった related_topics のラベルを読み、狙うオーディエンスがはっきりした細かい切り口を選びます。
  • 自社用のPinterest需要履歴の蓄積: 同じトピックを毎月取得して search_count を updated_at とともに保存し、テーマごとの関心の推移をグラフにします。

Pinterest Topic API 活用のヒント

  • すべてのリンクに数値IDを残してください。/ideas/home-decor/935249274030/ は受け付けられますが、トピック名で終わるアドレスは検証で失敗します。
  • related_topics[].url を次のバッチとして送るとニッチを1階層ずつ掘り下げられます。分岐は同じアイデアページに戻ることが多いため、取得済みのトピック id は除いてください。
  • 各数値はそのトピック自身の最終更新時点のものなので、トピック間で search_count を比べるときは必ず updated_at もあわせて確認してください。

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

  • Pinterest Pins API — 公開ピンのURLから、正規化されたコンテンツ、クリエイター、メディア、分類、タイムスタンプ、表示中の指標を取得します。
  • 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のデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Pinterest Topic API — よくある質問

Pinterest Topic APIは、アイデアページの URL から、Pinterestのトピックを読み取るためのプログラムインターフェースです。各トピックの名前、Pinterestが示す月間検索数、その数値の最終更新日時、配下に提案されるより細かいトピックを返します。

各トピックについてPinterestが示す現在の月間検索数を、その更新日時とともに取得できます。同じトピックを定期的に取得すれば、自分でグラフにできる履歴が蓄積されます。

アイデアページは pinterest.com/ideas/ の配下にあり、/ideas/home-decor/935249274030/ のように数値IDで終わります。各行で返る related_topics[].url も、そのまま受け付けられる形式です。

name は Christmas Home Decor のようなトピックの正式名、label は Christmas のようにPinterestがそのトピックに表示する短いタグです。

返されたトピック1件につき0.5クレジットで、アイデアページを10件調べると5クレジットです。