Instagram 批量查账号 API

用 usernames 一次查多个 Instagram 账号的主页资料,每行带 username、bio、follower_count 和 input,每千次 $0.56。

  • usernames 里每个账号算一次调用
  • input 把行对回你传的那一项
  • 没查到的账号列在 missed 里
免费开始

接口健康状态

24h 健康值
正常
  • 健康 / 正常
  • 可用
  • 少量可用
  • 基本不可用
正常

24 小时趋势

30 天趋势

  1. 1请求

    POST /api/v1/social
    {
      "platform": "instagram",
      "action": "profiles_batch",
      "params": {
        "usernames": [
          "natgeo",
          "nasa"
        ]
      }
    }
  2. 2JSON 响应

    {
      "results": [
        {
          "username": string,
          "display_name": string,
          "bio": string,
          "follower_count": number
        },
        …
      ]
    }
  3. 3表格行

    usernamedisplay_namebiofollower_count
    stringstringstringnumber
  4. 4CSV

    instagram-profiles_batch-sample.csv username,display_name,bio,follower_count,following_count,post_count,is_private,is_verified,is_business,is_professional,category,external_url,avatar_url,user_id,avatar_hd_url,external_urls,has_reels,highlight_count,recent_posts,url,reels_count,business_email,business_phone,threads_username,fbid,is_memorialized,is_joined_recently,account_type,emails,phones,pronouns,bio_links_detail,messaging_ids,business_address,platform,input

请求带 usernames 数组,返回每个账号的一行主页资料,用 input 对回你传的那一项;没查到的账号列在响应的 missed 里,行可以列成字段表,也可下载为 CSV。

能拿到什么数据

每一行是一个账号。下表列出每行会返回的字段、类型和含义,不放任何值。

字段类型含义
usernamestring用户名(@handle)。
display_namestring显示名,可能与 username 不同。
biostring个人简介,账号自己填写的文本。可能含换行和 emoji。
follower_countnumber粉丝数。null 表示不公开,不等于 0。
following_countnumber关注数。null 表示不公开,不等于 0。
post_countnumber发布内容总数。null 表示不公开,不等于 0。
is_privateboolean是否私密账号。
is_verifiedboolean是否为平台认证账号(蓝V等)。null 表示无法判定。
is_businessboolean是否为商家账号。
is_professionalboolean是否为专业账号(商家或创作者)。
categorystring分类名称,取值为原平台的分类体系,未做跨平台归一。
external_urlstring主页外链。
avatar_urlstring头像图片链接。部分平台给的是带尺寸参数的 CDN 链接,可能有时效。
user_idstring用户在原平台的唯一 ID。
avatar_hd_urlstring高清头像链接(avatar_url 是小图)。
external_urlsarray简介里的全部外链:url、title(external_url 只是第一个)。
has_reelsboolean是否发过 Reels。
highlight_countnumber精选快拍(Highlights)个数。
recent_postsarray主页上最新的几条帖子(含置顶帖),数组,每项是一条帖子,字段和 user_posts 的一行相同(有值才出现)。私密账号或没发过帖时不出现。
urlstring该记录在原平台上的可访问链接。
reels_countnumber这个账号发过的 Reels 条数(整数)。
business_email—商家账号在主页「联系」(Contact)按钮里公开的邮箱。没有时不出现。
business_phone—商家账号在主页「联系」(Contact)按钮里公开的电话。没有时不出现。
threads_usernamestring主页上 Threads 徽章显示的名字,一般就是这个人的 Threads 用户名。
fbidstringMeta 给这个账号的另一个数字编号,和 user_id 不是同一个数。
is_memorialized—是纪念账号(本人去世后 Instagram 设成的纪念状态)。只在是纪念账号时出现,值为 true。
is_joined_recently—主页上标着「最近加入」(Joined recently)。只在有这个标记时出现,值为 true。
account_typestring账号类型:personal 个人、business 商家、creator 创作者。
emails—联系邮箱列表(一条记录可能有多个),原文透传、去重。
phones—本人公开写在简介里的电话号码,数组。只收以 + 或 00 开头的号码,或者前面写明 WhatsApp、电话这类字样的号码。没有时不出现。
pronouns—主页上填写的人称代词,数组。
bio_links_detailarray简介区的每个链接,一个链接一项:url(真实地址,已去掉 Instagram 包的那层跳转)、title(链接标题,有的才带)、type(Instagram 给的链接类型,如 external)。external_urls 是同一批链接的 url 和 title。
messaging_ids—简介里公开写的聊天账号,一个账号一项 {app, id};app 如 wechat、line、telegram、kakao、skype、signal。
business_address—商家账号公开的地址,对象:street、city、zip、lat、lng,有的才带。
platformstring数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
input—(profiles_batch)这一行对应 usernames 里的哪一项,按你传的写法原样带回。用它把行和你传的项对上;返回的 username 可能和你传的写法不同,比如你传的是主页链接。

