TikTok API
Challenge Info
Get details about a TikTok challenge (hashtag challenge).
POST
$0.01/call/v1/tiktok/challengeUsage
const res = await fetch('https://api.yepapi.com/v1/tiktok/challenge', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ challenge_name: 'dancechallenge' }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/tiktok/challenge \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"challenge_name": "dancechallenge"}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
challenge_name | string | Yes* | Challenge hashtag name (without #) | — |
challenge_id | string | Yes* | Challenge ID (alternative to name) | — |
*Provide either challenge_name or challenge_id.
Response
{
"ok": true,
"data": {
"challenge_id": "1677534536829953",
"challenge_name": "dancechallenge",
"description": "Show us your best moves! Join the dance challenge.",
"video_count": 48500000,
"view_count": 125000000000,
"cover": "https://p16-sign.tiktokcdn.com/...",
"is_commercial": false
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.challenge_id | string | Unique challenge identifier |
data.challenge_name | string | Challenge hashtag name |
data.description | string | Challenge description text |
data.video_count | number | Number of videos using this challenge |
data.view_count | number | Total views across all challenge videos |
data.cover | string | Challenge cover image URL |
data.is_commercial | boolean | Whether this is a sponsored/commercial challenge |