TikTok Hashtag Detail API
Query public TikTok data synchronously; empty results and failures are free.
Results return directly in the same request; no task submission or polling is needed.
Open product page and API TesterEndpoint and authentication
GET https://api.goanyapi.com/api/v1/tiktok/hashtag-detailAuthenticate with Authorization: Bearer YOUR_API_KEY. Supply query-string parameters; there is no request body.
Input parameters
| Parameter | Type | Location | Required | Constraints / default | Description |
|---|---|---|---|---|---|
Authorization | string | Header | Yes | Bearer YOUR_API_KEY | API key for the current account |
challenge_name | string | Query | One of two | ^[^#\s]+$ | Hashtag name. Example: fyp. Supply the hashtag name without #. |
url | string | Query | One of two | ^https://(www\.)?tiktok\.com/tag/[^/?#\s\\]+/?(?:\?[^#\s]*)?(?:#[^\s]*)?$ | Full TikTok hashtag URL. Example: https://www.tiktok.com/tag/fyp. Supply either url or challenge_name, never both. Sharing parameters and fragments are removed. Short links are unsupported. URL resolution adds no separate credit charge. |
Full URL supported: https://www.tiktok.com/tag/fyp. Supply either url or challenge_name, never both. Sharing parameters, fragments and trailing slashes are removed; short links are unsupported. URL format handling adds no separate charge.
Request example
GET /api/v1/tiktok/hashtag-detail?url=https%3A%2F%2Fwww.tiktok.com%2Ftag%2Ffyp
Authorization: Bearer YOUR_API_KEYOutput parameters
Success returns HTTP 200. Null, empty and missing business fields are preserved; a zero statistic is valid. Only documented public fields are returned.
| Field | Type | Description |
|---|---|---|
code | string | ok on success |
message | string | Request message |
data.creditsUsed | number | Credits charged for this request; zero for empty results |
data.remainingCredits | number | Account balance after settlement |
data.hashtag | object | null | Profile object; null when empty |
data.stats | object | null | Statistics |
data.statsV2 | object | null | Large statistics may use strings; values are preserved |
data.hashtag.id | string | number | boolean | null | Hashtag identifier; query hashtag posts directly with a hashtag URL or challenge_name without first retrieving this value |
data.hashtag.title | string | number | boolean | null | Public profile field; may be absent or empty |
data.hashtag.desc | string | number | boolean | null | Public profile field; may be absent or empty |
data.hashtag.coverThumb | string | number | boolean | null | Public profile field; may be absent or empty |
data.hashtag.coverMedium | string | number | boolean | null | Public profile field; may be absent or empty |
data.hashtag.coverLarger | string | number | boolean | null | Public profile field; may be absent or empty |
data.hashtag.profileThumb | string | number | boolean | null | Public profile field; may be absent or empty |
data.hashtag.profileMedium | string | number | boolean | null | Public profile field; may be absent or empty |
data.hashtag.profileLarger | string | number | boolean | null | Public profile field; may be absent or empty |
data.hashtag.isCommerce | string | number | boolean | null | Public profile field; may be absent or empty |
data.stats.diggCount | number | string | null | Returned statistic; may be absent or empty |
data.stats.shareCount | number | string | null | Returned statistic; may be absent or empty |
data.stats.commentCount | number | string | null | Returned statistic; may be absent or empty |
data.stats.playCount | number | string | null | Returned statistic; may be absent or empty |
data.stats.collectCount | number | string | null | Returned statistic; may be absent or empty |
data.stats.followerCount | number | string | null | Returned statistic; may be absent or empty |
data.stats.followingCount | number | string | null | Returned statistic; may be absent or empty |
data.stats.heartCount | number | string | null | Returned statistic; may be absent or empty |
data.stats.heart | number | string | null | Returned statistic; may be absent or empty |
data.stats.videoCount | number | string | null | Returned statistic; may be absent or empty |
data.stats.friendCount | number | string | null | Returned statistic; may be absent or empty |
data.stats.viewCount | number | string | null | Returned statistic; may be absent or empty |
data.statsV2.diggCount | number | string | null | Returned statistic; may be absent or empty |
data.statsV2.shareCount | number | string | null | Returned statistic; may be absent or empty |
data.statsV2.commentCount | number | string | null | Returned statistic; may be absent or empty |
data.statsV2.playCount | number | string | null | Returned statistic; may be absent or empty |
data.statsV2.collectCount | number | string | null | Returned statistic; may be absent or empty |
data.statsV2.followerCount | number | string | null | Returned statistic; may be absent or empty |
data.statsV2.followingCount | number | string | null | Returned statistic; may be absent or empty |
data.statsV2.heartCount | number | string | null | Returned statistic; may be absent or empty |
data.statsV2.heart | number | string | null | Returned statistic; may be absent or empty |
data.statsV2.videoCount | number | string | null | Returned statistic; may be absent or empty |
data.statsV2.friendCount | number | string | null | Returned statistic; may be absent or empty |
data.statsV2.viewCount | number | string | null | Returned statistic; may be absent or empty |
Real response example
Saved from a real successful response and projected to public fields. Lists show only the first two records. Account balance and request charges are omitted; live responses also contain creditsUsed and remainingCredits based on current configuration. Displaying the example sends no query and charges no credits.
{
"code": "ok",
"message": "ok",
"data": {
"hashtag": {
"id": "229207",
"title": "fyp",
"desc": "",
"coverThumb": "",
"coverMedium": "",
"coverLarger": "",
"profileThumb": "",
"profileMedium": "",
"profileLarger": "",
"isCommerce": false
},
"stats": {
"videoCount": 0,
"viewCount": 131746900000000
},
"statsV2": {
"videoCount": "9519133676",
"viewCount": "131746936474533"
}
}
}Billing
With the current configuration, each successful request costs 1 credit.
Non-empty successful results use the currently configured rate; empty results and failures are free. Sufficient balance is required before requesting. A concurrent settlement with insufficient balance also returns 402 without delivering unsettled paid results. Empty or null details and lists without meaningful records are empty; individual empty fields do not make a populated result empty.
Errors
400: invalid parameters; 401: invalid authentication; 402: insufficient credits; 429: rate limit; 502: request failed; 503: API or pricing not configured. Errors contain code and message without internal addresses or credentials.
{"code":"invalid_params","message":"Invalid parameter"}