核心接口
X（推特）用户资料 API
X（推特）用户资料接口（user_profile）：每次成功调用 0.1 credits，支持 HTTP 与 Remote MCP，输入、数据来源和计费规则清晰。
01 / 核心接口
一次请求
成功或空结果每次 0.1 credits，失败不计费。
把 PASTE_PUBLIC 占位符换成受支持的公开标识。这是请求模板，不会自动执行。
curl --request POST 'https://api.socialtoai.com/v1/user_profile' \
--header "X-API-Key: $SOCIALTOAI_API_KEY" \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: REPLACE_WITH_A_UNIQUE_REQUEST_ID' \
--data '{"platform":"x","user":"PASTE_PUBLIC_ACCOUNT_ID"}'02 / 核心接口
原生支持
结果类型：profile_card。翻页：不支持。
以上取值来自参考卡。用户查找或特定内容类型可能还有额外限制。请以响应里的 applied_params 和 warnings 为准，不要假定不支持的筛选已生效。
03 / 核心接口
经过结构校验的示例
示意结果，只含一条虚构数据和示例试用余额，用来展示响应结构，不是实时结果，也不代表线上可用率。
{
"request_id": "example_only_not_a_live_call",
"schema_version": "v1",
"fetched_at": "2026-09-05T00:00:00Z",
"status": "ok",
"applied_params": {},
"warnings": [],
"items": [
{
"kind": "profile_card",
"id": "EXAMPLE_ACCOUNT_ID",
"name": "Example account",
"bio": "Illustrative profile, not a real account.",
"followers": 12800,
"posts_count": 214
}
],
"platform": "x",
"billing": {
"cost": 0.1,
"balance": 1.9,
"unit": "credits",
"pricing": "standard"
}
}04 / 核心接口
平台限制
搜索的 count 在请求上游前就限制为 1–20。源端翻页可能不稳定；翻页失败会如实报错，不会悄悄返回第一页。
原生排序只有 relevance 和 latest，其他热度排序是带 warning 的近似实现。时间和媒体筛选使用高级搜索运算符。
热榜仅限全球（Worldwide），没有地区、数量或翻页参数。
评论只包含对该帖子或该回复分支的直接回复。
用户资料需要用户名或主页链接，数字 ID 不会被当作用户名使用。创作者作品也接受用户 ID。
常见问题
这个调用多少钱？
成功或空结果每次 0.1 credits，失败不扣费。
可以翻页吗？
该操作不支持翻页。
平台的所有功能都覆盖了吗？
搜索的 count 在请求上游前就限制为 1–20。源端翻页可能不稳定；翻页失败会如实报错，不会悄悄返回第一页。原生排序只有 relevance 和 latest，其他热度排序是带 warning 的近似实现。时间和媒体筛选使用高级搜索运算符。热榜仅限全球（Worldwide），没有地区、数量或翻页参数。评论只包含对该帖子或该回复分支的直接回复。用户资料需要用户名或主页链接，数字 ID 不会被当作用户名使用。创作者作品也接受用户 ID。