tiktok/ads/query-suggestions
Get popular query suggestions for ad search Understand current popular ad search keywords and trends Help discover new creative directions and hot topics.
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runtiktok/ads/query-suggestionsInput Schema
4 parameters · 0 required · 4 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
count | integer | Optional | Number of suggestions to return, default 50 |
query | string | Optional | Input keyword (optional), returns suggestions based on input; popular ones if omitted |
scenario | integer | Optional | Scenario type, default 1 |
country_code | string | Optional | Country code, default US |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Code Examples
Ready-to-run snippets
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "tiktok/ads/query-suggestions",
"prompt": "a beautiful sunset over mountains"
}'API README
Get query suggestions
Get popular query suggestions for ad search Understand current popular ad search keywords and trends Help discover new creative directions and hot topics. It is suitable for tiktok workflows.
Capability
Get popular query suggestions for ad search Understand current popular ad search keywords and trends Help discover new creative directions and hot topics. It helps applications, agents, and automated workflows turn that capability into repeatable tasks and useful downstream experiences.
Common use cases
- Search and discover relevant records for research, monitoring, and product experiences.
- Create repeatable integrations that pass structured results to downstream business systems.
- Support scheduled jobs, internal tools, and agent workflows with structured results.