Pinterestユーザーの投稿API

Q: アカウントのピンのうち、最も多く保存されたものを見つけるには？

各ピンが再保存された回数を示すrepin_countで行を並べ替えてください。これはPinterestで拡散度を測る主な指標です。あわせてreaction_countとcomment_countを見ると、どのピンが反応も集めているかがわかります。古いピンほど保存を集める期間が長いため、posted_atも考慮してください。

Q: Posts by userとPins on a boardの違いは？

Pinterest Posts by userはアカウントを起点に、そのアカウントが公開したピンを返します。board_nameで各ピンがどのボードにあるかがわかります。Pinterest Pins on a boardは、username/board-nameのパスで指定した1つのボードを起点に、そのボードの内容を返します。アカウントのプロファイリングには前者を、1つのキュレーションされたコレクションの分析には後者を使用してください。

POST

APIの稼働状況

24時間の稼働状況: 正常
24時間の平均応答時間: —

良好／正常
利用可能
制限あり
ほぼ停止

正常

過去24時間

過去30日間

Pinterestアカウントが公開したピンを取得します。画像、動画、外部リンクは区別され、それぞれにリピン数、リアクション数、コメント数、所属ボードが含まれます。すべてのボードや古いピンを網羅できるとは限りません。

Pinterest Posts by userは、usernameで指定した1つのアカウントが公開したピンを一覧表示し、各ピンのタイトルと説明、画像または動画、外部リンクとソースドメイン、ピンが保存されているボード（board_name）、リピン数・リアクション数・コメント数、ドミナントカラー、公開日時を返します。アカウントがPinterestで何を公開し、どのピンが広まったかがわかるため、競合アカウントをベンチマークするソーシャルチーム、自社のどのピンが保存されているかを確認するブランド、クリエイターがコンテンツをどうボードに整理しているかを研究するアナリストに役立ちます。

usernameはアカウントのショートネームで、先頭の@はあってもなくてもかまいません。プロフィールの完全なURLは解析されないため、先にリンクから名前を取り出してください。board_nameで行をグループ化するとアカウントがコンテンツをどう分けているかがわかり、repin_countをposted_atと照らし合わせると、最近ヒットしたピンと時間をかけて保存数を積み上げた古いピンを区別できます。コメント数やシェア数がnullの場合は公開されていないことを意味し、0ではありません。

料金は1,000リクエストあたり$1.39（1回あたり$0.001389）です。失敗した呼び出しと空の結果には課金されません。同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。

AIプロンプト

EveryInfraのPinterest ユーザーの投稿エンドポイント（pinterest/user_posts）を使ったデータ収集スクリプトの作成を手伝ってください。

エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにpinterest、actionにuser_postsを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
  - username: profile、user_posts、boardsアクションで使用するPinterestのユーザーハンドルを指定します。先頭の@は付けても付けなくてもかまいません。プロフィールのWeb URL全体は指定できません。
- 任意パラメータ：
  - limit: この呼び出しで返す最大行数で、1〜50の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。（デフォルト：20）
- レコードのリストを返します。各レコードの主なフィールド: id、url、title、text、image_url、video_url、media_type、external_link、source_domain、reaction_count、repin_count、comment_count。フィールドは全部で20個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=pinterestを参照してください。.
- リクエストボディの例：
{
  "platform": "pinterest",
  "action": "user_posts",
  "params": {
    "username": "pinterest"
  }
}
- 料金：1,000リクエストあたり$1.39。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。

コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。

リクエストパラメータ

名前	場所	型	必須	デフォルト	説明
`Authorization`	header	`string`	はい	-	Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
`platform`	body	`string`	はい	`pinterest`	プラットフォームの識別子です。値は固定です。
`action`	body	`string`	はい	`user_posts`	機能の識別子です。値は固定です。
`username`	body.params	`string`	はい	-	profile、user_posts、boardsアクションで使用するPinterestのユーザーハンドルを指定します。先頭の@は付けても付けなくてもかまいません。プロフィールのWeb URL全体は指定できません。
`limit`	body.params	`integer (1–50)`	いいえ	`20`	この呼び出しで返す最大行数で、1〜50の整数で指定します。省略するとデフォルト値が適用されます。また、返される行数がこれより少なくなる場合があります。最大値を超える値を指定すると、課金前に422が返されます。

コードサンプル

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "pinterest",
  "action": "user_posts",
  "params": {
    "username": "pinterest"
  }
}'

OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。

レスポンス例

実際のレスポンス

September 26, 2026 at 08:56（UTC）に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報（名前、ハンドル、アバター、プロフィールリンク、連絡先）を削除したものです。リストは先頭の2件のみ掲載しています。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。

json

