YouTubeRelated postsAPI

POST

APIの稼働状況

24時間の稼働状況
正常
  • 良好/正常
  • 利用可能
正常

過去24時間

過去30日間

List the videos, Shorts and playlists YouTube recommends next to one video, from the video link. Each row has type, title, channel, view count, duration, the time YouTube shows and badges. About 20 per page; pass next_page_token back as page_token for more.

POST https://api.everyinfra.com/api/v1/socialを送信し、platformにyoutube、actionにrelated_postsを指定します。 料金は1,000リクエストあたり$0.56(1回あたり$0.000556)です。失敗した呼び出しと空の結果には課金されません。 同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。

AIプロンプト

#
EveryInfraのYouTube Related postsエンドポイント(youtube/related_posts)を使ったデータ収集スクリプトの作成を手伝ってください。

エンドポイントの仕組み:
- リクエスト:ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにyoutube、actionにrelated_postsを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ:
  - url: A YouTube video link (watch?v=, youtu.be, shorts and live links work).
- 任意パラメータ:
  - page_token: Page token. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, with the other parameters unchanged. About 20 rows per page, as YouTube sends them.
- レコードのリストを返します。各レコードの主なフィールド: type、id、url、title、text、author_name、author_username、author_id、author_url、author_avatar_url、author_is_verified(Whether the channel has a verified badg…)、view_count。フィールドは全部で20個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=youtubeを参照してください。.
- リクエストボディの例:
{
  "platform": "youtube",
  "action": "related_posts",
  "params": {
    "url": "https://www.youtube.com/watch?v=aqz-KE-bpKQ"
  }
}
- 料金:1,000リクエストあたり$0.56。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。

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

リクエストパラメータ

#
名前場所型必須デフォルト説明
Authorizationheaderstringはい-Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
platformbodystringはいyoutubeプラットフォームの識別子です。値は固定です。
actionbodystringはいrelated_posts機能の識別子です。値は固定です。
urlbody.paramsstringはい-A YouTube video link (watch?v=, youtu.be, shorts and live links work).
page_tokenbody.paramsstringいいえ-Page token. Leave it out for the first page, then pass back the previous response's next_page_token exactly as received, with the other parameters unchanged. About 20 rows per page, as YouTube sends them; each page is one call and limit has no effect. Tokens last 24 hours, and the last page has no next_page_token.

コードサンプル

#
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": "youtube",
  "action": "related_posts",
  "params": {
    "url": "https://www.youtube.com/watch?v=aqz-KE-bpKQ"
  }
}'

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

レスポンス例

#
November 21, 2026 at 07:24(UTC)に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報(名前、ハンドル、アバター、プロフィールリンク、連絡先)を削除したものです。リストは先頭の2件のみ掲載しています。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。
json
{  "id": "req_…",  "platform": "youtube",  "action": "related_posts",  "results": [    {      "type": "video",      "id": "xOXolSQcEb4",      "url": "https://www.youtube.com/watch?v=xOXolSQcEb4",      "title": "SNOW BEAR - A Hand-Drawn Animated Short Film (4K) by Aaron Blaise",      "author_name": "T•••e",      "author_username": "A•••t",      "author_id": "•••",      "author_url": "https://www.youtube.com/•••",      "author_avatar_url": "https://yt3.ggpht.com/•••",      "view_count": 11000000,      "duration": "00:11:46",      "published_text": "11mo ago",      "thumbnail_url": "https://i.ytimg.com/vi/xOXolSQcEb4/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAf1ExPg1gBBVYH3kMo5P8-faPi6Q&usqp=CBQ",      "badges": [        "Fundraiser"      ],      "platform": "youtube"    },    {      "type": "video",      "id": "ShnDkbL2kwk",      "url": "https://www.youtube.com/watch?v=ShnDkbL2kwk",      "title": "A Small Miracle: Part 1",      "author_name": "P•••r",      "author_username": "p•••r",      "author_id": "•••",      "author_url": "https://www.youtube.com/•••",      "author_avatar_url": "https://yt3.ggpht.com/•••",      "view_count": 5400000,      "duration": "00:15:54",      "published_text": "6y ago",      "thumbnail_url": "https://i.ytimg.com/vi/ShnDkbL2kwk/hqdefault.jpg?sqp=-oaymwEcCNACELwBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLASFrfa5wvLyHrT624anyXI6qCDuw",      "platform": "youtube"    }  ],  "next_page_token": …,  "pagination": { … },  "count": 26,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

レスポンスフィールド

#

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

フィールド意味
typeレコードの種類です。値は機能によって異なります(例:video / image / text)。
idプラットフォーム上でのレコードの一意なIDです。一意性は1つのプラットフォーム内に限られ、プラットフォームが異なるとIDが重複する場合があります。
urlプラットフォーム上のレコードへのリンクです。
titleタイトルです。プラットフォームにタイトルがない場合(テキストのみの投稿など)はnullになります。
textHTMLを除去した本文です。省略されることなく全文が返されます(一部のプラットフォームでは一覧結果自体に抜粋しか含まれません。その場合は各プラットフォームのフィールドの注記に記載しています)。
author_name投稿者の表示名です。
author_username投稿者のユーザー名(@ハンドル)で、通常はURLに使用できます。
author_idプラットフォーム上での投稿者の一意なIDです。
author_urlプラットフォーム上の投稿者プロフィールへのリンクです。
author_avatar_urlプラットフォーム上の意味のまま
author_is_verifiedWhether the channel has a verified badge.
view_count閲覧数または再生数です。nullは非公開を示し、0ではありません。
durationプラットフォーム上の意味のまま
published_textPublish time as written on the YouTube page, in relative form (e.g. 2 years ago), returned as is; null when the page shows none.
thumbnail_urlサムネイルのリンクです。image_urlより低解像度です。
badgesBadges shown on the video, as an array of strings (e.g. 4K, CC, New); an empty array when there are none.
is_liveWhether the video is live now.
is_upcomingWhether it is a premiere or scheduled live stream that has not started yet.
playlist_idID of the playlist or mix when the row is one; otherwise null.
video_countプラットフォーム上の意味のまま
platform取得元プラットフォームの識別子で、リクエストのplatformと同じです(例:xiaohongshu、tiktok)。

エラーと課金

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

エラー

Google Analyticsは同意が必要 プライバシー