TikTok API endpoint
Returns Top Ads search suggestions from TikTok Creative Center. `count` is the maximum number of suggestions (default 50) and `scenario` picks the suggestion scenario id (default 1). The `query` list can be empty for the default scenario.
/tiktok/top-ads/suggestionsQuery parameters:
count: optional. Maximum number of suggestions to return. Default: 50.scenario: optional. Suggestion scenario id. Default: 1.Notable response behavior:
| Field | In the sample |
|---|---|
| code | Has a value |
| msg | Has a value |
| request_id | Has a value |
| data.query | Empty |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| x-api-key (header) | string | Yes | API key required | ||
| count | integer | No | Maximum number of suggestions to return | ||
| scenario | integer | No | Suggestion scenario id |
curl -X GET "https://api.crawlora.net/api/v1/tiktok/top-ads/suggestions?count=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"code": 0,
"msg": "OK",
"data": {
"query": []
}
}
}Request schema
No body schema
Response schema
#/definitions/populartrend.topAdsSuggestionsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | popularTrend.TopAdsSuggestionsResp | No | ||||
| data.code | integer | No | ||||
| data.data | object | No | Suggested search queries for top ads. | |||
| data.data.query | array | 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/suggestions?count=10" \
-H "x-api-key: $CRAWLORA_API_KEY"