TikTok API endpoint
Returns TikTok's inferred initial country and industry targeting context for Top Ads. Use it when you need starting targeting values; use the locations, filters, and list endpoints to choose criteria and retrieve ads.
/tiktok/top-ads/location-infoQuery parameters:
module: optional upstream Creative Center module identifier. Omitted or 0 defaults to 1; other nonzero IDs are passed through to TikTok without local range validation. TikTok's public Top Ads help does not enumerate valid IDs.Notable response behavior:
initial_country reflects TikTok's inferred starting country; l1_industry and l2_industry are the current first- and second-level industry IDs.first_industry and second_industry include industry metadata when TikTok returns it.tiktok_top_ads_location_info when you need TikTok's inferred starting country and industry; use tiktok_top_ads_locations instead to choose from available countries.tiktok_top_ads_filters to choose explicit filter IDs, then tiktok_top_ads_list to retrieve matching ads.| Field | In the sample | Value in the sample |
|---|---|---|
| code | Has a value | |
| msg | Has a value | |
| request_id | Has a value | |
| data.first_industry | Empty | |
| data.initial_country | Has a value | 1 entry |
| data.l1_industry | Has a value | 0 |
| data.l2_industry | Has a value | 0 |
| data.second_industry | Empty |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required | ||
| module | integer | No | 1 | Optional upstream Creative Center module identifier; omitted or 0 defaults to 1, other nonzero IDs are passed through without local range validation |
curl -X GET "https://api.crawlora.net/api/v1/tiktok/top-ads/location-info" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"code": 0,
"msg": "OK",
"data": {
"initial_country": [
"US"
],
"l1_industry": 0,
"l2_industry": 0
}
}
}Request schema
No body schema
Response schema
#/definitions/populartrend.topAdsLocationInfoResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | popularTrend.TopAdsLocationInfoResp | No | ||||
| data.code | integer | No | ||||
| data.data | object | No | Initial country and industry targeting that TikTok Creative Center infers. | |||
| data.data.first_industry | object | No | ||||
| data.data.initial_country | array | No | ||||
| data.data.l1_industry | integer | No | ||||
| data.data.l2_industry | integer | No | ||||
| data.data.second_industry | object | No | ||||
| data.msg | string | No | ||||
| data.request_id | string | No | Request id returned by TikTok Creative Center. | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Invalid input | #/definitions/app.Response |
| 429 | Rate limit exceeded | #/definitions/app.Response |
| 500 | Internal server error | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/tiktok/top-ads/location-info" \
-H "x-api-key: $CRAWLORA_API_KEY"