Endpoint Playground
Test Crawlora's Retrieve TikTok Top Ads API with realistic prefilled parameters. Generate a cURL request, inspect the expected structured JSON response, and open the full docs or pricing page when you are ready to integrate this public web data extraction endpoint into your application.
curl "https://api.crawlora.net/api/v1/tiktok/top-ads/list?period=7&page=1&limit=10&order_by=for_you&country_code=US&keyword=coffee&industry=23118000000&objective=3&ad_language=en&pattern_label=10100100000&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 | coffee | Brand or product keyword search |
| industry | string | No | 23118000000 | Industry filter id or comma-separated ids from /tiktok/top-ads/filters |
| objective | string | No | 3 | Objective filter id or comma-separated ids from /tiktok/top-ads/filters |
| ad_language | string | No | en | Ad language id or comma-separated ids from /tiktok/top-ads/filters |
| pattern_label | string | No | 10100100000 | 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
}
}
}
}Public Playground
Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.
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.
{
"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
}
}
}
}curl "https://api.crawlora.net/api/v1/tiktok/top-ads/list" \
-H "x-api-key: $CRAWLORA_API_KEY"