Instagram 账号画像 API
在主页资料之外，再给一个 AI 写的 persona 对象，含 industry、niche、authenticity 和 summary，每千次 $0.56。
Instagram 账号画像在主页资料之外，再给一个 persona 对象：所属行业、行业下的细分领域、真实性判断（通常附一句理由），以及一段话的账号概述。它回答「这是个什么样的账号、值不值得合作」，达人营销团队拿一串候选 handle 批量跑一遍，不必逐个点开主页翻简介和帖子，就能先分出赛道、筛掉可疑号，人工只看要谈的那几个。
主页上那套原始字段照样随响应返回，选了画像就不用再单独调主页详情。账号名填 handle，不带 @，也可以直接给完整主页链接。平台自带的 category 和画像写的行业是两套口径，入库分两列存；前者沿用原平台体系，后者是模型读完内容写的判断，两者差得远的账号再人工点开看。
- 失败和空结果不收费
- 不用登录 Instagram
- 主页字段随响应一起返回
接口健康状态
- 24h 健康值
- 正常
- 健康 / 正常
- 可用
- 少量可用
- 基本不可用
正常
24 小时趋势
30 天趋势
1请求
POST /api/v1/social { "platform": "instagram", "action": "persona", "params": { "username": "nasa" } }2JSON 响应
{ "results": { "username": "nasa", "display_name": "NASA", "bio": "Making the seemingly impossible, possible. ✨", "follower_count": 104336090, … } }3字段
username display_name bio follower_count nasa NASA Making the seemingly impossible, possible. ✨ 104336090 4CSV
instagram-persona-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
username，返回的 JSON 对象里有主页字段和 persona 对象（industry、niche、authenticity、summary），列成字段表，也可下载为 CSV。能拿到什么数据
下表是对 nasa 的一次真实调用，采集于 2026年9月26日 16:56（UTC），返回一个对象；灰条是隐去的个人信息（CSV 里是 •••）。你自己调用时，按字段表返回这些字段，其中 persona 对象是 AI 写的画像。
| 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 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| nasa | NASA | Making the seemingly impossible, possible. ✨ | 104336090 | 89 | 4934 | false | true | false | false | null | https://www.nasa.gov | null | null | null | null | null | [{"post_id":"DdHyaYAifb6","url":"https://www.instagram.com/p/DdHyaYAifb6","text":"Cementing their names in history.\n\nThe Artemis III crew is leaving their mark — literally. The astronauts recently signed their names on the hardware that will be inside their Orion spacecraft during their low Earth orbit mission, launching in 2027.\n\nImage descriptions:\n\n1. The A…","media_type":"image","like_count":0,"comment_count":0,"view_count":0,"author_username":"nasa","posted_at":"2026-09-10T00:00:00+00:00"},{"post_id":"DdWyDLcGiqo","url":"https://www.instagram.com/p/DdWyDLcGiqo","text":"Southern Hemisphere Milky Way galaxy view from the @••• cupola. This 3s exposure series captured two of my favorite cupola views, the particularly dense Milky Way galaxy as seen from the Southern Hemisphere, and the bright, colorful lights of squid fishing boats (here, the brig…","media_type":"image","like_count":0,"comment_count":0,"view_count":0,"author_username":"•••","posted_at":"2026-09-16T00:00:00+00:00"},{"post_id":"DdT_4GMka0z","url":"https://www.instagram.com/p/DdT_4GMka0z","text":"In a class of their own\n\nHidden within this star-forming nebula (captured by our Webb telescope in one of its largest images to date) are strange objects called brown dwarfs. Generally less massive than stars and more massive than planets, they are neither. They form the same way…","media_type":"image","like_count":0,"comment_count":0,"view_count":0,"author_username":"•••","posted_at":"2026-09-15T00:00:00+00:00"}] |
用途
达人初筛
批量跑一串候选 handle，按
industry和niche先分赛道，再人工看要谈的几个。读真实性评估
把
authenticity的评估和理由，连同粉丝数、发帖数一起存档，复核时用。圈赛道名单
用
industry、niche配合category，把某个赛道的账号圈出来。填初筛备注
把
summary原样放进备注列，复核的人不用打开主页就知道账号在做什么。
Instagram Graph API 与 EveryInfra 对比
比 Instagram 官方 Graph API 和 EveryInfra persona，看三处：账号数据、粉丝画像、能读哪些账号。
| 对比项 | Instagram Graph API | EveryInfra |
|---|---|---|
| 账号数据 | Insights："Represents social interaction metrics on your app user’s Instagram business or creator account." | persona 对象里有 industry、niche、authenticity 和 summary，外加和 profile 相同的主页字段。 |
| 粉丝画像 | "The demographic characteristics of followers, including countries, cities and gender distribution." "Not returned if the IG User has less than 100 followers." | 响应里没有年龄、性别、兴趣、买家等特征，也不做这类推断。 |
| 能读哪些账号 | "Note that a permission only allows access to data created by the app user who granted the permission." | username 指定的账号，写不带 @ 的 handle，或整条主页地址。不用登录 Instagram，也不用 Instagram 访问令牌。 |
引文出自 Meta 开发者文档，2026-11-09 核对。 官方出处： Instagram Account Insights (更新于 2026-06-16) · Instagram Platform overview (更新于 2026-10-29)
限制和注意事项
username必填，写不带 @ 的 handle，或整条主页地址。persona是 AI 依据账号的公开主页资料写的，不含年龄、性别、兴趣、买家等特征。authenticity通常附一句理由，是 AI 写的评估，不是平台的认证标记。follower_count、following_count、post_count为null表示账号没公开，不等于 0。category沿用 Instagram 自己的分类体系，没做跨平台归一，和industry是两套口径。is_verified为null表示无法判定。
价格
每次调用 $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": "persona",
"params": {
"username": "nasa"
}
}'OpenAPI 定义 (JSON)示例从环境变量 EVERYINFRA_API_KEY 读取 Key，复制出去的代码不含你的 Key。
API 参考
下面是 persona 的参数、响应字段、错误和计费，可以复制整页，或用 Markdown 打开后交给 AI 助手。
POST
AI 提示词
#请帮我用 EveryInfra 的「Instagram 账号画像」接口（instagram/persona）写一个数据采集脚本。
接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 instagram，action 填 persona，参数放在 params 里。
- 必填参数：
- username：Instagram 账号 handle，建议不带 @ 或完整主页 URL。profile/persona/user_posts/reels 查询账号数据。
- 返回一个对象，主要字段：username、display_name、bio、follower_count、following_count、post_count、is_private（是否私密账号）、is_verified、is_business（是否为商家账号）、is_professional（是否为专业账号（商家或创作者））、category、external_url（主页外链）；一共 19 个字段，完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=instagram。
- 响应顶层还有 persona 对象（industry、niche、authenticity、summary），是 AI 写的英文账号画像，生成失败时为 null。
- 示例请求体：
{
"platform": "instagram",
"action": "persona",
"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 | 是 | persona | 能力标识，固定值。 |
username | body.params | string | 是 | - | Instagram 账号 handle，建议不带 @ 或完整主页 URL。profile/persona/user_posts/reels 查询账号数据；followers 只查粉丝数量，followers_list/following_list 才查粉丝/关注账号列表。 |
响应示例
#2026年9月26日 16:56（北京时间）用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回，已隐去名字、账号、头像、主页链接、联系方式等个人信息；id、billing、quota 每次调用都不同，只给结构。
json
{ "id": "req_…", "platform": "instagram", "action": "persona", "results": { "username": "nasa", "display_name": "NASA", "bio": "Making the seemingly impossible, possible. ✨", "follower_count": 104336090, "following_count": 89, "post_count": 4934, "is_private": false, "is_verified": true, "is_business": false, "is_professional": false, "external_url": "https://www.nasa.gov", "avatar_url": "https://scontent.cdninstagram.com/•••", "recent_posts": [ { "post_id": "DdHyaYAifb6", "url": "https://www.instagram.com/p/DdHyaYAifb6", "text": "Cementing their names in history.\n\nThe Artemis III crew is leaving their mark — literally. The astronauts recently signed their names on the hardware that will be inside their Orion spacecraft during their low Earth orbit mission, launching in 2027.\n\nImage descriptions:\n\n1. The A…", "media_type": "image", "like_count": 0, "comment_count": 0, "view_count": 0, "author_username": "nasa", "posted_at": "2026-09-10T00:00:00+00:00" }, { "post_id": "DdWyDLcGiqo", "url": "https://www.instagram.com/p/DdWyDLcGiqo", "text": "Southern Hemisphere Milky Way galaxy view from the @••• cupola. This 3s exposure series captured two of my favorite cupola views, the particularly dense Milky Way galaxy as seen from the Southern Hemisphere, and the bright, colorful lights of squid fishing boats (here, the brig…", "media_type": "image", "like_count": 0, "comment_count": 0, "view_count": 0, "author_username": "•••", "posted_at": "2026-09-16T00:00:00+00:00" }, { "post_id": "DdT_4GMka0z", "url": "https://www.instagram.com/p/DdT_4GMka0z", "text": "In a class of their own\n\nHidden within this star-forming nebula (captured by our Webb telescope in one of its largest images to date) are strange objects called brown dwarfs. Generally less massive than stars and more massive than planets, they are neither. They form the same way…", "media_type": "image", "like_count": 0, "comment_count": 0, "view_count": 0, "author_username": "•••", "posted_at": "2026-09-15T00:00:00+00:00" } ] }, "persona": { "industry": …, "niche": …, "authenticity": …, "summary": … }, "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 | 保留平台原语义 |
响应顶层在 results 之外还有一个 persona 对象，同步调用和异步任务（mode: async）都有：AI 根据主页资料和最近至多 6 条帖子写的账号画像，内容是英文；生成失败时为 null，results 照常返回。
| 字段 | 含义 |
|---|---|
persona.industry | 所属行业。 |
persona.niche | 行业里的细分领域。 |
persona.authenticity | 真实性判断，通常附一句理由。 |
persona.summary | 一段话的账号画像。 |
错误与计费
#- 401
- 缺少 Key 或 Key 无效。
- 402
- 余额不足，先充值。
- 422
- 参数名或取值不对，按错误信息给的候选改；不扣费。
- 429
- 超过每分钟请求上限，按 Retry-After 等待后再试。
- 503
- 暂时无法完成，预扣的费用退回；结果未知时先核对，不要直接重发。
- 200 空结果
- 没有数据，不扣费。
常见问题
画像和只读原始资料，选哪个更合适？
看你要不要归类意见。两者主页字段相同，差别只在画像多出的那个对象，里面写着行业、细分领域、真实性判断和概述。手里只需要粉丝数、简介这类原始值，选主页详情就行；要给一批账号分门别类、写初筛意见，用画像。主页详情有的字段这边一个不少，从那边切过来，原先解析主页数据的代码不用改，只是多读一个对象。原始值和模型判断同在一份响应里，复核时也不用再发第二次请求。可以这样分工：初筛阶段跑画像，入选的账号之后改用主页详情定期记数。
authenticity 写的真实性判断能直接当结论吗？
建议只当初筛参考。它是 AI 依据主页资料和最近几条帖子写的，通常附一句理由，存档时连理由一起保留，日后复核才知道当时凭什么下结论。拍板合作前，用同一份响应里的数据再核一遍：粉丝数和发帖数是否相称，最近帖子的互动是否正常。计数为空表示没公开，这时只能多看帖子。理由写得含糊、或者和你看到的帖子对不上的，挪进人工复核组，别直接淘汰；整批跑完后抽几个判为可信的号亲自看一遍，再决定这批结果能信几分。
怎样用 industry 和 niche 拉一个赛道的候选名单？
批量读一组账号，先按行业分大类，再用细分领域往下切，切到你要的赛道为止；赛道定得越窄，越要以细分领域为准。再结合 is_business 和 category 把商家号和个人创作者分开。summary 那段概述可以原样贴进初筛表的备注列，复核的人不用打开主页也知道这个号在做什么。画像依据的是读取当时的主页和近期帖子，名单要长期用，记下读取日期，隔段时间重跑一遍，看归类是否还成立。
Instagram 账号画像接口返回什么？
返回一个对象：profile 的主页字段（username、bio、follower_count 等），加一个 persona 对象，里面是 industry、niche、authenticity 和 summary。
画像能给出粉丝的年龄和性别吗？
不能。响应里没有年龄、性别、兴趣、买家等特征，也不做推断。persona 写的是账号自己的行业、细分领域、真实性评估和概述。
一次调用要多少钱？
每次 $0.000556，每千次 $0.56，按调用次数算，不按字段多少算。失败和空结果不收费。
读账号画像要登录 Instagram 吗？
不用。请求头里放一把 EveryInfra API Key（Authorization: Bearer），请求只带 username，不用登录 Instagram，也不用 Instagram 访问令牌。
persona 和 profile 有什么区别？
主页字段两边相同，persona 多一个 AI 写的 persona 对象：industry、niche、authenticity、summary。只要粉丝数、简介这类原始值，用 profile。
相关的 Instagram 能力
同一把 Key 还能调用 Instagram 的其他能力。
- 单条内容
post每千次 $0.56单条内容：返回列表，默认 11 条、单次最多 11 条；主要字段 post_id、url、text、media_type、like_count、comment_count。 - 主页或对象详情
profile每千次 $0.56主页或对象详情：返回单个对象；主要字段 username、display_name、bio、follower_count、following_count、post_count。 - 用户内容
user_posts每千次 $0.56用户内容：返回列表，默认 30 条、单次最多 200 条；主要字段 post_id、url、text、media_type、like_count、comment_count。 - 内容发现
discover每千次 $0.56内容发现：返回列表，默认 30 条、单次最多 200 条；主要字段 post_id、url、text、media_type、like_count、comment_count。 - 评论
comments每千次 $0.79评论：返回列表，默认 50 条、单次最多 100 条；主要字段 id、text、url、like_count、reply_count、author_username。 - Reels 短视频
reels每千次 $1.19Reels 短视频：返回列表，默认 30 条、单次最多 100 条；主要字段 post_id、url、text、media_type、like_count、comment_count。 - 话题内容
hashtag每千次 $0.56话题内容：返回列表，默认 30 条、单次最多 100 条；主要字段 post_id、url、text、media_type、like_count、comment_count。 - 粉丝数量
followers每千次 $0.56粉丝数量：返回单个对象；主要字段 id、username、url、name、avatar_url、follower_count。 - 粉丝列表
followers_list每千次 $0.56粉丝列表：返回列表，默认 50 条、单次最多 500 条；主要字段 id、username、url、name、avatar_url、is_private。 - 关注列表
following_list每千次 $0.56关注列表：返回列表，默认 50 条、单次最多 500 条；主要字段 id、username、url、name、avatar_url、is_private。 - 账号搜索
user_search每千次 $4.81账号搜索：返回列表，默认 20 条、单次最多 30 条；主要字段 rank、username、user_id、display_name、is_verified、is_private。 - Reels 关键词搜索
reels_search每千次 $7.19Reels 关键词搜索：返回列表，默认 20 条、单次最多 200 条；主要字段 post_id、id、url、text、play_count、like_count。 - 相似账号
similar_profiles每千次 $8.81相似账号：返回列表，默认 20 条、单次最多 30 条；主要字段 rank、username、user_id、display_name、is_verified、is_private。 - 被标记的帖子
tagged_posts每千次 $7.44被标记的帖子：返回列表，默认 20 条、单次最多 200 条；主要字段 post_id、url、tagged_username、author_username、author_id、text。 - Stories 内容
stories每千次 $1.5Stories 内容：返回列表，默认 100 条、单次最多 100 条（传更大的数按 100 条返回）；主要字段 id、url、media_url、media_type、duration_seconds、duration_sec。 - 精选合集
highlights每千次 $1.6精选合集：返回列表，默认 100 条、单次最多 100 条（传更大的数按 100 条返回）；主要字段 id、url、title、media_count、cover_url、created_at。 - 评论回复
comment_replies每千次 $0.88评论回复：返回列表，每次一页、每页最多 10 条，条数不固定（短页不代表到底），要更多就把响应顶层的 next_page_token 作为 page_token 再调，没有 next_page_token 才是到底；limit 照收但不起作用；主要字段 id、text、like_count、posted_at、author_username、author_id。支持翻页：把响应里的 next_page_token 作为 page_token 传回拿下一页，其他参数不变，每页算一次调用。