API 接口与密钥

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

获取 API Key

身份验证

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

Authorization: Bearer <YOUR_KEY>

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

POST/api/openapi/v1/creators/email

找邮箱

接口价格0.2 积分 / 次有效查询

未找到公开邮箱也计费；请求失败退款。

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

快速调用示例 (cURL)

curl -X POST 'https://app.hicreator.ai/api/openapi/v1/creators/email' \
  -H 'Authorization: Bearer <YOUR_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
  "profile_url": "https://www.instagram.com/example_creator/"
}'

请求参数

参数名类型必填说明
profile_urlstring是达人主页链接。
支持平台

响应字段

参数名类型始终返回说明
requestIdstring是请求 ID，用于排查问题。
billingRequestIdstring是计费记录 ID。
dataobject是查询结果。
data.platformstring是所属平台。
data.profile_urlstring是达人主页链接。
data.emailobject是邮箱查询结果。
data.email.statusstring是found：已找到；missing：未找到。
data.email.valuestring | null是邮箱地址；未找到时为 null。

响应示例 (JSON)

{
  "requestId": "<request-id>",
  "billingRequestId": "<billing-request-id>",
  "data": {
    "platform": "instagram",
    "profile_url": "https://www.instagram.com/example_creator/",
    "email": {
      "status": "found",
      "value": "[email protected]"
    }
  }
}

错误与重试

查看 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