プラットフォームの稼働状況
- 24時間の稼働状況
- 正常
過去30日間
利用可能な機能
Pinterestの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | キーワードでPinterestのピンを検索します。対象はすべてのピンまたは動画ピンのみで、画像、リンク先ドメイン、主要色、リアクション、ボード、投稿者の詳細を取得できます。ボードやクリエイターは返りません。また、ピンはその画像の権利を与えるものではなく、リンク先サイトを保証するものでもありません。 | 1,000リクエストあたり$1.39 | 正常 |
プロフィールprofile | ハンドル（@の有無は問いません）でPinterestアカウントを検索し、自己紹介、ウェブサイト、認証状況、非公開フラグ、フォロワー数・ピン数・ボード数・動画数を取得します。プロフィールURLは使用できません。また、掲載されたウェブサイトはドメインの所有を証明するものではなく、シークレットボードが明らかになることもありません。 | 1,000リクエストあたり$1.39 | 正常 |
ユーザーの投稿user_posts | Pinterestアカウントが公開したピンを取得します。画像、動画、外部リンクは区別され、それぞれにリピン数、リアクション数、コメント数、所属ボードが含まれます。すべてのボードや古いピンを網羅できるとは限りません。 | 1,000リクエストあたり$1.39 | 正常 |
ピン詳細pin | 数値IDを含む/pin/リンクから、Pinterestのピンを1件取得します。メディア、外部リンクとドメイン、代替テキスト、主要カラー、ボード、エンゲージメント数を取得できます。このアクションではボードのリンクは受け付けません。リンク先のサイトのクロールや利用許諾は行いません。 | 1,000リクエストあたり$1.39 | 正常 |
ボードboards | Pinterestアカウントが所有するボードを一覧表示します。説明、カバー画像、ピン数とセクション数、フォロワー数、公開設定、共同ボードフラグを取得できます。共同ボードであっても、すべてのメンバーや非公開のコンテンツは取得できません。 | 1,000リクエストあたり$1.39 | 正常 |
ボード内のピンboard_pins | 1つのPinterestボードに保存されたピンを順に取得します。ボードはboard_id（pinterest/official-newsなど）で指定します。各ピンにはメディア、外部リンク、作成者、エンゲージメントが含まれます。非公開のセクションは除外され、ボード全体の取得は保証されません。 | 1,000リクエストあたり$1.39 | 正常 |
ボード詳細board_detail | ボードのurlから、Pinterestボードの情報を確認します。所有者、説明、カバー、公開設定、共同ボードフラグ、ピン数・セクション数・フォロワー数を取得できます。ピン自体は含まれません。ピンはboard_pinsで取得します。 | 1,000リクエストあたり$1.39 | 正常 |
機能を開くと、パラメータ、レスポンスフィールド、コードサンプル、トライアルを確認できます。
Pinterestの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 キーワードでPinterestのピンを検索します。対象はすべてのピンまたは動画ピンのみで、画像、リンク先ドメイン、主要色、リアクション、ボード、投稿者の詳細を取得できます。ボードやクリエイターは返りません。また、ピンはその画像の権利を与えるものではなく、リンク先サイトを保証するものでもありません。 | keyword | content_type | Sync配信 | カタログ値：defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · text · image_url · reaction_count · source_domain · dominant_color · posted_at · author_username · author_name · author_follower_count · board_name · platform |
profileプロフィール ハンドル（@の有無は問いません）でPinterestアカウントを検索し、自己紹介、ウェブサイト、認証状況、非公開フラグ、フォロワー数・ピン数・ボード数・動画数を取得します。プロフィールURLは使用できません。また、掲載されたウェブサイトはドメインの所有を証明するものではなく、シークレットボードが明らかになることもありません。 | username | — | Sync配信 | — | 1,000リクエストあたり$1.39 | user_id · username · name · bio · avatar_url · follower_count · following_count · pin_count · board_count · video_count · website · is_verified · is_private · created_at · platform |
user_postsユーザーの投稿 Pinterestアカウントが公開したピンを取得します。画像、動画、外部リンクは区別され、それぞれにリピン数、リアクション数、コメント数、所属ボードが含まれます。すべてのボードや古いピンを網羅できるとは限りません。 | username | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
pinピン詳細 数値IDを含む/pin/リンクから、Pinterestのピンを1件取得します。メディア、外部リンクとドメイン、代替テキスト、主要カラー、ボード、エンゲージメント数を取得できます。このアクションではボードのリンクは受け付けません。リンク先のサイトのクロールや利用許諾は行いません。 | url | — | Sync配信 | — | 1,000リクエストあたり$1.39 | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
boardsボード Pinterestアカウントが所有するボードを一覧表示します。説明、カバー画像、ピン数とセクション数、フォロワー数、公開設定、共同ボードフラグを取得できます。共同ボードであっても、すべてのメンバーや非公開のコンテンツは取得できません。 | username | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · name · url · description · pin_count · section_count · follower_count · cover_image_url · is_collaborative · privacy · owner_username · owner_name · created_at · platform |
board_pinsボード内のピン 1つのPinterestボードに保存されたピンを順に取得します。ボードは | board_id | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=50。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$1.39 | id · url · title · text · image_url · video_url · media_type · external_link · source_domain · reaction_count · repin_count · comment_count · share_count · dominant_color · alt_text · posted_at · author_username · author_name · board_name · price · platform |
board_detailボード詳細 ボードの | url | — | Sync配信 | — | 1,000リクエストあたり$1.39 | id · name · url · description · pin_count · section_count · follower_count · cover_image_url · is_collaborative · privacy · owner_username · owner_name · created_at · platform |
Pinterestのsearchのパラメータはそれぞれどういう意味ですか？
キーワードでPinterestのピンを検索します。対象はすべてのピンまたは動画ピンのみで、画像、リンク先ドメイン、主要色、リアクション、ボード、投稿者の詳細を取得できます。ボードやクリエイターは返りません。また、ピンはその画像の権利を与えるものではなく、リンク先サイトを保証するものでもありません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況keyword必須- searchアクションで使用する検索語句またはインスピレーションのトピックを指定します。返される結果のエンティティ構造は、選択したcontent_typeによって異なります。
content_type任意- 検索結果をピンの種類で絞り込みます。all_pins_visual_postsはすべてのピン（画像ピンに限りません）、videos_video_pinsは動画ピンのみを対象とします。検索で返されるのはピンのみで、ボードやクリエイターは含まれません。指定可能な値:
all_pins_visual_postsvideos_video_pinsPinterest：画像ピン、動画ピン、商品ピン — Pinterestはピンを視覚的なブックマークと定義し、画像、動画、商品などの形式を区別しています。これはコンテンツオブジェクトを説明するためのものであり、検索によって公式に定義されたすべてのオブジェクトやメディアフィールドが返されることを意味するものではありません。このページで検索タイプが競合する場合も、上記の制限が適用されます。 · 確認日
Pinterestのprofileのパラメータはそれぞれどういう意味ですか？
ハンドル（@の有無は問いません）でPinterestアカウントを検索し、自己紹介、ウェブサイト、認証状況、非公開フラグ、フォロワー数・ピン数・ボード数・動画数を取得します。プロフィールURLは使用できません。また、掲載されたウェブサイトはドメインの所有を証明するものではなく、シークレットボードが明らかになることもありません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況username必須- profile、user_posts、boardsアクションで使用するPinterestのユーザーハンドルを指定します。先頭の@は付けても付けなくてもかまいません。プロフィールのWeb URL全体は指定できません。
Pinterestのuser_postsのパラメータはそれぞれどういう意味ですか？
Pinterestアカウントが公開したピンを取得します。画像、動画、外部リンクは区別され、それぞれにリピン数、リアクション数、コメント数、所属ボードが含まれます。すべてのボードや古いピンを網羅できるとは限りません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況username必須- profile、user_posts、boardsアクションで使用するPinterestのユーザーハンドルを指定します。先頭の@は付けても付けなくてもかまいません。プロフィールのWeb URL全体は指定できません。Pinterest：保存されたピンは、そのアカウントが作成したオリジナルコンテンツとは限らない — 公式ドキュメントによると、画像ピンは、画像をアップロードするか、外部サイトの画像を保存することで作成でき、外部サイトから保存したピンには元のサイトへのリンクが保持されます。アカウントに関連付けられたピンを、そのアカウントが作成したオリジナルコンテンツとみなすことはできず、出典の確認はコンテンツの利用許可に代わるものではありません。 · 確認日
Pinterestのpinのパラメータはそれぞれどういう意味ですか？
数値IDを含む/pin/リンクから、Pinterestのピンを1件取得します。メディア、外部リンクとドメイン、代替テキスト、主要カラー、ボード、エンゲージメント数を取得できます。このアクションではボードのリンクは受け付けません。リンク先のサイトのクロールや利用許諾は行いません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- Pinterestリクエストの対象URLを指定します。pinアクションには/pin/NUMERIC_ID/を含むピンURLが、board_detailには/username/boardname/形式のボードリンク（またはその相対パス）が必要です。ピンURLの代わりにボードURLを使用することはできません。Pinterest：商品ピンの小売サイトへのリンク — 公式ドキュメントによると、商品ピンからユーザーを小売業者のウェブサイトに誘導でき、一部のリッチピンでは商品の詳細が同期されます。このページが返すのは実際に取得できたピンのフィールドのみで、リアルタイムの在庫、注文機能、取引データを約束するものではありません。 · 確認日
Pinterestのboardsのパラメータはそれぞれどういう意味ですか？
Pinterestアカウントが所有するボードを一覧表示します。説明、カバー画像、ピン数とセクション数、フォロワー数、公開設定、共同ボードフラグを取得できます。共同ボードであっても、すべてのメンバーや非公開のコンテンツは取得できません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況username必須- profile、user_posts、boardsアクションで使用するPinterestのユーザーハンドルを指定します。先頭の@は付けても付けなくてもかまいません。プロフィールのWeb URL全体は指定できません。Pinterest：ボードとボードセクションの階層 — Pinterestでは、ボード内のピンを整理するためにボードセクションを使います。そのため、`section_count`をボード数として扱わないでください。セクションの作成方法を解説するチュートリアルを参照していても、このエンドポイントでコンテンツを作成、移動、編集できることを意味するものではありません。 · 確認日
Pinterestのboard_pinsのパラメータはそれぞれどういう意味ですか？
1つのPinterestボードに保存されたピンを順に取得します。ボードはboard_id（pinterest/official-newsなど）で指定します。各ピンにはメディア、外部リンク、作成者、エンゲージメントが含まれます。非公開のセクションは除外され、ボード全体の取得は保証されません。
board_id必須- board_pinsで使用するボード識別子です。ボードURLのpinterest.com/以降にあるusername/board-nameの部分を指定します（例：pinterest/official-news）。boardsの結果に含まれる各ボードにはurlがあるので、そこからドメインを除いた値を使用してください。Pinterest：セクションと混同せずにボード単位でピンを整理する — 公式ドキュメントでは、ピンをボード内のセクションに追加できると説明されています。ここでの`board_id`が対象とするのはボードのみです。公式チュートリアルを参照しても、このエンドポイントでIDを変換できるようになるわけではなく、セクション用のクエリパラメータが利用できることを意味するものでもありません。 · 確認日
Pinterestのboard_detailのパラメータはそれぞれどういう意味ですか？
ボードのurlから、Pinterestボードの情報を確認します。所有者、説明、カバー、公開設定、共同ボードフラグ、ピン数・セクション数・フォロワー数を取得できます。ピン自体は含まれません。ピンはboard_pinsで取得します。
url必須- Pinterestリクエストの対象URLを指定します。pinアクションには/pin/NUMERIC_ID/を含むピンURLが、board_detailには/username/boardname/形式のボードリンク（またはその相対パス）が必要です。ピンURLの代わりにボードURLを使用することはできません。Pinterest：シークレットボードの公開範囲 — 公式ドキュメントでは、シークレットボードを閲覧できるのはオーナーと招待されたコラボレーターのみと定められています。ボードのリンクやIDを知っていてもアクセス権限にはならず、このページにはシークレット設定を回避する機能はありません。 · 確認日
Pinterest APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"pinterest","action":"search","params":{"keyword":"<keyword>"}}'
Pinterest APIに関する質問
Pinterest APIでは何を取得できますか？
platformをpinterestに設定します。現在のカタログには検索、プロフィール、ユーザーの投稿、ピン詳細、ボード、moreが掲載されています。これらのアクション名はそれぞれ異なるPinterestのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Pinterestのsearchリクエストを開始するには、どの入力を使用しますか？
searchアクションで使用する検索語句またはインスピレーションのトピックを指定します。返される結果のエンティティ構造は、選択したcontent_typeによって異なります。params内のkeywordとして送信してください。
Pinterestのsearchはどのフィールドを返しますか？
宣言されたスキーマにはtitle、text、image_url、reaction_countが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Pinterestのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。