SocQの最初のPinterestエンドポイントは、プロフィール、個別のピン、ユーザーのピン、検索結果を読み取るものでした。2026-11-17にはさらに3つが公開され、これらは別の単位、つまりボードとトピックを扱います。ボードからは、ブランドやクリエイターがアイデアをどう整理しているかが分かります。トピックからは、あるアイデアがどれだけ検索されていて、その下にどのような細分化されたアイデアがあるかが分かります。
このガイドでは、新しい各エンドポイントが返すデータ、リクエストの形、料金、そして3つの組み合わせ方を説明します。Pinterestのデータプロバイダー全般を比較している場合は、Pinterest スクレイパーAPIのおすすめ7選をご覧ください。
結論:
Authorization: Bearer $SOCQ_API_KEYを付けて、PinterestのプロフィールURL、ボードURL、またはアイデアページのURLをurlsに入れ、POST /v1/pinterest/user-boards、/board、/topicのいずれかに送信します。statusがsucceededになるまでGET /v1/tasks/{task_id}をポーリングし、data.results.itemsを読み取ります。3つとも結果1件あたり0.5クレジット(1クレジット$0.005で換算すると$0.0025)で、基本料金はかかりません。
新しく追加された3つのPinterestエンドポイント
| エンドポイント | 返すデータ | 入力 | 料金 |
|---|---|---|---|
| User Boards | プロフィールの公開ボード。名前、説明文、カバー、所有者、作成日、ピン数・フォロワー数・セクション数・コラボレーター数を含む | プロフィールURL | ボード1件あたり0.5クレジット($0.0025) |
| Board Pins | ボード内のピンをボードの表示順で返す。説明文、保存したユーザー、フルサイズ画像、ピンのリンクを含む | ボードURL | ピン1件あたり0.5クレジット($0.0025) |
| Topic | トピックの月間検索数と、Pinterestが提示する下位トピック | アイデアページのURL | トピック1件あたり0.5クレジット($0.0025) |
Pinterest User Boards:プロフィールを分析する
Pinterest User Boards APIは、Pinterestプロフィールのすべての公開ボードを一覧で返します。各ボードには、名前、説明文、カバー画像、所有者、作成日、ピン数・フォロワー数・セクション数・コラボレーター数が付き、ほかのアカウントもピンを追加できるボードかどうかを示すis_collaborativeフラグも含まれます。競合のPinterestを分析したり、テーマごとにクリエイターの候補を絞り込んだりするときに、最初に呼び出すエンドポイントです。各カウントから、そのアカウントがどのテーマに力を入れていて、どのコレクションが実際にフォローされているかが分かります。
curl -X POST "https://api.socq.ai/v1/pinterest/user-boards" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.pinterest.com/marthastewart/"],
"results_limit": 25
}'
プロフィールURLはhttps://www.pinterest.com/username/のように指定します。results_limitはプロフィールごとに適用され、デフォルトは25で、1〜500を指定できます。ボードの各カウントはmetricsの下のpins_count、followers_count、sections_count、collaborators_countに入ります。詳しくはUser Boardsのドキュメントをご覧ください。
Pinterest Board Pins:ボードの中身を集める
Pinterest Board Pins APIは、ボード内のピンをボードの表示順で返します。各ピンには、タイトルまたは説明文、それを保存したアカウント、フルサイズ画像(mediaの下にサムネイルとサイズ)、ピンのURLが含まれます。自分のニッチでよく整理されたボードを指定して参考画像を集めたり、競合がシーズン向けのボードに何を追加し続けているかを追跡したり、ムードボード用のデータセットを一度に作成したりできます。
curl -X POST "https://api.socq.ai/v1/pinterest/board" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.pinterest.com/lizmrodgers/moms-night/"],
"results_limit": 50
}'
ボードURLは/{username}/{board}/の形式で指定します。results_limitはボードごとに適用され、デフォルトは50で、1〜1,000を指定できます。詳しくはBoard Pinsのドキュメントをご覧ください。
Pinterest Topic:Pinterest向けのキーワードリサーチ
Pinterest Topic APIを使うと、コンテンツを作る前にトピックの規模を見積もれます。アイデアページごとに、Pinterestが報告する月間検索数(search_count)と、その下にPinterestが提示する下位トピック(related_topics。それぞれに名前、短いラベル、独自のアイデアページURLが付く)を取得できます。下位トピックには、メインのアイデアと組み合わせて検索されるスタイル、シーン、素材などが含まれます。
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/"]
}'
アイデアページのURLは/ideas/{topic}/{id}/の形式で指定します。トピックごとに1行を返します。下位トピックにはそれぞれ独自のURLが付いているため、それらのURLを同じエンドポイントに渡せば、ロングテールの切り口ごとに需要を比較できます。詳しくはTopicのドキュメントをご覧ください。
3つのエンドポイントの組み合わせ方
典型的な競合調査やニッチ調査では、次のように連携させます。
- 競合のプロフィールにUser Boardsを実行し、フォロワー数やピン数が多いボードを確認します。
- 重要なボードにBoard Pinsを実行し、その中の画像と説明文を集めます。
- それらのテーマのアイデアページにTopicを実行し、月間の検索需要を確認して、より細かい切り口を見つけます。
個別のピン、ユーザー自身のピン、キーワード検索の結果には、以前から提供しているPins、User Pins、Searchのエンドポイントを使います。PinterestのすべてのエンドポイントはPinterestプラットフォームのページに掲載しています。
認証と非同期タスクの流れ
すべてのリクエストには、APIキーとJSONのContent-Typeを付けます。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
送信リクエストごとに、バックグラウンドタスクが開始されます。
submit -> task_id -> queued -> running -> succeeded
\-> failed
送信時のレスポンスにはdata.task_idとdata.statusが含まれます。同じキーでタスクをポーリングします。
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
タスクがqueued、running、failedの間、レスポンスにはタスクのメタデータのみが含まれます。failedの場合はerror_messageを確認してください。succeededになると、同じレスポンスのdata.results.itemsに正規化されたレコードの最初のページが含まれます。limitのデフォルトは50で、最大500まで指定できます。has_moreがtrueの場合は、results.next_cursorをcursorとして渡すと次のページを読み取れます。一部の列だけが必要な場合は、fieldsにカンマ区切りで最大50個のフィールドまたはドットパスを指定できます。たとえばボードならname,metrics.followers_countのように指定します。
クライアント側でタイムアウトしてもタスクはキャンセルされません。重複したタスクを送信して二重に支払うのではなく、同じtask_idで照会を再開してください。ポーリングを避けたい場合は、送信ボディにcallback_urlを追加します。タスクが完了するとSocQがタスクの概要をPOSTで1回送信するので、その後タスクのエンドポイントからレコードを読み取ります。
典型的なジョブの料金
- 1つのプロフィールで25件のボードを一覧にする:25 × 0.5 = 12.5クレジット、$0.0625。
- 1つのボードから1,000件のピンを集める:500クレジット、$2.50。
- 20件のトピックを確認する:10クレジット、$0.05。
results_limitはプロフィールごと、またはボードごとに適用されるため、複数のURLを含むリクエストでは、URLごとにその上限までの行が返される可能性があります。URLの数を考慮して上限を設定してください。
よくある質問(FAQ)
User Boardsは非公開ボードやシークレットボードも返しますか?
いいえ。プロフィールの公開ボードを一覧で返します。
Topicの検索数は何を意味しますか?
search_countは、そのアイデアページについてPinterestが報告する月間検索数です。updated_atは、Pinterestがそのトピックを最後に更新した日時です。
複数のボードのピンを1回のリクエストで取得できますか?
はい。urlsに複数のボードURLを入れてください。results_limitはボードごとに個別に適用され、返されたピン1件ごとに0.5クレジットがかかります。
ボードが空の場合も料金がかかりますか?
基本料金はないため、料金がかかるのは返されたボード、ピン、トピックの分だけです。
Pinterestの料金はどこに掲載されていますか?
各ランディングページにそれぞれの料金が表示されており、料金ページにはSocQのすべてのAPIの最新のクレジット料金が掲載されています。
PINTEREST API
公開PinterestのURLでワークフローを試す
公開データの入力を送信すると、取得元をたどれるコンテキスト付きの正規化レコードを受け取れます。
PinterestのAPIを見る