pinterest/
user-boards

プロフィールのURLからPinterestのボードを一覧にし、ボード名、説明、カバー画像、所有者、作成日と、ピン数、フォロワー数、セクション数、コラボレーター数を返します。

Pinterest User Boards API

プロフィールURLを入力
1プロフィール最大500ボード
ピン数とフォロワー数
共同ボードのフラグ
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Pinterest User Boards

Pinterestのボードは保存したピンを名前付きでまとめたコレクションで、説明、カバー画像、作成日のほか、ピン数、フォロワー数、セクション数、コラボレーター数と、ほかのアカウントも追加できるかどうかを示すフラグを持っています。プロフィール全体のボードを並べると、そのアカウントがどのテーマを重点的に集めているか、どのコレクションが独自にフォロワーを集めているか、どこで共同投稿を受け入れているかが見えてきます。

Pinterest User Boards API の主な機能

  • プロフィール上のすべてのボードurls にPinterestのプロフィールリンクを1つ以上送ると、そのプロフィールにある各ボードがボードの id と url を持つ1行として返ります。
  • ボードごとの規模とオーディエンスmetrics.pins_count はボードに保存された量、metrics.followers_count はフォローしている人数を示し、ピンが多いだけの保管庫と実際に見られているコレクションを見分けられます。
  • 共同ボードとセクションis_collaborative はほかのアカウントもピンを追加できるボードを示し、metrics.collaborators_count はその人数、metrics.sections_count はボードがどれだけ細かく分けられているかを表します。
  • 名前、説明、カバー画像、作成日name、text、cover_url でボードの内容がひと目でわかり、published_at にはボードの作成日、つまりそのテーマがアカウントに加わった時期が記録されます。
  • 1プロフィールあたり最大500ボードresults_limit はプロフィールごとに適用され、デフォルトは25、最大500まで指定できるため、数百のボードを持つアカウントもすべて一覧にできます。

Pinterest User Boards API のパラメータ

パラメータ必須説明
urls必須パスにユーザー名が1つだけ入ったPinterestのプロフィールリンクです(例:https://www.pinterest.com/marthastewart/)。pinterest.co.uk や de.pinterest.com などの国別ドメインも使えます。
results_limit任意プロフィールごとに返すボードの最大数で、1〜500の整数です。デフォルトは25です。

Pinterest User Boards API の使い方

プロフィールのリンクを送信し、タスクの完了を待ってから、ボードごとの行をページ単位で読み取ります。

  1. プロフィールのリンクと任意の results_limit を POST /v1/pinterest/user-boards に送り、レスポンスの task_id を控えます。
  2. status が succeeded になるまで、数秒ごとに GET /v1/tasks/{task_id} を呼び出します。
  3. results.items からボードを読み取り、has_more が true の間は results.next_cursor で次のページをリクエストします。
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}'

# Each board returned costs 0.5 credits.

Pinterest User Boards API の主なユースケース

  • 競合のPinterestテーマの分析: ボードの name と text を pins_count と並べてブランドが保存し続けているテーマを把握し、followers_count と比べてどのコレクションがフォローされているかを確かめます。
  • ジャンル別のクリエイター候補の絞り込み: 候補クリエイターのボードを集めてボード名と説明を自社のテーマと照らし合わせ、複数のボードでそのテーマを扱っているアカウントを残します。
  • 参加する価値のある共同ボード探し: is_collaborative が true の行を残し、collaborators_count と followers_count を比べて、フォロワーのいる共同ボードを選びます。
  • 伸びているコレクションの追跡: 同じプロフィールを定期的に取得し直し、ボードの id ごとに pins_count と followers_count を比べて、ピンやフォロワーが増えているボードを把握します。

Pinterest User Boards API 活用のヒント

  • urls は https://www.pinterest.com/{username}/ 形式を受け付けるため、ボードやピンのリンクは送信前にプロフィールのルートまで切り詰めてください。ボードのリンクは Pinterest Board Pins API で使います。
  • プロフィールのボードがデフォルトの25件より多い場合は results_limit を引き上げてください。上限はプロフィールごとに数えられ、課金されるのは実際に返されたボードだけです。
  • 1つのタスクで複数のプロフィールを扱う場合は author.username で行をグループ化してください。どのボードにも所有するアカウントの情報が付いています。
  • 各ボードの url を Pinterest Board Pins API に渡せばピンを取得できます。そのエンドポイントの results_limit は metrics.pins_count を目安に設定してください。

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

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

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

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

Pinterest User Boards API — よくある質問

Pinterest User Boards APIは、公開Pinterestプロフィールのボードをプロフィールの URL から一覧にするためのプログラムインターフェースです。各ボードの名前、説明、カバー画像、所有者、作成日、共同ボードのフラグと、ピン数、フォロワー数、セクション数、コラボレーター数を返します。

アカウントのプロフィールリンクを urls に入れ、results_limit をそのボード数以上(最大500)に設定します。各ボードが名前、url、各種カウントとともに個別の行で返ります。

各行はボードそのものを表し、保存されているピンの数は metrics.pins_count に入ります。ピンを読み取るには、ボードの url を Pinterest Board Pins API に送ってください。

共同ボード(グループボード)は、所有者以外のアカウントもピンを追加できるボードです。こうしたボードでは is_collaborative が true になり、metrics.collaborators_count にコラボレーターの人数が入ります。

ボード1件につき0.5クレジットで、3つのプロフィールをデフォルトの上限25件で取得すると最大37.5クレジットです。ボード数が上限に満たないプロフィールは、返されたボードの分だけ課金されます。