Instagram 粉丝数量 API

只要总数时用它：一个 Instagram 账号的 follower_count 和 following_count，外加 id、名称、头像和主页链接，每千次 $0.56。

Instagram 粉丝数量按 username 返回一个账号的粉丝数 follower_count 和关注数 following_count，附带用户 ID、用户名、显示名、头像和主页链接，不返回名单。它回答「这个账号有多少粉丝」，适合大批量核对达人粉丝量、定时记录账号增长，或者在拉取粉丝名单前先估一下规模。

只要数字时用它最省事；要逐个看粉丝是谁，用粉丝列表；要看这个账号关注了谁，用关注列表。

失败和空结果不收费
不用登录 Instagram
只返回总数，不返回名单

免费开始

接口健康状态

24h 健康值: 正常

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

24 小时趋势

30 天趋势

1请求

POST /api/v1/social
{
  "platform": "instagram",
  "action": "followers",
  "params": {
    "username": "nasa"
  }
}

2JSON 响应

{
  "results": {
    "username": "nasa",
    "name": "NASA",
    "follower_count": 104336071,
    "following_count": 89,
    …
  }
}

3字段
username name follower_count following_count
nasa NASA 104336071 89
4CSV
instagram-followers-sample.csv id,username,url,name,avatar_url,follower_count,following_count,platform

username	name	follower_count	following_count
nasa	NASA	104336071	89

请求带 username，返回一个 JSON 对象，里面有 follower_count 和 following_count，列成字段表，也可下载为 CSV。

能拿到什么数据

下表是对 nasa 的一次真实调用，采集于 2026年9月26日 16:56（UTC），返回一个对象；灰条是隐去的个人信息（CSV 里是 •••）。你自己调用时，按字段表返回这些字段。

id	username	url	name	avatar_url	follower_count	following_count	platform
	nasa	instagram.com/	NASA		`104336071`	`89`	instagram

下载样例 CSV 返回字段 ↓

用途

批量核对粉丝量
按 handle 逐个读 follower_count，和达人自己报的数字对照。
记录粉丝增长
按期读一次，把 follower_count 和读取时间存成一行，前后相减就是增量。
对比竞品账号
读自己和竞品账号的 follower_count、following_count，放在一起比。
拉名单前估规模
先读 follower_count，再决定要不要调用 followers_list。

Instagram Graph API 与 EveryInfra 对比

Instagram 官方 Graph API 和 EveryInfra followers 都能给出粉丝数，下面比两者的计数字段、能查哪些账号和访问条件。

对比项	Instagram Graph API	EveryInfra
计数字段	字段 `followers_count`："Total number of Instagram users following the user." 字段 `follows_count`："Total number of Instagram users the user follows."	`follower_count` 和 `following_count`，外加 `id`、`username`、`url`、`name`、`avatar_url`；只有总数，不返回账号名单。
能读哪些账号	Business Discovery："You can use the Instagram API with Facebook Login to get basic metadata and metrics about other Instagram professional accounts." "Data about age-gated Instagram professional accounts will not be returned."	`username` 指定的账号，写不带 @ 的 handle，或整条主页地址。
访问条件	访问令牌："Required. App user’s User access token."	一把 EveryInfra API Key 放在 `Authorization: Bearer` 请求头里，不用登录 Instagram，也不用 Instagram 访问令牌。

引文出自 Meta 开发者文档，2026-11-09 核对。官方出处： IG User (更新于 2026-04-22) · Business Discovery (更新于 2026-08-12)

限制和注意事项

username 必填，写不带 @ 的 handle，或整条主页地址。
返回的只有总数；账号名单要用 followers_list 和 following_list。
follower_count、following_count 为 null 表示账号没公开，不等于 0。
计数是调用那一刻的值，不带历史；要看趋势，就定时调用并自己存。
avatar_url 是图片链接，带尺寸参数的 CDN 链接可能过期。
一次调用读一个账号，返回一个对象。

价格

每次调用 $0.000556，按次计费；一次调用读一个账号。失败和空结果不收费。

调用次数	费用
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": "followers",
  "params": {
    "username": "nasa"
  }
}'

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

API 参考

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

POST

AI 提示词

请帮我用 EveryInfra 的「Instagram 粉丝数量」接口（instagram/followers）写一个数据采集脚本。

接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 instagram，action 填 followers，参数放在 params 里。
- 必填参数：
  - username：Instagram 账号 handle，建议不带 @ 或完整主页 URL。profile/persona/user_posts/reels 查询账号数据。
- 返回一个对象，主要字段：id、username、url、name、avatar_url、follower_count、following_count。
- 示例请求体：
{
  "platform": "instagram",
  "action": "followers",
  "params": {
    "username": "nasa"
  }
}
- 计费：$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`	是	`followers`	能力标识，固定值。
`username`	body.params	`string`	是	-	Instagram 账号 handle，建议不带 @ 或完整主页 URL。profile/persona/user_posts/reels 查询账号数据；followers 只查粉丝数量，followers_list/following_list 才查粉丝/关注账号列表。

响应示例

json

{  "id": "req_…",  "platform": "instagram",  "action": "followers",  "results": {    "id": "•••",    "username": "nasa",    "url": "https://www.instagram.com/•••",    "name": "NASA",    "avatar_url": "https://scontent-iad3-2.cdninstagram.com/•••",    "follower_count": 104336071,    "following_count": 89,    "platform": "instagram"  },  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

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

字段	含义
`id`	该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
`username`	用户名（@handle）。
`url`	该记录在原平台上的可访问链接。
`name`	名称。用于账号/商品/商家类能力，指该对象本身的名字。
`avatar_url`	头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
`follower_count`	粉丝数。null 表示不公开，不等于 0。
`following_count`	关注数。null 表示不公开，不等于 0。
`platform`	数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。

错误与计费

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

错误码

常见问题

粉丝数量和粉丝列表怎么选？

只需要数字，比如筛选达人或记录增长，用粉丝数量，它返回一个对象；要知道粉丝具体是谁、做受众分析，用粉丝列表，它逐个返回账号。先看数量再决定要不要拉名单，能省不少调用。

怎么用它记录粉丝增长？

每天固定时间读一次，把 follower_count 和读取时间一起存下来，前后相减就是日增量。同时存下 id，方便和别的能力返回的记录对上。

和主页详情里的粉丝数一样吗？

两处都是账号的粉丝数。主页详情还返回简介、帖子数、外链、最近帖子等一整套资料；只关心 follower_count 和 following_count 时，粉丝数量返回的内容更少、更好处理。

怎么用 Instagram 粉丝数 API 查一个账号的粉丝量？

调用 followers，username 填账号名，比如 nasa，从返回的对象里读 follower_count，following_count 就在旁边。查多个账号，就一个账号调一次。

一次调用能查几个账号？

一个。username 填一个账号，返回一个对象，所以没有 limit，也没有翻页。

查一次粉丝数要多少钱？

每次 $0.000556，每千次 $0.56，按调用次数算。失败和空结果不收费。

查粉丝数要登录 Instagram 吗？

不用。请求头里放一把 EveryInfra API Key（Authorization: Bearer），请求只带 username，不用登录 Instagram，也不用 Instagram 访问令牌。

`followers` 和 `followers_list` 有什么区别？

followers 返回一个对象，只有粉丝数和关注数。followers_list 返回关注这个账号的账号列表，一行一个。只要数字，用 followers。

同一把 Key 还能调用 Instagram 的其他能力。