Authentication
Authenticate requests with your API key using the following HTTP header.
Authorization: Bearer <YOUR_KEY>API access requires a paid workspace. Calls are billed by usage.
POST/api/openapi/v1/creators/audience-analysisAudience analysis
API pricing40 credits / report
Failures are refunded; reusing a valid report and GET queries are free.
Supported platformsInstagram / YouTube / TikTok / Twitter / X
Quick start (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"
}'Request parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| profile_url | string | Yes | Creator profile link. |
Response fields
| Parameter | Type | Always returned | Description |
|---|---|---|---|
| requestId | string | Yes | Request ID for support. |
| data | object | Yes | Task and report. |
| data.id | string (UUID) | Yes | Report task ID. |
| data.type | string | Yes | Report type.View allowed valuesaudience_analysis / fake_follower_check |
| data.platform | string | null | Yes | Platform. |
| data.canonicalUrl | string | null | Yes | Creator profile link. |
| data.status | string | Yes | Task status.View allowed valuesqueued / running / succeeded / unavailable / failed |
| data.errorCode | string | null | Yes | Failure code. |
| data.createdAt | string | Yes | Created at. |
| data.startedAt | string | null | Yes | Started at. |
| data.finishedAt | string | null | Yes | Finished at. |
Submission response (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"
}
}Save data.id and data.type to retrieve the report.
Errors and retries
See error.message; keep requestId for support. Do not retry uncertain requests.
Query the same task after submission; do not resubmit.