Instagram 单条内容 API

按链接读帖子或 Reel：text、like_count、view_count 和作者粉丝数，每千次 $0.56，每个链接算一次。

Instagram 单条内容按 urls 读取指定帖子的公开数据：正文和媒体类型，点赞、评论、浏览数，作者的用户名、ID 和粉丝数，发布时间和地点，展示的几条评论 top_comments，以及图片、视频链接和宽高。它回答「这几条帖子现在是什么数据」，适合复盘合作帖的效果、核对竞品内容，或者把话题内容里发现的帖子补读一遍。

urls 是数组，每项是完整帖子链接，形如 /p/<shortcode>/ 或 /reel/<shortcode>/；单次最多 11 条，按目标链接数计费，多链接的费用不能按一条估算。评论接口只处理单个链接，不要把这里的多链接写法直接套过去。

一次最多返回 11 条
不用登录 Instagram
失败和空结果不收费

免费开始

接口健康状态

24h 健康值: 正常

健康 / 正常
可用
少量可用
基本不可用

24 小时趋势

30 天趋势

1请求

POST /api/v1/social
{
  "platform": "instagram",
  "action": "post",
  "params": {
    "urls": [
      "https://www.instagram.com/p/<POST_SHORTCODE>/"
    ]
  }
}

2JSON 响应

{
  "results": [
    {
      "post_id": string,
      "text": string,
      "media_type": string,
      "like_count": number
    },
    …
  ]
}

3表格行
post_id text media_type like_count
string string string number
4CSV
instagram-post-sample.csv post_id,url,text,media_type,like_count,comment_count,view_count,author_username,author_name,posted_at,location,id,image_url,video_url,author_id,width,height,is_comments_disabled,author_follower_count,hashtags,top_comments

post_id	text	media_type	like_count
string	string	string	number

请求带 urls（链接数组）和可选的 limit，同一个响应里回来每条帖子的 text、like_count、view_count、author_follower_count 等字段，再变成表格行和 CSV。

能拿到什么数据

下表列出每一行会返回的字段、类型和含义，不含具体值。

字段	类型	含义
post_id	string	帖子 ID。
url	string	该记录在原平台上的可访问链接。
text	string	正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。
media_type	string	媒体类型（图/视频/轮播）。
like_count	number	点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
comment_count	number	评论数。null 表示不公开，不等于 0。
view_count	—	浏览/播放数。null 表示不公开，不等于 0。
author_username	string	作者用户名（@handle），通常可用于拼 URL。
author_name	string	作者昵称（显示名）。
posted_at	string	发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
location	string	地理位置描述，原文透传，格式随平台而异。
id	string	该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
image_url	string	图片链接。多图能力可能返回 image_urls 数组。
video_url	string	保留平台原语义
author_id	string	作者在原平台的唯一 ID。
width	number	保留平台原语义
height	number	保留平台原语义
is_comments_disabled	—	帖子是否关闭评论。
author_follower_count	—	作者粉丝数。null 表示不公开。
hashtags	array	正文里的话题标签数组，按出现顺序；没有时不出现这个字段。
top_comments	—	帖子下展示的几条评论，每项含正文（text）和评论人（author_username）；没有时不出现这个字段。

用途

合作帖复盘
把达人发布的链接放进 urls，读 like_count、comment_count 和 view_count，看这些帖子现在的数据。
核对竞品内容
读竞品帖子的 text、media_type 和 posted_at，对比它们发什么、什么时候发。
补读发现的帖子
在话题内容里找到帖子后，把 url 传进来，补读 author_follower_count 和 top_comments。
统计话题标签
读每条帖子的 hashtags 数组，按出现顺序比较一批帖子用了哪些标签。

Instagram Graph API 与 EveryInfra 对比

下面从能读哪些帖子、作者信息和访问条件三方面比 Instagram 官方 Graph API 和 EveryInfra post。

