TikTok Top Ads Search

From AnyAPI, through Joshu Data Bodega.

Price: $0.00132 per call$1.32 per 1,000 calls

No calls measured in the last 30 days.

Prices include the router's 10% markup and are paid from the usage wallet. Checked on November 11, 2026.

Inputs

jqstring, optional
jq expression over the result envelope; its output replaces `output`. A failed expression returns the full result with `jqError`.
pageinteger, optional
One-based provider page number (default 1).
limitinteger, optional
Maximum number of ads requested for this page, from 1 through 20 (default 20).
querystring, required
Keyword to search in TikTok Creative Center top video ads.
fieldsstring, optional
Comma-separated keys (dotted paths descend) to keep on each result item. Trims the response, not the charge.
periodinteger: 7, 30, 180, optional
Lookback period in days (default 180).
regionstring, optional
Country code used to select the Creative Center market (default US).
orderBystring: for_you, likes, optional
Result ordering: Creative Center recommendations or like count (default for_you).
summaryboolean, optional
`true` returns only an outline: keys, item counts, per-field sizes.
max_itemsinteger, optional
Caps the result rows returned; `_truncated` says how many were withheld. Not the charge.
objectivestring: traffic, app_installs, conversions, video_views, reach, lead_generation, product_sales, optional
Campaign objective filter (default traffic).
adLanguagestring: en, es, ar, vi, th, de, id, pt, fr, ms, nl, ja, it, ro, zh-Hant, ko, optional
Language code for returned ads (default en).
performanceRankstring: top_1_20, top_21_40, top_41_60, top_61_80, optional
Ad performance percentile bucket, where top_1_20 is the highest-performing 20 percent (default top_1_20).

Call it

curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "anyapi.tiktok.top_ads_search",
    "params": {
      "query": "glasses"
    }
  }'