Instagram主页或对象详情 API

POST

接口健康状态

24h 健康值: 70%
24h 平均耗时: 14.60 s

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

可用

24 小时趋势

30 天趋势

主页或对象详情：返回单个对象；主要字段 username、display_name、bio、follower_count、following_count、post_count。

单价 $0.56 / 千次（每次 $0.000556），失败与空结果不扣费。同步返回；慢任务可在请求体加 "mode": "async"，先拿 job_id 再轮询。

AI 提示词

复制下面这段给你常用的 AI 助手：里面写好了这个接口的参数、返回字段和示例请求，它会先问清你的需求，再帮你写采集脚本。

请帮我用 EveryInfra 的「Instagram 主页或对象详情」接口（instagram/profile）写一个数据采集脚本。

接口约定：
- 请求：POST https://api.everyinfra.com/api/v1/social，请求头 Authorization: Bearer <API Key>；Key 从环境变量 EVERYINFRA_API_KEY 读取，不要写进代码。
- 请求体里 platform 填 instagram，action 填 profile，参数放在 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（主页外链）；一共 14 个字段，完整列表见 https://api.everyinfra.com/api/v1/social/catalog?platform=instagram。
- 示例请求体：
{
  "platform": "instagram",
  "action": "profile",
  "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`	是	`profile`	能力标识，固定值。
`username`	body.params	未声明	是	-	Instagram 账号 handle，建议不带 @ 或完整主页 URL。profile/persona/user_posts/reels 查询账号数据；followers 只查粉丝数量，followers_list/following_list 才查粉丝/关注账号列表。

代码示例

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": "profile",
  "params": {
    "username": "nasa"
  }
}'

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

响应示例

真实返回样例

2026年9月26日 16:56（北京时间）用上方代码示例的参数真实调用所得。results 与 count 是那次的真实返回，已隐去名字、账号、头像、主页链接、联系方式等个人信息；id、billing、quota 每次调用都不同，只给结构。

json

{
  "id": "req_…",
  "platform": "instagram",
  "action": "profile",
  "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-mad1-1.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"
      }
    ]
  },
  "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 链接，可能有时效。
`recent_posts`	保留平台原语义

错误与计费

401: 缺少 Key 或 Key 无效。先鉴权再校验参数，未鉴权的请求拿不到参数结构。
422: 参数名或取值不对。错误信息会列出这项能力支持的参数、允许值和最接近的候选，按它改即可；发生在扣费之前。
402: 余额不足，请先充值。
429: 超过账户的每分钟请求上限（名下所有 Key 合计；Key 自设了更低上限时先按它算），按 Retry-After 等待后再试。需要更高上限可在控制台买提速包。
503: 暂时无法完成。已预扣的费用按原账本退回；响应里的 billing 与 refund 写明实际结果，结果未知时会明确标出，不要直接重发。
200 空结果: 请求完成但没有数据，不扣费（billing.reason = empty_result_refunded）。