身份验证
使用 API Key 调用接口，在请求中添加以下 HTTP 请求头。
Authorization: Bearer <YOUR_KEY>API 接入需要付费 Workspace；接口按实际使用计费。
POST/api/openapi/v1/creators/audience-analysis受众分析
接口价格40 积分 / 份报告
失败退款；已有有效报告复用和 GET 查询免费。
支持平台Instagram / YouTube / TikTok / Twitter / X
快速调用示例 (cURL)
curl -X POST 'https://app.hicreator.ai/api/openapi/v1/creators/audience-analysis' \
-H 'Authorization: Bearer <YOUR_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"profile_url": "https://x.com/example_creator"
}'请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| profile_url | string | 是 | 达人主页链接。 |
响应字段
| 参数名 | 类型 | 始终返回 | 说明 |
|---|---|---|---|
| requestId | string | 是 | 请求 ID，用于排查问题。 |
| data | object | 是 | 任务与报告。 |
| data.id | string (UUID) | 是 | 报告任务 ID。 |
| data.type | string | 是 | 报告类型。查看可选值audience_analysis / fake_follower_check |
| data.platform | string | null | 是 | 所属平台。 |
| data.canonicalUrl | string | null | 是 | 达人主页链接。 |
| data.status | string | 是 | 任务状态。查看可选值queued / running / succeeded / unavailable / failed |
| data.errorCode | string | null | 是 | 失败原因代码。 |
| data.createdAt | string | 是 | 创建时间。 |
| data.startedAt | string | null | 是 | 开始时间。 |
| data.finishedAt | string | null | 是 | 结束时间。 |
提交响应（HTTP 202）
{
"requestId": "<http-request-id>",
"data": {
"id": "11111111-1111-4111-8111-111111111111",
"platform": "twitter",
"canonicalUrl": "https://x.com/example_creator",
"status": "queued",
"errorCode": null,
"createdAt": "2026-10-08T01:00:00.000Z",
"startedAt": null,
"finishedAt": null,
"type": "audience_analysis"
}
}保存 data.id 和 data.type，用于查询报告。
错误与重试
查看 error.message；排查时提供 requestId。结果不确定时请勿自动重试。
提交后查询同一任务，请勿重复提交。