Endpoint Playground
Returns high-performing auction ads from TikTok Creative Center. The service defaults `period` to 30, `page` to 1, `limit` to 20, and `order_by` to `for_you`. Use `/tiktok/top-ads/filters` for dynamic enum values and static enums for order, duration, likes, and ad format.
14 Oct 2026: 1 data.materials; 10 fields had a value in every checked item.
Sample value profiles: favorite: true in 0 of 1; is_search: true in 1 of 1.
curl "https://api.crawlora.net/api/v1/tiktok/top-ads/list?period=7&page=1&limit=10&order_by=for_you&country_code=US&duration=time-2&like=1&ad_format=1" \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| period | integer | No | 7 | Lookback period in days |
| page | integer | No | 1 | Page number |
| limit | integer | No | 10 | Maximum number of ads to return |
| order_by | string | No | for_you | Sort order |
| country_code | string | No | US | Country code or comma-separated country codes from /tiktok/top-ads/filters |
| keyword | string | No | Brand or product keyword search | |
| industry | string | No | Industry filter id or comma-separated ids from /tiktok/top-ads/filters | |
| objective | string | No | Objective filter id or comma-separated ids from /tiktok/top-ads/filters | |
| ad_language | string | No | Ad language id or comma-separated ids from /tiktok/top-ads/filters | |
| pattern_label | string | No | Pattern label id or comma-separated ids from /tiktok/top-ads/filters | |
| duration | string | No | time-2 | Video duration bucket |
| like | string | No | 1 | Like percentile bucket id or comma-separated ids |
| ad_format | string | No | 1 | Ad format id |
{
"code": 200,
"msg": "OK",
"data": {
"code": 0,
"msg": "OK",
"data": {
"materials": [
{
"id": "7631130810943897607",
"ad_title": "Example ad",
"like": 120,
"ctr": 0.42
}
],
"pagination": {
"has_more": true,
"page": 1,
"size": 20,
"total_count": 381
}
}
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.