API 接口与密钥

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

获取 API Key

身份验证

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

Authorization: Bearer <YOUR_KEY>

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

POST/api/openapi/v1/creators/fake-follower-check

假粉检测

接口价格30 积分 / 份报告

失败退款；已有有效报告复用和 GET 查询免费。

支持平台Instagram / YouTube / TikTok

快速调用示例 (cURL)

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

请求参数

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

响应字段

参数名类型始终返回说明
requestIdstring是请求 ID，用于排查问题。
dataobject是任务与报告。
data.idstring (UUID)是报告任务 ID。
data.typestring是报告类型。
查看可选值

audience_analysis / fake_follower_check

data.platformstring | null是所属平台。
data.canonicalUrlstring | null是达人主页链接。
data.statusstring是任务状态。
查看可选值

queued / running / succeeded / unavailable / failed

data.errorCodestring | null是失败原因代码。
data.createdAtstring是创建时间。
data.startedAtstring | null是开始时间。
data.finishedAtstring | null是结束时间。

提交响应（HTTP 202）

{
  "requestId": "<http-request-id>",
  "data": {
    "id": "11111111-1111-4111-8111-111111111111",
    "platform": "instagram",
    "canonicalUrl": "https://www.instagram.com/example_creator/",
    "status": "queued",
    "errorCode": null,
    "createdAt": "2026-10-08T01:00:00.000Z",
    "startedAt": null,
    "finishedAt": null,
    "type": "fake_follower_check"
  }
}

保存 data.id 和 data.type，用于查询报告。

错误与重试

查看 error.message；排查时提供 requestId。结果不确定时请勿自动重试。

提交后查询同一任务，请勿重复提交。

API 接口与密钥 | hiCreator