TikTok Ad Library Search
Search TikTok’s ad library by keyword (top ads with brand, title, spend, CTR, likes, and video info).
Price: $2.00 per 1,000 requests (flat per request - same cost regardless of results returned).
Routing: one lane serves this API today, so a failed attempt has nowhere to fail over to. Payment outcome follows the selected rail’s settlement policy.
Catalog: TikTok Ad Library Search pricing and uptime - live USD price, lane routing, and measured 30-day uptime. Every TikTok endpoint.
Authorizations
Your AnyAPI key as a Bearer token.
Headers
Optional wallet idempotency key, scoped to this customer for 24 hours. When the gateway honors the key, this synchronous in-process execution can continue after the caller disconnects, bounded by its execution deadline. A completed replayable result charges normally exactly once and can be replayed without another provider run or charge. A pending duplicate returns 409 idempotency_in_progress; reuse with different request semantics returns 409 idempotency_conflict.
1 - 255Query Parameters
Optional. Comma-separated keys (dotted paths like author.name descend into nested objects) to keep on each result item. Keys are matched relative to each result item after the data/items envelope is unwrapped, not against the top-level response envelope, so use jq to reshape the whole envelope. Shrinks the response without changing cost.
Optional. Cap the number of result rows returned; a _truncated note reports how many were withheld so you can page via the API's own limit. Does not change cost.
x >= 0Optional. Return only a structural outline (top-level keys, item counts, and per-field byte sizes) instead of the full data. Does not change cost.
Optional. A jq expression applied to the result envelope; its output replaces output (multiple outputs collect into an array). Reshape freely, e.g. jq=.data | {title, description, md: .markdown[:3500]}. Runs sandboxed with a 250ms / 2MB budget; on failure the full result is returned with a jqError. Does not change cost.
Body
Keyword to search ad titles and content (e.g. spotify).
Ad format filter.
spark_ads, non_spark_ads Ad language filter.
en, es, ar, vi, th, de, id, pt, fr, ms, nl, ja, it, ro, zh-Hant, ko Filter to a specific advertiser by name (searches the public TikTok Ads Library by advertiser).
Page number for pagination (defaults to 1).
Video duration bucket filter.
under_10s, 10_20s, 20_30s, 30_40s, 40_50s, over_50s Advertiser industry filter.
apparel_accessories, appliances, apps, baby_kids_maternity, beauty_personal_care, business_services, ecommerce_non_app, education, financial_services, food_beverage, games, health, home_improvement, household_products, life_services, news_entertainment, pets, sports_outdoor, tech_electronics, travel, vehicle_transportation Likes percentile bucket filter (top_1_20 is the top-performing 20 percent).
top_1_20, top_21_40, top_41_60, top_61_80, top_81_100 Results per page, with an existing maximum of 50 (default 20). Use a canonical JSON integer; legacy numeric strings remain accepted.
0 <= x <= 50Campaign objective filter.
app_installs, conversions, lead_generation, product_sales, reach, traffic, video_views Sort metric: for_you, impression, play_2s_rate, play_6s_rate, cvr, ctr, or like.
Time window for top ads. Use the canonical JSON integer 7, 30, or 180; legacy numeric strings remain accepted.
7, 30, 180, 7, 30, 180 Country code (defaults to US).
Response
Normalized result.
USD charged on the original run. On a replay this value is echoed for parity; the replay itself is free.
Number of result rows returned. For per-result SKUs the per-item cost is charged against this count; for input-priced SKUs the charge is per submitted input, independent of this count.
Normalized output, or null when the replay payload was not retained.
Always "AnyAPI".
True when this response replays the durable result of an earlier run without billing or upstream execution.
Optional one-line nudge, absent when there is nothing to say. large_result: suggests the fields/max_items/summary/jq controls for a big response. paging_unavailable: means this result came from a source that cannot return a nextCursor, so it may be INCOMPLETE and cannot be continued - re-run with requireCursor: true to be served only by a source that can page, which may cost more per request.
Present only when a jq expression failed; output then carries the full unshaped result and this explains why the reshape did not apply.
Opaque handle to the full unshaped result, cached ~15 min. Re-shape it for free (fields/max_items/summary/jq) via GET /v1/results/{id}, no re-billing. Absent when the result was too large to cache.