Search TikTok ads

From TikHub, through Joshu Data Bodega.

Price: $0.0011 per call$1.10 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

likeinteger, optional
表现排名/Performance rank (1:前1-20% 2:前21-40% 3:前41-60% 4:前61-80%)
pageinteger, optional
Page number
limitinteger, optional
Items per page. Default 20. Prefer limit ≤ 20 — live Creative Center validation has rejected values above 20 (30/50) even though some OpenAPI text says max 50.
periodinteger, optional
Time period in days. Allowed values 7 | 30 | 120 | 180 (TikHub OpenAPI: e.g. 7, 30, 120, 180 days). Other integers fail Creative Center nested validation.
keywordstring, optional
Search keyword
industrystring, optional
Industry ID
order_bystring, optional
Sort by (for_you, likes)
ad_formatinteger, optional
广告格式/Ad format (1:视频)
objectiveinteger, optional
广告目标类型/Ad objective (1:流量 2:应用安装 3:转化 4:视频浏览 5:触达 6:潜在客户 7:产品销售)
search_idstring, optional
Search ID (optional)
ad_languagestring, optional
Ad language
country_codestring, optional
Country code. May not always filter results the way agents expect (some codes, e.g. PH, have been observed appearing ignored).

Call it

curl https://hello.joshu.me/api/router/call \
  -H "Authorization: Bearer $JOSHU_ROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "tikhub.x.tiktok-ads-search-ads",
    "params": {
      "limit": 5
    }
  }'