{
  "id": "req_…",
  "platform": "pinterest",
  "action": "user_posts",
  "results": [
    {
      "id": "•••",
      "url": "https://www.pinterest.com/pin/424605071145987859/",
      "title": "Eco Car Plate with Non-Slip Tires | Childrens Dishes, Kids Lunch Boxes, Kids Cooking Gifts",
      "text": "Mealtime with kids can be a bumpy road, but with this car-shaped plate, it's smooth cruising to the finish line. The recyclable and dishwashable racer's removable compartments and nonslip tires keep diners on track with no messy detours (i.e., the floor). Car crafted from a biode…",
      "image_url": "https://i.pinimg.com/originals/12/c1/a6/12c1a6752b29579d0d7aa3e82c8af64b.jpg",
      "media_type": "image",
      "external_link": "https://www.uncommongoods.com/product/eco-car-plate-with-non-slip-tires?utm_source=pinterest&utm_medium=paid&social&ad_id=%7Badid%7D&pin_id=%7Bpin_id%7D",
      "source_domain": "uncommongoods.com",
      "reaction_count": 56,
      "repin_count": 868,
      "dominant_color": "#f3eee3",
      "alt_text": "two plastic cars with food in them on a white surface next to cups and strawberries",
      "posted_at": "2026-09-26T09:43:33+00:00",
      "author_username": "pinterest",
      "author_name": "Pinterest",
      "board_name": "Gifts that embrace the art of play",
      "platform": "pinterest"
    },
    {
      "id": "•••",
      "url": "https://www.pinterest.com/pin/424605071145987856/",
      "title": "Healthy Harvest Natural Dining Sets | Cool & Unique Baby Gifts",
      "text": "Parents worry about everything they feed to their growing bundles of joy, but what about the plastic plates and utensils they eat off of? Here's a charming answer all-natural wooden dinnerware that’s completely free of any plastics, BPAs, or petroleum-based components. Giving a s…",
      "image_url": "https://i.pinimg.com/originals/cc/26/7d/cc267d3a3fca4beb87080cfc07c5e229.jpg",
      "media_type": "image",
      "external_link": "https://www.uncommongoods.com/product/healthy-harvest-natural-dining-sets?utm_source=pinterest&utm_medium=paid%20social&ad_id=%7Badid%7D&pin_id=%7Bpin_id%7D",
      "source_domain": "uncommongoods.com",
      "reaction_count": 155,
      "repin_count": 1904,
      "dominant_color": "#f3eadc",
      "alt_text": "three plastic fruits and vegetables are shown on a white surface with spoons, plates, and utensils",
      "posted_at": "2026-09-26T09:40:55+00:00",
      "author_username": "pinterest",
      "author_name": "Pinterest",
      "board_name": "Gifts that embrace the art of play",
      "platform": "pinterest"
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

レスポンスフィールド

業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。

フィールド	意味
`id`	プラットフォーム上でのレコードの一意なIDです。一意性は1つのプラットフォーム内に限られ、プラットフォームが異なるとIDが重複する場合があります。
`url`	プラットフォーム上のレコードへのリンクです。
`title`	タイトルです。プラットフォームにタイトルがない場合（テキストのみの投稿など）はnullになります。
`text`	HTMLを除去した本文です。省略されることなく全文が返されます（一部のプラットフォームでは一覧結果自体に抜粋しか含まれません。その場合は各プラットフォームのフィールドの注記に記載しています）。
`image_url`	画像のリンクです。複数の画像を返す機能では、image_urls配列が返される場合があります。
`video_url`	プラットフォーム上の意味のまま
`media_type`	プラットフォーム上の意味のまま
`external_link`	プラットフォーム上の意味のまま
`source_domain`	プラットフォーム上の意味のまま
`reaction_count`	プラットフォーム上の意味のまま
`repin_count`	プラットフォーム上の意味のまま
`comment_count`	コメント数です。nullは非公開を示し、0ではありません。
`share_count`	シェア数です。nullは非公開を示し、0ではありません。
`dominant_color`	プラットフォーム上の意味のまま
`alt_text`	プラットフォーム上の意味のまま
`posted_at`	投稿日時です。ISO 8601形式のUTCで返されます（例：2026-08-07T12:34:56+00:00）。プラットフォームから非標準の文字列が返された場合はそのまま渡されるため、パース処理は堅牢に実装してください。nullはプラットフォームが公開していないことを示します。
`author_username`	投稿者のユーザー名（@ハンドル）で、通常はURLに使用できます。
`author_name`	投稿者の表示名です。
`board_name`	プラットフォーム上の意味のまま
`price`	通貨記号を含まない数値で表した価格です。通貨についてはcurrencyを参照してください。
`platform`	取得元プラットフォームの識別子で、リクエストのplatformと同じです（例：xiaohongshu、tiktok）。

FAQ

`username`はどの形式で指定しますか？

アカウントのショートネームです。たとえば、pinterest.com/pinterest/というプロフィールアドレスではpinterestです。先頭に@を付けてもかまいませんが、Pinterest Posts by userはプロフィールの完全なURLを解析しないため、名前だけを指定してください。同じショートネームはPinterest DetailsおよびPinterest Boards機能でも使えます。

アカウントのピンのうち、最も多く保存されたものを見つけるには？

各ピンが再保存された回数を示すrepin_countで行を並べ替えてください。これはPinterestで拡散度を測る主な指標です。あわせてreaction_countとcomment_countを見ると、どのピンが反応も集めているかがわかります。古いピンほど保存を集める期間が長いため、posted_atも考慮してください。

Posts by userとPins on a boardの違いは？

Pinterest Posts by userはアカウントを起点に、そのアカウントが公開したピンを返します。board_nameで各ピンがどのボードにあるかがわかります。Pinterest Pins on a boardは、username/board-nameのパスで指定した1つのボードを起点に、そのボードの内容を返します。アカウントのプロファイリングには前者を、1つのキュレーションされたコレクションの分析には後者を使用してください。

エラーと課金

401: キーが未指定か無効です。
402: 残高が不足しています。先にチャージしてください。
422: パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
429: 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
503: 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
200（空）: データがありません。課金はされません。

エラー

公式リファレンス

対象と用語の確認にのみ使用しています。プラットフォームによるEveryInfraの承認や推奨を意味するものではありません。

Pinterest：保存されたピンは、そのアカウントが作成したオリジナルコンテンツとは限らない ↗
公式ドキュメントによると、画像ピンは、画像をアップロードするか、外部サイトの画像を保存することで作成でき、外部サイトから保存したピンには元のサイトへのリンクが保持されます。アカウントに関連付けられたピンを、そのアカウントが作成したオリジナルコンテンツとみなすことはできず、出典の確認はコンテンツの利用許可に代わるものではありません。
確認日：2026-09-04