API一覧に戻る
Pinterestの公開データ

Pinterest公開データAPI

公開Pinterestプロフィールのデータ取得、既知のピンの解決、指定したプロフィールのピンの取得、キーワード検索ができ、クリエイター、コンテンツ、ビジュアルトレンドの調査に活用できます。

利用できるPinterest API

アカウントのデータにはProfiles、既知のピンにはPins、指定したプロフィールのコンテンツにはUser Pins、キーワードによるピンの検索にはSearchを使用します。

取得できるPinterestデータ

SocQは、アカウント情報、コンテンツ、メディア、分類、検索、エンゲージメント、取得時点のコンテキストを含む、正規化された公開アカウントとピンのレコードを返します。

公開プロフィールの詳細

プロフィールID、ユーザー名、表示名、プロフィール文、画像、リンクされたWebサイト、国のコンテキスト、表示中のアカウント数値を取得します。

ピンのコンテンツとメディア

取得可能な場合、ピンのID、タイトル、テキスト、クリエイターの詳細、メディア参照、公開日時、表示中の指標を取得します。

クリエイターのピンコレクション

指定したプロフィールURLから上限付きで公開ピンを閲覧し、各結果を送信したプロフィールと紐づけて保持します。

トピックと分類

キーワードでピンを検索し、取得可能な投稿の種類、カテゴリ、ハッシュタグ、取得元の詳細、検索時の入力を保持します。

SocQ vs Pinterest API

SocQは、対応する公開Pinterestデータの取得に特化しています。Pinterestの公式APIは、認証済みのコンテンツ、広告、分析、カタログの連携を目的に設計されています。

機能SocQPinterest API
主な用途公開プロフィール、ピン、ユーザーのピン、検索結果の取得認可済みのコンテンツ、広告、分析、カタログの管理
顧客側のOAuthSocQのAPIキーのみ。顧客のPinterest OAuthは不要Pinterestアプリ、アクセストークン、必要なスコープ
入力の起点公開プロフィールやピンのURL、またはテキストクエリ認可済みアカウントのコンテキストとPinterestのリソースID
ピンの作成・管理非対応書き込みスコープを持つ認証済みユーザーの代理として対応
レスポンス形式正規化されたSocQレコードPinterest API独自のオブジェクト

Pinterest APIの仕組み

4つのPinterest APIはすべて、共通の非同期タスクとページネーション付きの結果取得ワークフローを使用します。

  1. 1. 入力を送信

    プロフィールURL、ピンのURL、または検索クエリを対応するAPIに送信し、返された task_id を保存します。

  2. 2. タスクを追跡

    処理が完了するまで /v1/tasks/{task_id} をポーリングします。

  3. 3. 結果を取得

    data.results.items を読み取り、has_more が true の間は next_cursor を使用します。

キーワードで公開ピンを検索

SocQのAPIキーで認証し、テキストクエリを送信します。Profiles、Pins、User Pinsも同じタスクフローで利用できます。

curl -X POST "https://api.socq.ai/v1/pinterest/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"home office ideas","results_limit":100}'

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

Pinterest APIの主なユースケース

クリエイターとプロフィールの調査

既知のプロフィールURLに、公開されているアカウント情報、プロフィール文、Webサイト、国のコンテキスト、表示中の数値、取得日時を追加します。

既知のピンの分析

選んだピンのURLから、コンテンツ、クリエイター、メディア、分類、タイムスタンプ、表示中の指標、取得元リンクを取得します。

クリエイターのコンテンツモニタリング

指定したプロフィールから上限付きでピンを取得し、取得時点のコンテンツとアカウントのスナップショットを比較します。

ビジュアルトピックとトレンドの調査

特定のキーワードで検索し、クリエイター、メディア、分類、検索のコンテキストを含む構造化されたピンのデータセットを構築します。

制限事項と公開データポリシー

Pinterestの結果は、特定時点の公開レコードです。これらのAPIは非公開コンテンツにはアクセスせず、プロフィールやピンの作成、編集、保存、管理も行いません。

  • Profilesには、ユーザー名のパスセグメントを1つ含むプロフィールURLが必要です。返されるのはアカウントの詳細で、ボード、ピン、オーディエンスのメンバーリストは含まれません。
  • Pinsには既知の公開 /pin/{id} のURLまたはpin.itのリンクが必要で、プロフィールからピンのコレクションへの展開は行いません。
  • User Pinsには公開プロフィールのURLが必要です。results_limit のデフォルトは100で、1〜2,000を指定でき、プロフィールごとに個別に適用されます。
  • Searchには1つのテキストクエリが必要です。results_limit のデフォルトは100で、1〜2,000を指定できます。並び順や追加のフィルターはありません。
  • 公開ソースが提供しない場合、任意のアカウント情報、コンテンツ、メディア、分類、取得元、タイムスタンプ、指標のフィールドは、null または空になることがあります。
  • これらのAPIは読み取り専用であり、Pinterestのプロフィール、ボード、ピンの作成、編集、保存、管理は行いません。

Pinterest APIに関するよくある質問

Pinterest APIとは何ですか?

Pinterest APIは、公開プロフィールデータの取得、既知のピンの解決、指定したプロフィールのピンの取得、キーワードによる公開ピンの検索ができるSocQのエンドポイント群です。

どのPinterest APIを使えばよいですか?

アカウントの詳細にはProfiles、既知の /pin/{id} またはpin.itのリンクにはPins、プロフィールURLから上限付きで取得するにはUser Pins、キーワードによる検索にはSearchを使用してください。

ProfilesとUser Pinsは同じデータを返しますか?

いいえ。Profilesはアカウントのメタデータと集計数値を返し、User Pinsは送信したプロフィールURLから見つかった正規化済みのピンのレコードを返します。

User Pinsの取得件数上限はどのように機能しますか?

results_limit のデフォルトは100で、1〜2,000の整数を指定でき、各プロフィールURLに個別に適用されます。

フィールドが null や空になるのはなぜですか?

公開プロフィールやピンが、取得時点ですべてのアカウント情報、コンテンツ、メディア、分類、取得元、タイムスタンプ、指標の値を公開しているとは限らないためです。

Pinterestデータ取得の料金はどのように計算されますか?

返されたプロフィールまたはSearchのピンは1件あたり0.6クレジット、PinsまたはUser Pinsから返されたピンは1件あたり0.5クレジットです。結果が空の場合、結果に対する料金は発生しません。

さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。

Threads API

公開Threadsプロフィールの取得、既知の投稿の解決、指定したプロフィールの投稿の取得ができます。アカウント情報、コンテンツ、メディア、エンゲージメント、タイムスタンプのフィールドは正規化されています。

Bluesky API

公開Blueskyプロフィールの取得、既知の投稿URLの解決、アカウントの投稿の1ページ分の取得ができます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントのフィールドは正規化されています。

Snapchat API

既知の公開Snapchat Spotlightを、取得可能なクリエイター、キャプション、メディア、音源、タイムスタンプ、再生時間、エンゲージメントのフィールドを含む正規化レコードとして取得できます。

Twitch API

既知の公開Twitchユーザー名から正規化されたプロフィールや公開動画の一覧を取得したり、クリップ1件をダウンロード可能な動画とともに取得したりでき、クリエイター調査、カタログの情報補完、比較、スナップショットのモニタリングに活用できます。

Rednote API

公開プロフィールとノートの取得、ノートやユーザーの検索、コメントとネストされた返信の取得、ホームのおすすめ1ページ分の取得ができます。

Kwai API

公開Kwaiプロフィール、アカウントの投稿1ページ分、既知の投稿1件を取得できます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントは正規化されています。