Skip to content
tiktokapi.io
All endpoints

Get hashtag (challenge) detail & total views

GET/v1/challenge/info10 Credits / request($1.00 / 1K requests)

Look up a hashtag by name to retrieve its numeric cid (data.id), description, video count (data.userCount), and total view count (data.viewCount).

Query Parameters

  • challenge_namestringrequired

    Hashtag name without #, e.g. fyp or tiktokmademebuyit.

    Example: fyp

Example Request (cURL / Python / JavaScript)

curl "https://api.tiktokapi.io/v1/challenge/info?challenge_name=fyp" \
  -H "x-api-key: tk_your_api_key"

Live Response Preview

{
  "code": 0,
  "msg": "success",
  "processed_time": 0.15,
  "data": {}
}

Response Fields

Success (code === 0). Charged according to the endpoint credit rate.

FieldTypeSample / Notes
codeintegerExample: 0
msgstringExample: success
processed_timenumberExample: 0.15
dataobject

Status Codes

200
Success (code === 0). Charged according to the endpoint credit rate.
400
Invalid parameters, or API key placed in the URL query string (not charged).
401
Missing or invalid x-api-key header (not charged).
402
Insufficient credit balance (not charged).
403
Account disabled (not charged).
404
Unknown endpoint or disabled unstable endpoint (not charged).
405
Method not allowed — all /v1/* data endpoints use GET (not charged).
429
Rate limit exceeded (not charged). Respect the Retry-After header.
503
Temporary upstream or gateway error (not charged). Retry with exponential backoff.