tiktok/ads/search-ads
Search ads in TikTok's Creative Center with multi-dimensional filtering and sorting Discover effective ad cases related to specific industries, keywords, or objectives Provide reference and inspiration for ad planning an...
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/search-adsInput Schema
12 parameters · 0 required · 12 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
like | integer | Optional | Like count filter, 1=All |
page | integer | Optional | Page number, default 1 |
limit | integer | Optional | Items per page, default 20, max 50 |
period | integer | Optional | Time period in days, e.g., 7, 30, 120, 180 days |
keyword | string | Optional | Search keyword, optional, returns all ads if empty |
industry | string | Optional | Industry ID list, multiple IDs separated by commas. Full industry ID list: https://github.com/TikHub/TikTok-Ads-Industry-Code |
order_by | string | Optional | Sort method, "for_you"=Recommended, "likes"=Sort by likes |
ad_format | integer | Optional | Ad format, 1=Video ads |
objective | integer | Optional | Ad objective, 1=All |
search_id | string | Optional | Search ID (optional) |
ad_language | string | Optional | Ad language code, e.g., en, zh |
country_code | string | Optional | Country code, e.g., US, UK, JP |
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/search-ads",
"prompt": "a beautiful sunset over mountains"
}'API README
Search ads
Search ads in TikTok's Creative Center with multi-dimensional filtering and sorting Discover effective ad cases related to specific industries, keywords, or objectives Provide reference and inspiration for ad planning and creative production. It is suitable for tiktok workflows.
Capability
Search ads in TikTok's Creative Center with multi-dimensional filtering and sorting Discover effective ad cases related to specific industries, keywords, or objectives Provide reference and inspiration for ad planning and creative production. 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.