身份验证
使用 API Key 调用接口，在请求中添加以下 HTTP 请求头。
Authorization: Bearer <YOUR_KEY>API 接入需要付费 Workspace；接口按实际使用计费。
POST/api/openapi/v1/creators/detail达人详情
接口价格0.1 积分 / 次成功查询
小黄车检测：0.2 积分 / 次成功查询，未知结果仍计费；失败退款。
支持平台Instagram / YouTube / TikTok / Twitter / X
快速调用示例 (cURL)
curl -X POST 'https://app.hicreator.ai/api/openapi/v1/creators/detail' \
-H 'Authorization: Bearer <YOUR_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"profile_url": "https://www.instagram.com/example_creator/"
}'请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| profile_url | string | 是 | 达人主页链接。 |
| include_video_cart | boolean | 否 | 检测 TikTok 小黄车，默认关闭。 |
响应字段
| 参数名 | 类型 | 始终返回 | 说明 |
|---|---|---|---|
| requestId | string | 是 | 请求 ID，用于排查问题。 |
| billingRequestId | string | 是 | 计费记录 ID。 |
| data | object | 是 | 查询结果。 |
| data.platform | 'instagram' | 是 | 所属平台。 |
| data.canonicalUrl | string (URL) | 是 | 主页或内容链接。 |
| data.retrievedAt | string (ISO 8601) | 是 | 获取时间。 |
| data.creator | object | 是 | 达人资料。 |
| data.creator.id | string | 是 | 平台内达人 ID。 |
| data.creator.username | string | 否 | 账号名。 |
| data.creator.displayName | string | 否 | 显示名称。 |
| data.creator.biography | string | 否 | 个人简介。 |
| data.creator.avatarUrl | string (URL) | 否 | 头像链接。 |
| data.creator.followerCount | integer | 否 | 粉丝或订阅者数量。 |
| data.creator.verified | boolean | 否 | 是否认证。 |
| data.creator.privateAccount | boolean | 否 | 是否为私密账号。 |
| data.creator.platformDetails | object | 是 | 平台专属资料。 |
| data.creator.platformDetails.followingCount | integer | 否 | 关注数量。 |
| data.creator.platformDetails.mediaCount | integer | 否 | 作品总数。 |
| data.creator.platformDetails.businessAccount | boolean | 否 | 是否为商业账号。 |
| data.creator.platformDetails.category | string | 否 | 达人类别。 |
| data.creator.platformDetails.externalUrl | string (URL) | 否 | 主页外链。 |
响应示例 (JSON)
{
"requestId": "<request-id>",
"billingRequestId": "<billing-request-id>",
"data": {
"platform": "instagram",
"canonicalUrl": "https://www.instagram.com/example_creator/",
"retrievedAt": "2026-09-28T01:02:03.000Z",
"creator": {
"id": "<creator-id>",
"username": "example_creator",
"displayName": "Example Creator",
"biography": "Travel creator",
"avatarUrl": "https://example.com/avatar.jpg",
"verified": true,
"privateAccount": false,
"followerCount": 50000,
"platformDetails": {
"followingCount": 300,
"mediaCount": 120,
"businessAccount": true,
"category": "Travel Creator",
"externalUrl": "https://example.com/"
}
}
}
}错误与重试
查看 error.message；排查时提供 requestId。结果不确定时请勿自动重试。
查看错误码
请求：400 参数无效（10001）或数量低于最低值（70004）；401 Key 无效（20001）；403 API 仅向付费 Workspace 开放（60006）；413 请求过大（10005）；415 格式不支持（10006）；429 请求过于频繁（10007）。
执行：404 Twitter 账号不存在或无法公开访问（60008）；422 搜索意图无效（60001）或目标账号无效（60002）；422 邮箱查找未完成（60009）：达到查找上限，全额退款，不代表无邮箱，请勿自动重试；502 邮箱查询失败（60003）或执行失败（60004）；504 请求超时（60005）。网关错误页转换为 API_UPSTREAM_ERROR JSON；不要自动重试付费请求。
积分：402 余额不足（70001）或超过每日限额（70006）；409 当前功能不可用（70002）或积分记录冲突（70003）。API 错误包含 error.code、error.message 和 error.requestId；业务错误在扣费开始后包含 error.billingRequestId，网关兜底可能缺少此字段，也不能据此确认退款状态。