pinterest/
profiles

1つ以上のプロフィールURLから公開Pinterestプロフィールを取得し、アカウント情報、プロフィール文とWebサイト、プロフィール画像、表示中のアカウント数値を正規化レコードとして返します。

Pinterest Profiles API

プロフィールURLで指定
アカウント情報とWebサイト
表示中のアカウント指標
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Pinterest Profiles

Pinterestプロフィールは、ユーザー名、表示名、プロフィール文、プロフィール画像、リンク先のWebサイト、表示中のフォロワー数・フォロー数・ボード数・保存数を含む公開アカウントページです。これらの識別情報とアカウント指標は、プロフィール情報の補完、公開アカウントの比較、時系列でのモニタリングに活用できます。

Pinterest Profiles API の主な機能

  • 公開プロフィールURLに限定1つ以上の対応するPinterestプロフィールURLを処理し、ピンのリンク、短縮リンク、検索ページ、その他プロフィール以外のパスは除外します。
  • プロフィールの識別情報と表示内容プロフィールID、正規URL、ユーザー名、表示名、プロフィール文、プロフィール画像、リンク先のWebサイトを1件の正規化レコードで返します。
  • 表示中のアカウント数値取得可能なフォロワー数・フォロー数・ボード数・保存数を個別の指標として保持し、アカウント単位で比較できるようにします。
  • 取得時刻とソースの情報collected_at に加え、取得可能な国コード、作成したピンのページURL、ソースの更新値、検出時の入力を、識別情報と混ぜずに付与します。

Pinterest Profiles API のパラメータ

パラメータ必須説明
urls必須必須。公開PinterestプロフィールURLのリストです。各URLはPinterestドメイン上のHTTPまたはHTTPSで、予約語ではないユーザー名のパスセグメントを1つ含む必要があります。

Pinterest Profiles API の使い方

既知の公開プロフィールURLを送信し、非同期タスクを追跡して、正規化されたプロフィールレコードをカーソルページネーションで読み取ります。

  1. パスにユーザー名のセグメントが1つだけ含まれる公開PinterestプロフィールURLを1つ以上用意します。
  2. リンクを urls として /v1/pinterest/profiles に送信し、task_id を保存します。
  3. 処理が成功するか失敗が返るまで /v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取り、has_more が true の間は next_cursor で次のページを取得します。
curl -X POST "https://api.socq.ai/v1/pinterest/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.pinterest.com/example/"]}'

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

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

  • 公開プロフィールの情報補完: 既知のプロフィールURLに紐付くレコードに、ユーザー名、表示名、プロフィール文、プロフィール画像、Webサイト、国の情報を追加します。
  • アカウント規模の比較: 選定した公開プロフィール間で、表示中のフォロワー数・フォロー数・ボード数・保存数を比較します。
  • 公開プロフィールのモニタリング: 識別情報と表示中の指標を collected_at とともに保存し、取得時点ごとにプロフィールの表示内容やアカウント指標を比較します。

Pinterest Profiles API 活用のヒント

  • ユーザー名のパスセグメントを1つ含む、HTTPまたはHTTPSの完全なPinterestプロフィールURLを使用してください。pin.it、/pin/、/search/ などの予約パスは受け付けません。
  • 送信するURLを正規化し、返されたプロフィールは可能であれば id で、なければ url を固定キーとして重複を排除してください。
  • プロフィール文、画像、Webサイト、国コード、ソースの更新値、作成したピンのページURL、個々の指標は任意フィールドとして扱ってください。
  • 表示中のアカウント数値とあわせて collected_at を保持し、後続の実行結果を個別の公開スナップショットとして区別できるようにしてください。
  • プロフィールからピンのレコードを取得したい場合は Pinterest User Pins API を使用してください。このエンドポイントが返すのはプロフィールのメタデータと数値で、ボード、ピン、オーディエンスのリストは返しません。

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

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

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

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

Pinterest Profiles API — よくある質問

Pinterest Profiles APIは、1つ以上の対応するPinterestプロフィールURLから公開プロフィールのメタデータを取得します。正規化されたアカウント情報、プロフィール文、プロフィール画像、Webサイト、表示中のアカウント数値、取得時の情報を返します。

パスに予約語ではないユーザー名のセグメントを1つ含む、Pinterestドメイン上のHTTPまたはHTTPSの完全なURLを送信してください。ピンのURL、pin.itリンク、検索ページ、/ideas/ や /today/ などの予約パスは受け付けません。

結果には、プロフィールID、URL、ユーザー名、表示名、プロフィール文、アバター、Webサイト、フォロワー数とフォロー数、ボード数と保存数、取得時刻、国コード、作成したピンのページURLが含まれる場合があります。

できません。返すのはプロフィールのメタデータと表示中の集計数値で、ボードのレコード、ピンのレコード、フォロワー・フォロー中の一覧に含まれるアカウントは返しません。プロフィールURLからピンを取得したい場合は Pinterest User Pins API を使用してください。

公開プロフィールでは、プロフィール文、Webサイト、画像、国コード、作成したピンのページURL、ソースの更新値、表示中の数値のすべてが公開されているとは限りません。クライアント側では、任意の値が null または空になることを想定してください。

完了した結果に含まれるプロフィールレコード1件につき0.6 SocQクレジットです。結果が空の場合、結果に対する課金は発生しません。