POST/v1/user_profile"platform": "facebook"

Facebook 账号资料接口

一个账号。

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

免费开始登录后运行

注册送 100 积分，不用绑卡

2 积分每次调用

一个对象每次调用返回

2026-10-17最近实测

784 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": "facebook",    "id": "100044561550831"  }'

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

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

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

200 OK784 B2 积分

{  "platform": "facebook",  "status": "ok",  "items": [    {      "platform": "facebook",      "id": "…",      "ref": "…",      "approx": [        {          "field": "followers",          "kind": "approximate"        }      ],      "type": "account",      "username": "…",      "name": "…",      "url": "https://example.com/…",      "bio": "…",      "verified": null,      "followers": 28000000,      "following": null,      "posts_count": null    }  ],  "unavailable": ["verified", "following", "posts_count"],  "cost_credits": 2}

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

28,000,000 粉丝null 关注null 作品

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

示例数据完整返回

4 个参数。
1 个必填。

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

名称	类型	是否必填	默认值	说明
platform	string	必填	—	这一页固定填 "facebook"。
id	string	几个里给一个	—	主页编号，一串数字
username	string	几个里给一个	—	主页的账号名，即主页链接里 facebook.com/ 后面那一段
url	string	几个里给一个	—	主页链接，facebook.com/账号名的写法

这些值从哪里拿。

id

主页编号，一串数字（例如 100044561550831）

平台上没有别的接口返回它，按上面的说明从网页或链接里取。

username

主页的账号名，即主页链接里 facebook.com/ 后面那一段（例如 NASA）

平台上没有别的接口返回它，按上面的说明从网页或链接里取。

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

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