用途

  • 一次查一批账号

    把一份名单里的账号放进 usernames,一次请求取回它们的 follower_count 和 post_count。

  • 用 `input` 对回名单

    input 是你传的那一项,原样带回;用户名和主页链接混着传时,也能把行对回去。

  • 找出没查到的账号

    读响应里的 missed,看哪些账号这次没查到,它们不收费。

  • 筛私密和商家账号

    按 is_private、is_business 和 category 分组,把名单里的账号分类。

Instagram Graph API 与 EveryInfra 对比

下面从能读哪些账号、访问条件两方面,比 Instagram 官方 Graph API 和 EveryInfra profiles_batch。

对比项Instagram Graph APIEveryInfra
能读哪些账号"Get fields and edges on an Instagram Business or Creator Account."usernames 里的每个账号,用户名或主页链接都行;每行返回 is_private、is_business、is_professional 标记。
访问条件访问令牌:"Required. App user’s User access token."一把 EveryInfra API Key 放在 Authorization: Bearer 请求头里,不用登录 Instagram,也不用 Instagram 访问令牌。

引文出自 Meta 开发者文档(IG User 页),2026-11-22 核对。 官方出处: IG User (更新于 2026-04-22)

限制和注意事项

  • usernames 是数组,不收逗号分隔的字符串;条数上限见参数说明。
  • 每项是用户名或主页链接;同一个账号只能出现一次,大小写不同算同一个。
  • 按账号个数计费;没查到的账号不收费,列在响应的 missed 里。
  • 每行的 input 是你传的那一项,返回的 username 可能和你传的写法不同,比如你传的是主页链接。
  • 私密账号 is_private 为真,不返回 recent_posts。
  • 只支持同步调用。

价格

按账号个数计费:usernames 里每个账号算一次调用,$0.000556;没查到的账号不收费,列在 missed 里。失败和空结果不收费。

调用次数费用
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": "profiles_batch",
  "params": {
    "usernames": [
      "natgeo",
      "nasa"
    ]
  }
}'

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

usernames 放最多 20 个账号,每项是用户名或主页链接;一个账号一行,没查到的不收费,列在响应的 missed 里。

API 参考

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

POST

AI 提示词

#
请帮我用 EveryInfra 的「Instagram 批量查账号」接口(instagram/profiles_batch)写一个数据采集脚本。

接口约定:
- 请求:POST https://api.everyinfra.com/api/v1/social,请求头 Authorization: Bearer <API Key>;Key 从环境变量 EVERYINFRA_API_KEY 读取,不要写进代码。
- 请求体里 platform 填 instagram,action 填 profiles_batch,参数放在 params 里。
- 必填参数:
  - usernames:要查的 Instagram 账号,数组,一次最多 20 个,不收逗号分隔的字符串;同一个账号只能出现一次(大小写不同算同一个)。每项可以是用户名(如 natgeo,前面的 @ 会去掉)或主页链接。按账号个数计费。
- 可选参数:
  - limit:这次调用最多返回的条数,整数,至少为 1;不传按默认值,实际返回可能少于这个数。
- 返回一组记录,每条记录的主要字段:username、display_name、bio、follower_count、following_count、post_count、is_private(是否私密账号)、is_verified、is_business(是否为商家账号)、is_professional(是否为专业账号(商家或创作者))、category、external_url(主页外链);一共 35 个字段,完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=instagram。
- 示例请求体:
{
  "platform": "instagram",
  "action": "profiles_batch",
  "params": {
    "usernames": [
      "natgeo",
      "nasa"
    ]
  }
}
- 计费:$0.56 / 千次;失败和空结果不扣费。
- 这个接口只能同步调用,请求体里不要加 "mode": "async"。
- 返回 422 时,按错误信息里的候选参数和允许值修正;返回 429 或 503 时,按 Retry-After 等待后重试。

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

请求参数

#
参数名位置类型必填默认值说明
Authorizationheaderstring是-Bearer 加你的 API Key。在控制台创建;不要放进网址或代码仓库。
platformbodystring是instagram平台标识,固定值。
actionbodystring是profiles_batch能力标识,固定值。
usernamesbody.paramsarray是-要查的 Instagram 账号,数组,一次最多 20 个,不收逗号分隔的字符串;同一个账号只能出现一次(大小写不同算同一个)。每项可以是用户名(如 natgeo,前面的 @ 会去掉)或主页链接。按账号个数计费;没查到的账号不收费,列在响应的 missed 里。
limitbody.paramsinteger (1–)否-这次调用最多返回的条数,整数,至少为 1;不传按默认值,实际返回可能少于这个数。

响应示例

