跳到正文
更新日志新功能

Social:通过 API 读取 YouTube、Instagram 和 Threads

Social
发送到 POST /v1/async/task 的 SOCIAL 请求(YouTube 搜索 wireless earbuds review),以及响应中的第一个视频:频道、62,618 次观看、957 个赞

搜索 YouTube、Instagram 和 Threads,以 JSON 获取视频、帖子、评论、主页资料和 YouTube 字幕。所有 API 密钥都可使用,每个完成的请求 0.5 积分。

获得的结果

  • platform youtube:搜索结果、搜索词的最新上传、视频观看页、评论及其回复、频道、频道的视频、Shorts 或直播,以及字幕。
  • platform instagram:关键词下的帖子和 Reels、公开主页及其最近 12 条帖子、单条帖子或 Reel,以及它的评论。
  • platform threads:关键词下的帖子、公开主页及其最近的帖子、单条帖子,以及它的回复。
  • 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 的回答放在一起比较。

发送请求

在 Authorization 请求头中带上 API 密钥发送请求。

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 的任务。用 GET /v1/async/task/{id} 轮询,直到 status 变为 COMPLETED 或 FAILED;或者加上 webhook.url,在服务器上接收同样的 task、credits 和 response。任务结束后,结果保留 24 小时供查询。

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

价格

每个完成的请求消耗 0.5 积分,所有平台和 action 都相同。只对完成的请求计费。套餐与积分:https://querying.ai/pricing

更多更新

接收最新消息

通过邮件接收产品更新。

RSS 订阅