API 接口与密钥

通过 hiCreator API，将达人发现、数据查询和分析报告接入你的应用。

获取 API Key

身份验证

使用 API Key 调用接口，在请求中添加以下 HTTP 请求头。

Authorization: Bearer <YOUR_KEY>

API 接入需要付费 Workspace；接口按实际使用计费。

POST/api/openapi/v1/creators/by-email

邮箱反查达人

接口价格1 积分 / 个命中邮箱，未找到不收费

支持平台Instagram / YouTube / TikTok / Twitter / X

快速调用示例 (cURL)

curl -X POST 'https://app.hicreator.ai/api/openapi/v1/creators/by-email' \
  -H 'Authorization: Bearer <YOUR_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "[email protected]"
}'

请求参数

参数名类型必填说明
emailstring是要查询的单个邮箱。
支持平台

响应字段

返回全部匹配达人；未知字段为 null，未命中返回空列表。

参数名类型始终返回说明
requestIdstring是请求 ID，用于排查问题。
billingRequestIdstring是计费记录 ID。
dataobject是查询结果。
data.emailstring是查询邮箱。
data.creatorsobject[]是匹配的达人列表。
data.creators[].idstring是平台内达人 ID。
data.creators[].platform'instagram' | 'youtube' | 'tiktok' | 'twitter'是所属平台。
data.creators[].usernamestring | null是账号名。
data.creators[].fullNamestring | null是显示名称。
data.creators[].avatarUrlstring (URL) | null是头像链接。
data.creators[].profileUrlstring (URL) | null是达人主页链接。
data.creators[].youtubeChannelUrlstring (URL) | null是YouTube 频道链接。
data.creators[].youtubeHandleUrlstring (URL) | null是YouTube 账号链接。
data.creators[].biographystring | null是个人简介。
data.creators[].emailstring是公开联系邮箱。
data.creators[].externalLinksstring[] | null是公开外链。
data.creators[].followerCountinteger | null是粉丝或订阅者数量。
data.creators[].followingCountinteger | null是关注数量。
data.creators[].regionstring | null是所在地区。
data.creators[].languagestring | null是主要内容语言。
data.creators[].youtubeHasOfficialEmailboolean | null是是否显示官方邮箱入口。
data.creators[].averagePlayCountnumber | null是平均播放量。
data.creators[].medianPlayCountnumber | null是中位数播放量。
data.creators[].averageViewCountnumber | null是平均帖文浏览量。
data.creators[].medianViewCountnumber | null是中位数帖文浏览量。
data.creators[].averageEngagementRatenumber | null是平均互动率（小数比例）。
data.creators[].medianEngagementRatenumber | null是中位数互动率（小数比例）。
data.creators[].genderstring | null是性别。
data.creators[].ageRangestring | null是年龄段。
data.creators[].ethnicitystring | null是族裔。
data.creators[].faceVisibilitystring | null是出镜情况。
data.creators[].accountTypestring | null是账号类型。
data.creators[].accountPositioningstring[] | null是账号定位标签。
data.creators[].aiDescriptionstring | null是AI 达人简介。

响应示例 (JSON)

{
  "requestId": "<request-id>",
  "billingRequestId": "<billing-request-id>",
  "data": {
    "email": "[email protected]",
    "creators": [
      {
        "id": "123456",
        "platform": "instagram",
        "username": "example_creator",
        "fullName": "Example Creator",
        "avatarUrl": "https://assets.example.com/avatars/creator.jpg",
        "profileUrl": "https://www.instagram.com/example_creator/",
        "youtubeChannelUrl": null,
        "youtubeHandleUrl": null,
        "biography": "Creator biography",
        "email": "[email protected]",
        "externalLinks": [
          "https://example.com/"
        ],
        "followerCount": 50000,
        "followingCount": 120,
        "region": "US",
        "language": "en",
        "youtubeHasOfficialEmail": null,
        "averagePlayCount": 12000,
        "medianPlayCount": 9800,
        "averageViewCount": null,
        "medianViewCount": null,
        "averageEngagementRate": 0.045,
        "medianEngagementRate": 0.041,
        "gender": null,
        "ageRange": null,
        "ethnicity": null,
        "faceVisibility": "clear_face",
        "accountType": null,
        "accountPositioning": [
          "lifestyle creator"
        ],
        "aiDescription": "Lifestyle creator"
      }
    ]
  }
}

错误与重试

查看 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，网关兜底可能缺少此字段，也不能据此确认退款状态。

API 接口与密钥 | hiCreator