Instagram 采集器：账号资料、帖子、短视频与评论

采集为异步：提交 run → 轮询状态 → 取数。完整端到端流程见 快速开始；统一响应信封、run 状态机、计费与错误码见 认证与错误处理。本页只列各端点的提交参数（target 字段）与输出记录字段。

快速说明

• Base URL：https://api.antsdata.com/v1
• 提交 run：POST /v1/scraper/instagram/<资源>，请求体 { deliveryMode, recordLimit, targets:[…] }

💡 也可用 deliveryMode: "sync" 同步模式（小任务阻塞等终态，超时自动 fallback 转轮询）——详见 快速开始 · 同步模式。

• 鉴权：请求头 Authorization: Bearer ants_xxxxxxxxxxxx（静态 API Key）
• Content-Type：application/json
• targets：数组入参（≥1）；每个元素的字段 = 各端点下表的「target 字段」。单目标成败在 run 的 tasks[]，不在结果记录里。
• 取数：提交返回 201 + { id, status:"queued" }；按 id 轮询 GET /v1/scraper/runs/{id} 至 succeeded，再按 id 分页取记录或下载（见快速开始）。

端点一览

Profile — 账号资料

采集一个或多个账号的公开资料。

端点：POST /v1/scraper/instagram/profile

target 字段（targets[] 每个元素）：

输出记录字段（records 每条）：

提交示例：

curl -X POST "https://api.antsdata.com/v1/scraper/instagram/profile" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 1000,
    "targets": [
      { "username": "nike" },
      { "username": "instagram" }
    ]
  }'

返回 201 + { "id": <run 号>, "status": "queued" }；随后按 id 轮询状态、取数（见快速开始）。

Posts — 账号帖子

采集指定账号发布的帖子列表。

端点：POST /v1/scraper/instagram/posts

target 字段（targets[] 每个元素）：

每个账号返回的帖子数由 run 的 recordLimit 控制（默认 1000）。

输出记录字段（records 每条）：

提交示例：

curl -X POST "https://api.antsdata.com/v1/scraper/instagram/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 500,
    "targets": [
      { "username": "nike" }
    ]
  }'

返回 201 + { "id": <run 号>, "status": "queued" }；随后按 id 轮询状态、取数（见快速开始）。

Reels — 账号短视频

采集指定账号的 Reels 短视频列表。

端点：POST /v1/scraper/instagram/reels

target 字段（targets[] 每个元素）：

每个账号返回的短视频数由 run 的 recordLimit 控制（默认 1000）。

输出记录字段（records 每条）：

提交示例：

curl -X POST "https://api.antsdata.com/v1/scraper/instagram/reels" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 300,
    "targets": [
      { "username": "nike" }
    ]
  }'

返回 201 + { "id": <run 号>, "status": "queued" }；随后按 id 轮询状态、取数（见快速开始）。

Comments — 帖子评论

按帖子 URL 采集评论。

端点：POST /v1/scraper/instagram/comments

target 字段（targets[] 每个元素）：

每个帖子返回的评论数由 run 的 recordLimit 控制（默认 1000）。

输出记录字段（records 每条）：

提交示例：

curl -X POST "https://api.antsdata.com/v1/scraper/instagram/comments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "deliveryMode": "async",
    "recordLimit": 200,
    "targets": [
      { "post": "https://www.instagram.com/p/DZyno24tbY2/" }
    ]
  }'

返回 201 + { "id": <run 号>, "status": "queued" }；随后按 id 轮询状态、取数（见快速开始）。

取数与生命周期

提交 run 后：

1. 轮询：GET /v1/scraper/runs/{id} 至 status 进入终态 succeeded / failed（建议退避 1s→2s→5s）。
2. 取数：succeeded 后 GET /v1/scraper/runs/{id}/records?page=1&pageSize=20 分页取记录，或 GET /v1/scraper/runs/{id}/download?format=json|csv|excel 下载整份产物。
3. 部分成功：单目标失败不影响其余目标 —— 失败目标在 tasks[].status=failed 且带 errorMessage，只要 ≥1 目标成功 run 即 succeeded 并按成功条数出数。

字段完整说明、run 状态机、计费与错误码见 认证与错误处理。

FAQ

Q: 一次能采集多个账号 / 帖子吗？

可以。targets 是数组，一个 run 可含多个目标，内部并行执行，逐目标状态见 run 的 tasks[]。

Q: 私密或不存在的账号会怎样？

该目标在 tasks[] 里标记 status:"failed" 并带 errorMessage，其余目标照常出数，run 仍可 succeeded。

Q: 采集失败会扣费吗？

不会。计费按成功产出的记录条数结算，全部目标失败则释放冻结、不计费（详见 认证与错误处理）。

Q: recordLimit 是什么？

每个 target 的记录上限（默认 1000）。例如 posts 端点传 3 个 username、recordLimit: 500，则每个账号最多采 500 条帖子。

下一步

• 平台指南：TikTok · X · Facebook · LinkedIn · Google · YouTube · Amazon
• 同步搜索：Google SERP
• 认证与错误处理 — 统一响应信封、run 状态机、计费与错误码