API Documentation

TikTok Hashtag Detail API

Query public TikTok data synchronously; empty results and failures are free.

Test API

Results return directly in the same request; no task submission or polling is needed.

Open product page and API Tester

Endpoint and authentication

GET https://api.goanyapi.com/api/v1/tiktok/hashtag-detail

Authenticate with Authorization: Bearer YOUR_API_KEY. Supply query-string parameters; there is no request body.

Input parameters

ParameterTypeLocationRequiredConstraints / defaultDescription
AuthorizationstringHeaderYesBearer YOUR_API_KEYAPI key for the current account
challenge_namestringQueryOne of two^[^#\s]+$Hashtag name. Example: fyp. Supply the hashtag name without #.
urlstringQueryOne 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_KEY

Output parameters

Success returns HTTP 200. Null, empty and missing business fields are preserved; a zero statistic is valid. Only documented public fields are returned.

FieldTypeDescription
codestringok on success
messagestringRequest message
data.creditsUsednumberCredits charged for this request; zero for empty results
data.remainingCreditsnumberAccount balance after settlement
data.hashtagobject | nullProfile object; null when empty
data.statsobject | nullStatistics
data.statsV2object | nullLarge statistics may use strings; values are preserved
data.hashtag.idstring | number | boolean | nullHashtag identifier; query hashtag posts directly with a hashtag URL or challenge_name without first retrieving this value
data.hashtag.titlestring | number | boolean | nullPublic profile field; may be absent or empty
data.hashtag.descstring | number | boolean | nullPublic profile field; may be absent or empty
data.hashtag.coverThumbstring | number | boolean | nullPublic profile field; may be absent or empty
data.hashtag.coverMediumstring | number | boolean | nullPublic profile field; may be absent or empty
data.hashtag.coverLargerstring | number | boolean | nullPublic profile field; may be absent or empty
data.hashtag.profileThumbstring | number | boolean | nullPublic profile field; may be absent or empty
data.hashtag.profileMediumstring | number | boolean | nullPublic profile field; may be absent or empty
data.hashtag.profileLargerstring | number | boolean | nullPublic profile field; may be absent or empty
data.hashtag.isCommercestring | number | boolean | nullPublic profile field; may be absent or empty
data.stats.diggCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.shareCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.commentCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.playCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.collectCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.followerCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.followingCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.heartCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.heartnumber | string | nullReturned statistic; may be absent or empty
data.stats.videoCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.friendCountnumber | string | nullReturned statistic; may be absent or empty
data.stats.viewCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.diggCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.shareCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.commentCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.playCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.collectCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.followerCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.followingCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.heartCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.heartnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.videoCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.friendCountnumber | string | nullReturned statistic; may be absent or empty
data.statsV2.viewCountnumber | string | nullReturned 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"}