对比项	Instagram Graph API	EveryInfra
能读哪些帖子	"This API returns only data for media owned by Instagram professional accounts. It can not be used to get data for media owned by personal Instagram accounts."	`urls` 里每项是公开帖子或 Reel 的完整链接，形如 /p/<shortcode>/ 或 /reel/<shortcode>/；私密内容不读取。
作者信息	字段 `owner`："Instagram user ID who created the media. Only returned if the app user making the query also created the media; otherwise, username field is returned instead."	每行带 `author_id`、`author_username`、`author_name` 和 `author_follower_count`。
访问条件	"Note that a permission only allows access to data created by the app user who granted the permission."	一把 EveryInfra API Key 放在 `Authorization: Bearer` 请求头里，不用登录 Instagram，也不用 Instagram 访问令牌。

引文出自 Meta 开发者文档，2026-11-09 核对。官方出处： IG Media (更新于 2026-10-29) · Instagram Platform overview (更新于 2026-10-29)

限制和注意事项

urls 必填，是链接数组；每项是完整的帖子链接，形如 /p/<shortcode>/ 或 /reel/<shortcode>/，用户主页链接不行。
limit 是 1 到 11 的整数，默认 11；超出范围返回 422，不扣费。
一次请求最多 11 条，链接更多就分几次传；没有翻页参数。
按目标链接计费，传几个链接算几次，估算费用前先数链接数。
hashtags、top_comments 没有内容时整个字段不出现；view_count 为 null 表示不公开，不等于 0。
不读取私密内容，返回的数据也不授予照片和视频的任何权利。

价格

按目标链接计费：每个链接算一次调用，$0.000556；一次请求最多返回 11 条。失败和空结果不收费。

调用次数	费用
10,000	$5.56
100,000	$55.56
1,000,000	$555.56

合计按每次调用的标价算。

代码示例

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": "instagram",
  "action": "post",
  "params": {
    "urls": [
      "https://www.instagram.com/p/<POST_SHORTCODE>/"
    ]
  }
}'

OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key，复制出去的代码不含你的 Key。

urls 必须是帖子链接数组；替换短码为真实公开帖子，多目标费用不能按一条估算。

API 参考

下面是 post 的参数、响应字段、错误和计费，可以复制整页，或用 Markdown 打开给 AI 助手。

POST

AI 提示词

请帮我用 EveryInfra 的「Instagram 单条内容」接口（instagram/post）写一个数据采集脚本。

接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 instagram，action 填 post，参数放在 params 里。
- 必填参数：
  - urls：post 的帖子完整链接数组，例如 /p/<shortcode>/ 或 /reel/<shortcode>/；按目标链接数计费。comments 只处理单个 url，不要把 post 的多链接请求形状直接套过去。
- 可选参数：
  - limit：这次调用最多返回的条数，整数，1–11；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。（默认 11）
- 返回一组记录，每条记录的主要字段：post_id（帖子 ID）、url、text、media_type（媒体类型（图/视频/轮播））、like_count、comment_count、view_count、author_username、author_name、posted_at、location、id；一共 21 个字段，完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=instagram。
- 示例请求体：
{
  "platform": "instagram",
  "action": "post",
  "params": {
    "urls": [
      "https://www.instagram.com/p/<POST_SHORTCODE>/"
    ]
  }
}
- 计费：$0.56 / 千次；失败和空结果不扣费。
- 一次要采几十上百个时，在请求体加 "mode": "async"：先拿到 job_id，再轮询 GET https://api.everyinfra.com/api/v1/jobs/{job_id} 取结果。
- 返回 422 时，按错误信息里的候选参数和允许值修正；返回 429 或 503 时，按 Retry-After 等待后重试。

写代码前，先问清楚我要采哪些对象、一共多少个、需要哪些字段、结果存成什么格式，再把方案和大概花费讲给我确认。

请求参数

参数名	位置	类型	必填	默认值	说明
`Authorization`	header	`string`	是	-	Bearer 加你的 API Key。在控制台创建；不要放进网址或代码仓库。
`platform`	body	`string`	是	`instagram`	平台标识，固定值。
`action`	body	`string`	是	`post`	能力标识，固定值。
`urls`	body.params	`array`	是	-	post 的帖子完整链接数组，例如 /p/<shortcode>/ 或 /reel/<shortcode>/；按目标链接数计费。comments 只处理单个 url，不要把 post 的多链接请求形状直接套过去。
`limit`	body.params	`integer (1–11)`	否	`11`	这次调用最多返回的条数，整数，1–11；不传按默认值，实际返回可能少于这个数。超过上限会在扣费前返回 422。

