POST
TikTok Top ads search API
/v1/run/tiktok.top_ads_search
Search TikTok Creative Center top video ads by keyword with explicit performance, objective, region, language, and time-window filters.
- Category SocialRequests / mo 117Routing 1 lane · no failover
Pricing
One price, in dollars
pay per request · no subscription · fallbacks added as the catalog growsRequest
Gateway request
discovered operation
Router
↓
↳ One lane serves this endpoint today, so a failed call has nowhere to fail over to. Failed attempts are never billed. Uptime, latency and traffic are measured through the gateway, last 30 days.
Try it
Make your first request
run it free, no key · same shape for every APISample response
Free runs return only the first 3 results. Fund a key to get the full response.
{
"data": {
"ads": [
{
"adId": "a1b2c3d4",
"adTitle": "Example title",
"brandName": "Acme Inc",
"cost": 19.99,
"ctr": 12.5,
"durationSeconds": 12.5,
"height": 42,
"image": "https://example.com/image.jpg",
"industry": "general",
"likes": 12500,
"objective": "example",
"videoUrl": "https://example.com/page",
"width": 1024
}
],
"hasMore": true,
"page": 29,
"pageSize": 29,
"total": 12500
},
"found": true
}Response interface
interface TiktokTopAdsSearchResponse {
data: {
ads: {
adId: string;
adTitle?: string;
brandName?: string;
cost?: number;
ctr?: number;
durationSeconds?: number;
height?: number;
image?: string;
industry?: string;
likes?: number;
objective?: string;
videoUrl?: string;
width?: number;
}[];
hasMore: boolean;
page: number;
pageSize: number;
total: number;
} | null;
found: boolean;
}Full parameter and response reference - every field, type, and example for this endpoint.
Reference
Request, response, and price
Last verified 2026-08-23 · uptime and latency measured over 30dPOST /v1/run/tiktok.top_ads_search
curl -X POST https://api.getanyapi.com/v1/run/tiktok.top_ads_search \
-H "Authorization: Bearer $ANYAPI_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"glasses"}'| Field | Type | Example value |
|---|---|---|
| Request body | ||
| query | string | "glasses"Keyword to search in TikTok Creative Center top video ads. |
| adLanguage | enum | Language code for returned ads (default en). |
| limit | integer | Maximum number of ads requested for this page, from 1 through 20 (default 20). |
| objective | enum | Campaign objective filter (default traffic). |
| orderBy | enum | Result ordering: Creative Center recommendations or like count (default for_you). |
| page | integer | One-based provider page number (default 1). |
| performanceRank | enum | Ad performance percentile bucket, where top_1_20 is the highest-performing 20 percent (default top_1_20). |
| period | enum | Lookback period in days (default 180). |
| region | string | Country code used to select the Creative Center market (default US). |
| Response | ||
| data | object | Top-ad results and page metadata, or null when no matching ads were found. |
| data.ads | object[] | TikTok Creative Center top-ad records returned for this page. Populated whenever the provider has data for the entity. |
| data.ads[].adId | string | TikTok Creative Center ad material identifier. Populated whenever the provider has data for the entity. |
| data.ads[].adTitle | string | Title or primary copy shown for the ad. Populated whenever the provider has data for the entity. |
| data.ads[].brandName | string | Advertiser brand name when supplied by TikTok Creative Center. Populated whenever the provider has data for the entity. |
| data.ads[].cost | number | TikTok Creative Center's relative cost ranking value for the ad. Populated whenever the provider has data for the entity. |
| data.ads[].ctr | number | TikTok Creative Center's click-through rate value for the ad. Populated whenever the provider has data for the entity. |
| data.ads[].durationSeconds | number | Video duration in seconds. Populated whenever the provider has data for the entity. |
| data.ads[].height | integer | Video height in pixels. Populated whenever the provider has data for the entity. |
| data.ads[].image | string | Signed video cover image URL exactly as returned by TikTok Creative Center. Populated whenever the provider has data for the entity. |
| data.ads[].industry | string | TikTok Creative Center industry classification key. Populated whenever the provider has data for the entity. |
| data.ads[].likes | integer | Number of likes reported for the ad. Populated whenever the provider has data for the entity. |
| data.ads[].objective | string | TikTok Creative Center campaign objective key. Populated whenever the provider has data for the entity. |
| data.ads[].videoUrl | string | Signed 720p video asset URL exactly as returned by TikTok Creative Center. Populated whenever the provider has data for the entity. |
| data.ads[].width | integer | Video width in pixels. Populated whenever the provider has data for the entity. |
| data.hasMore | boolean | Whether TikTok Creative Center reports another page of matching ads. Populated whenever the provider has data for the entity. |
| data.page | integer | One-based page number reported by TikTok Creative Center. Populated whenever the provider has data for the entity. |
| data.pageSize | integer | Page size reported by TikTok Creative Center. Populated whenever the provider has data for the entity. |
| data.total | integer | Total number of matching top ads reported by TikTok Creative Center. Populated whenever the provider has data for the entity. |
| found | boolean | True when TikTok Creative Center returned at least one matching top ad. |
| Price | ||
| Price per request | USD | $0.0012 |
| Price /1k req | USD | $1.20 |
FAQ
About the TikTok Top ads search API
The AnyAPI TikTok Top ads search API returns TikTok top ads search data as normalized JSON from one POST call to /v1/run/tiktok.top_ads_search. Search TikTok Creative Center top video ads by keyword with explicit performance, objective, region, language, and time-window filters. AnyAPI returns one normalized schema whichever source serves it. It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of TikTok top ads search calls through AnyAPI succeeded, with a median response time of 1.0 seconds across 117 measured calls.
It costs from $1.20 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet, each call draws it down, and a failed request costs $0.
Search TikTok Creative Center top video ads by keyword with explicit performance, objective, region, language, and time-window filters. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.
Over the last 30 days, 100.0% of TikTok top ads search calls through AnyAPI succeeded, with a median response time of 1.0 seconds across 117 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.
More to call
Other TikTok endpoints
Profile · from $0.90 /1k reqProfile videos · from $1.20 /1k reqVideo transcript · from $2.00 /1k reqKeyword search · from $1.20 /1k reqVideo · from $0.90 /1k reqVideo comments · from $1.44 /1k reqUser search · from $1.20 /1k reqAd library ad · from $1.20 /1k reqAd library search · from $2.00 /1k reqAd transparency search · from $0.90 /1k reqAudience demographics · from $18.00 /1k reqComment replies · from $2.00 /1k reqFollowers · from $2.00 /1k reqFollowing · from $2.00 /1k reqHashtag videos · from $1.44 /1k reqLive · from $2.00 /1k reqProfile region · from $2.00 /1k reqSearch hashtag · from $2.00 /1k reqSearch top · from $2.00 /1k reqSong · from $2.00 /1k reqSong videos · from $2.00 /1k reqTrending feed · from $2.00 /1k reqTrending hashtags · from $1.20 /1k reqVideo transcript full · from $17.60 /1k req
Get started
Two ways to start on AnyAPI
Humans fund a USD wallet and pay per request. Agents point a coding agent at one URL and onboard themselves.
Works with
Terminal agentsClaude CodeCursorCodexMCP clients