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行を受け取ります。
- Pinterestからアイデアページのリンクをコピーし、urls に入れて /v1/pinterest/topic に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 もあわせて確認してください。
関連API
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ボードのピンを並び順どおりに、ピンのテキスト、保存したアカウント、フルサイズ画像、ピンのリンクとともに取得します。