响应示例

json

{  "id": "req_…",  "platform": "instagram",  "action": "post",  "results": [    {      "post_id": …,      "url": …,      "text": …,      "media_type": …,      "like_count": …,      "comment_count": …,      "view_count": …,      "author_username": …,      "author_name": …,      "posted_at": …,      "location": …,      "id": …,      "image_url": …,      "video_url": …,      "author_id": …,      "width": …,      "height": …,      "is_comments_disabled": …,      "author_follower_count": …,      "hashtags": …,      "top_comments": …    }  ],  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

业务数据在 results 里；下表是每条记录可能包含的字段，平台没有提供的值不会被编造。

字段	含义
`post_id`	帖子 ID。
`url`	该记录在原平台上的可访问链接。
`text`	正文内容，已去除 HTML 标签，全文返回、不截断（个别平台的列表结果本身只有摘要，以该平台的字段说明为准）。
`media_type`	媒体类型（图/视频/轮播）。
`like_count`	点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
`comment_count`	评论数。null 表示不公开，不等于 0。
`view_count`	浏览/播放数。null 表示不公开，不等于 0。
`author_username`	作者用户名（@handle），通常可用于拼 URL。
`author_name`	作者昵称（显示名）。
`posted_at`	发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
`location`	地理位置描述，原文透传，格式随平台而异。
`id`	该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
`image_url`	图片链接。多图能力可能返回 image_urls 数组。
`video_url`	保留平台原语义
`author_id`	作者在原平台的唯一 ID。
`width`	保留平台原语义
`height`	保留平台原语义
`is_comments_disabled`	帖子是否关闭评论。
`author_follower_count`	作者粉丝数。null 表示不公开。
`hashtags`	正文里的话题标签数组，按出现顺序；没有时不出现这个字段。
`top_comments`	帖子下展示的几条评论，每项含正文（text）和评论人（author_username）；没有时不出现这个字段。

错误与计费

401: 缺少 Key 或 Key 无效。
402: 余额不足，先充值。
422: 参数名或取值不对，按错误信息给的候选改；不扣费。
429: 超过每分钟请求上限，按 Retry-After 等待后再试。
503: 暂时无法完成，预扣的费用退回；结果未知时先核对，不要直接重发。
200 空结果: 没有数据，不扣费。

错误码

常见问题

`urls` 应该怎么填？

填一个数组，每项是一条帖子的完整链接，形如 /p/<shortcode>/ 或 /reel/<shortcode>/。示例里的 <POST_SHORTCODE> 要换成真实公开帖子的短码，用户主页链接不行。单次最多返回 11 条，链接多时分几次传。

一次传多个链接怎么计费？

按目标链接数计费，传几个链接就按几个算，不是一次请求算一次。所以估算费用时不能按一条帖子算，批量读取前先数清楚链接数。

`hashtags` 和 `top_comments` 为什么有时不在结果里？

正文里没有话题标签时，就没有 hashtags；帖子下没有展示评论时，就没有 top_comments。这是字段缺席，处理时用「字段是否存在」判断。view_count 则是 null 表示不公开，不等于 0。

Instagram 帖子 API 能返回什么？

返回链接对应帖子的 text、media_type、like_count、comment_count、view_count、posted_at 和 author_follower_count，有就带 hashtags 和 top_comments。

一次请求最多返回多少条？

最多 11 条。limit 取 1 到 11，默认 11，超出范围返回 422 且不扣费，实际可能少于 limit。没有翻页参数，链接多就分几次请求。

读帖子要花多少钱？

每千次调用 $0.56，每次 $0.000556。这项能力按目标链接计费，传几个链接就算几次，不是一次请求算一次。失败和空结果不收费。

读帖子数据要登录 Instagram 吗？

不用。请求头里放一把 EveryInfra API Key（Authorization: Bearer），也不需要 Instagram 访问令牌。私密内容读不到。

什么时候用 `post`，什么时候用 `comments`？

单条内容（post）读帖子本身的数据，一次可传多个链接。评论（comments）只处理单个链接，返回这条帖子下的评论，不能套用多链接写法。

同一把 Key 还能调 Instagram 的其他能力，比如读账号的帖子或某个话题下的内容。