#
这组示例参数还没有真实样例:这里只按接口定义列出响应结构和字段,值用 … 占位,不是一次真实调用的结果。
json
{  "id": "req_…",  "platform": "instagram",  "action": "profiles_batch",  "results": [    {      "username": …,      "display_name": …,      "bio": …,      "follower_count": …,      "following_count": …,      "post_count": …,      "is_private": …,      "is_verified": …,      "is_business": …,      "is_professional": …,      "category": …,      "external_url": …,      "avatar_url": …,      "user_id": …,      "avatar_hd_url": …,      "external_urls": …,      "has_reels": …,      "highlight_count": …,      "recent_posts": …,      "url": …,      "reels_count": …,      "business_email": …,      "business_phone": …,      "threads_username": …,      "fbid": …,      "is_memorialized": …,      "is_joined_recently": …,      "account_type": …,      "emails": …,      "phones": …,      "pronouns": …,      "bio_links_detail": …,      "messaging_ids": …,      "business_address": …,      "platform": …,      "input": …    }  ],  "count": …,  "billing": {    "charged": …,    "charged_usd": …,    "balance_after_usd": …,    …  },  "quota": { … }}

返回字段

#

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

字段含义
username用户名(@handle)。
display_name显示名,可能与 username 不同。
bio个人简介,账号自己填写的文本。可能含换行和 emoji。
follower_count粉丝数。null 表示不公开,不等于 0。
following_count关注数。null 表示不公开,不等于 0。
post_count发布内容总数。null 表示不公开,不等于 0。
is_private是否私密账号。
is_verified是否为平台认证账号(蓝V等)。null 表示无法判定。
is_business是否为商家账号。
is_professional是否为专业账号(商家或创作者)。
category分类名称,取值为原平台的分类体系,未做跨平台归一。
external_url主页外链。
avatar_url头像图片链接。部分平台给的是带尺寸参数的 CDN 链接,可能有时效。
user_id用户在原平台的唯一 ID。
avatar_hd_url高清头像链接(avatar_url 是小图)。
external_urls简介里的全部外链:url、title(external_url 只是第一个)。
has_reels是否发过 Reels。
highlight_count精选快拍(Highlights)个数。
recent_posts主页上最新的几条帖子(含置顶帖),数组,每项是一条帖子,字段和 user_posts 的一行相同(有值才出现)。私密账号或没发过帖时不出现。
url该记录在原平台上的可访问链接。
reels_count这个账号发过的 Reels 条数(整数)。
business_email商家账号在主页「联系」(Contact)按钮里公开的邮箱。没有时不出现。
business_phone商家账号在主页「联系」(Contact)按钮里公开的电话。没有时不出现。
threads_username主页上 Threads 徽章显示的名字,一般就是这个人的 Threads 用户名。
fbidMeta 给这个账号的另一个数字编号,和 user_id 不是同一个数。
is_memorialized是纪念账号(本人去世后 Instagram 设成的纪念状态)。只在是纪念账号时出现,值为 true。
is_joined_recently主页上标着「最近加入」(Joined recently)。只在有这个标记时出现,值为 true。
account_type账号类型:personal 个人、business 商家、creator 创作者。
emails联系邮箱列表(一条记录可能有多个),原文透传、去重。
phones本人公开写在简介里的电话号码,数组。只收以 + 或 00 开头的号码,或者前面写明 WhatsApp、电话这类字样的号码。没有时不出现。
pronouns主页上填写的人称代词,数组。
bio_links_detail简介区的每个链接,一个链接一项:url(真实地址,已去掉 Instagram 包的那层跳转)、title(链接标题,有的才带)、type(Instagram 给的链接类型,如 external)。external_urls 是同一批链接的 url 和 title。
messaging_ids简介里公开写的聊天账号,一个账号一项 {app, id};app 如 wechat、line、telegram、kakao、skype、signal。
business_address商家账号公开的地址,对象:street、city、zip、lat、lng,有的才带。
platform数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
input(profiles_batch)这一行对应 usernames 里的哪一项,按你传的写法原样带回。用它把行和你传的项对上;返回的 username 可能和你传的写法不同,比如你传的是主页链接。

错误与计费

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

错误码

常见问题

Instagram 批量查账号接口返回什么?

每个账号一行:username、display_name、bio、follower_count、following_count、post_count、is_private、is_verified、category、external_url、input 等。

批量查账号怎么算钱?

usernames 里每个账号算一次调用,每次 $0.000556,每千次 $0.56。没查到的账号不收费,失败和空结果不收费。

没查到的账号怎么知道?

看响应里的 missed,没查到的账号列在那里。

批量查账号要登录 Instagram 吗?

不用。请求头里放一把 EveryInfra API Key(Authorization: Bearer),不用登录 Instagram,也不用 Instagram 访问令牌。

profiles_batch 和 profile 有什么区别?

profile 一次读一个账号,输入是 username。profiles_batch 一次读 usernames 里的多个账号,每行用 input 对回你传的那一项。

同一把 Key 还能调用 Instagram 的其他能力,比如读单个账号的 profile。

Google Analytics 同意才加载 隐私