POST/v1/user_profile"platform": "instagram"

Instagram 账号资料接口

一个账号。

Instagram 账号资料 API（数据接口）按账号名返回一个公开的 Instagram 账号：名称、简介、粉丝数和关注数，返回格式和 SocialToAI 的其他调用相同。每次调用 2 积分（约 $0.004–$0.0067），失败不扣。用 HTTP 调用，或让 AI 客户端通过 MCP 调用。最近实测：2026-10-17。

免费开始登录后运行

注册送 100 积分，不用绑卡

2 积分每次调用

一个对象每次调用返回

2026-10-17最近实测

715 B示例返回的体积（1 条）

最近更新：2026-10-17

请求与返回

curl https://api.socialtoai.com/v1/user_profile \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -H "Content-Type: application/json" \  -d '{    "platform": "instagram",    "username": "nasa"  }'

import osimport requestsresponse = requests.post(    "https://api.socialtoai.com/v1/user_profile",    headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"},    json={        "platform": "instagram",        "username": "nasa",    },)print(response.json())

# 已经通过 MCP 接好了？直接用大白话问。查一下这个 Instagram 账号：nasa# 你的 AI 会调用 user_profile 工具，参数是：{  "platform": "instagram",  "username": "nasa"}

登录后运行2 积分登录后带着这些参数进入 Playground，不会自动运行。

200 OK715 B2 积分

{  "platform": "instagram",  "status": "ok",  "items": [    {      "platform": "instagram",      "id": "…",      "ref": "…",      "approx": [],      "type": "account",      "username": "…",      "name": "…",      "url": "https://example.com/…",      "bio": "…",      "verified": true,      "followers": 104341165,      "following": 90,      "posts_count": null    }  ],  "unavailable": ["posts_count"],  "cost_credits": 2}

@…·示例里的文字已去掉

104,341,165 粉丝90 关注null 作品

示例里的名称和正文已去掉，数字是录制时的真实值。

示例数据完整返回

2 个参数。
全部必填。

用 POST 发一个 JSON 请求体。Key 放在 Authorization 请求头里，不要放进网址。

名称	类型	是否必填	默认值	说明
platform	string	必填	—	这一页固定填 "instagram"。
username	string	必填	—	Instagram 账号名，不带 @

这些值从哪里拿。

username

Instagram 账号名，不带 @（例如 nasa）

这些接口返回的每一条都带 username，原样填进来即可：

search · type=user搜索

items 里每一条的字段。
Instagram 给不了的标出来了。

字段	类型	含义
items[].username	string	账号名。
items[].name	string	显示名。
items[].url	string	主页链接。
items[].bio	string	简介。
items[].verified	boolean	是否认证。
items[].followers	integer	粉丝数。
items[].following	integer	关注数。
items[].posts_count	integer始终 null	发布的内容数。

nullInstagram 给不了的字段

null 的意思是“Instagram 没给这个值”，不要当成 0。这些字段在这个调用里始终是 null：

posts_count发布的内容数。

每一条另有 platform、id、ref、approx、type；items 外面的部分每个调用都一样。返回格式

会发生什么。

一次调用返回一个对象，不翻页，2 积分。

每把 Key 每秒 1 次，购买后 5 次；超出不扣费。频率限制

失败的调用 0 积分，不会自动重试。错误码

接好 MCP 后，这样问就会用到它。

查一下这个 Instagram 账号：nasa
user_profile {"platform":"instagram","username":"nasa"}
2 积分
在 Instagram 上找和“nike”有关的账号，再对前 3 个结果：查一下这个 Instagram 账号。
search {"platform":"instagram","query":"nike","type":"user"}user_profile {"platform":"instagram","username":"<username>"} × 3
9 积分