本文へスキップ
更新情報新機能

Social: YouTube、Instagram、Threads を API で読み取れるようになりました

Social
POST /v1/async/task に送った SOCIAL リクエスト(YouTube 検索 wireless earbuds review)と、レスポンスの最初の動画: チャンネル、再生回数62,618、高評価957

YouTube、Instagram、Threads を検索し、動画、投稿、コメント、プロフィール、YouTube の字幕を JSON で受け取れます。すべての API キーで使え、完了したリクエスト1件あたり0.5クレジットです。

得られる結果

  • platform youtube: 検索結果、検索語の最新アップロード、動画の視聴ページ、コメントと返信、チャンネル、チャンネルの動画・ショート・ライブ、字幕。
  • platform instagram: キーワードの投稿とリール、公開プロフィールと最新12件の投稿、投稿やリール1件、そのコメント。
  • platform threads: キーワードの投稿、公開プロフィールと最近の投稿、投稿1件、その返信。
  • viewCount、likeCount、commentCount、followerCount などの数値は数字で、publishedAt の時刻とともに返ります。62K のような文字列を解析せずにそのまま比較できます。

仕組み

POST /v1/async/task に taskType SOCIAL と platform、action を送ります。既定の search は query を受け取ります。ほかの action は videoId、channel、username、postUrl のいずれかを受け取り、ページの URL をそのまま入れることもできます。

Social は公開ページを読み取ります。Instagram ではプロフィールの最新12件の投稿と投稿ごとに約12件のコメント、Threads では投稿ごとに約10件の返信です。存在しないページやログインが必要なページは PAGE_UNAVAILABLE でタスクが終わります。

relevance 順の YouTube 動画検索は、次のページ用の nextPageToken を返します。transcript は指定した言語の字幕 text と時刻付きの segments を返し、translateTo を指定すると YouTube が翻訳します。querying.ai MCP サーバーの read_social ツールで、Claude Code、Codex、Cursor などの MCP クライアントからも同じリクエストを実行できます。

活用例

  • 自社ブランドと競合の動画の再生回数、高評価、コメントを日ごとに追跡する。
  • YouTube、Instagram、Threads で新製品の発表に付いたコメントと返信を読み、よく聞かれる質問をまとめる。
  • レビュー動画の字幕をタイムスタンプ付きでモデルに渡し、自社製品に触れている箇所を見つける。
  • 同じ検索語について、YouTube と Threads のクリエイターの発言を ChatGPT や Google AI Mode の回答と並べて比べる。

リクエストを送る

API キーを Authorization ヘッダーに入れてリクエストを送ります。

curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "SOCIAL",
    "payload": {
      "platform": "youtube",
      "action": "search",
      "query": "wireless earbuds review",
      "limit": 10
    }
  }'

リクエストのフィールド

taskTypestring必須
実行するエンジン。CHATGPT や GOOGLE などを指定します。
payload.platformstring必須
読み取るプラットフォーム。youtube、instagram、threads のいずれかです。
payload.actionstring
読み取る対象。search、video、comments、transcript などを指定します。既定値は search。プラットフォームごとの値はドキュメントにあります。
payload.querystring
search と recent で使う検索語。プラットフォームの検索窓に入力するとおりに書きます。
payload.limitinteger
返す結果の数。YouTube の検索は1〜50、既定値は10。
webhook.urlstring
サーバーの HTTPS アドレス。タスクが完了した瞬間に結果をここへ送ります。

レスポンス

完了したタスクはこの形で届きます。長さを抑えて抜粋しています。

JSON
{
  "success": true,
  "task": {
    "id": "…",
    "taskType": "SOCIAL",
    "status": "COMPLETED",
    "createdAt": "…"
  },
  "credits": { "creditsToCharge": 0.5, "creditsCharged": 0.5 },
  "response": {
    "platform": "youtube",
    "action": "search",
    "query": "wireless earbuds review",
    "order": "relevance",
    "returnedCount": 10,
    "videos": [
      {
        "position": 1,
        "videoId": "YdJh6QdOGME",
        "url": "https://www.youtube.com/watch?v=YdJh6QdOGME",
        "title": "Earbuds Awards 2026 - Best Bluetooth Earbuds by Category!",
        "channelTitle": "Mike O'Brien",
        "channelHandle": "@MikeOBrienMedia",
        "publishedAt": "2026-11-17T15:39:37Z",
        "durationSeconds": 995,
        "viewCount": 62618,
        "likeCount": 957
      },
      "…"
    ],
    "nextPageToken": "eyJyIjpbIllkSmg2UWRPR01FIl19"
  }
}
task.statusstring
QUEUED、PROCESSING を経て、回答付きの COMPLETED か error 付きの FAILED で終わります。
credits.creditsChargedinteger
完了したタスクに請求されたクレジット。失敗したタスクは0です。
response.returnedCountinteger
products に入っている商品の数。
response.videosarray
YouTube の順に並んだ動画。position、videoId、url、title、チャンネル、publishedAt、durationSeconds、viewCount、likeCount が入ります。

結果を受け取る

リクエストすると status が QUEUED のタスクがすぐに返ります。status が COMPLETED か FAILED になるまで GET /v1/async/task/{id} で取得するか、webhook.url を指定して同じ task、credits、response をサーバーで受け取ります。結果はタスクの完了から24時間取得できます。

curl https://api.querying.ai/v1/async/task/$TASK_ID \
  -H "Authorization: Bearer $QUERYING_API_KEY"

料金

完了したリクエスト1件あたり0.5クレジットで、プラットフォームや action によらず同じです。課金されるのは完了したリクエストだけです。プランとクレジット: https://querying.ai/pricing

ほかの更新

最新情報を受け取る

製品の更新をメールでお届けします。

RSS フィード