1. TikTok Commercial Ads & Creative Center Endpoints
TikTokAPI.io exposes three specialized endpoints for ad intelligence, dropshipping product research, and creative spy workflows:
| Endpoint | Compatible Alias | Key Parameters | Primary Use Case |
|---|---|---|---|
| GET /v1/ads/search | GET /v1/ads/top/ads | keyword, country_code (US), period (7|30|180), sort_by (impression|like), page, limit | Find top-performing video ads for any niche, product, or brand keyword |
| GET /v1/ads/detail | GET /v1/ads/top/ads/detail | ad_id (or ads_id) | Inspect full creative telemetry, landing page link, and engagement curve for a specific ad |
| GET /v1/ads/keywords | GET /v1/ads/top/keywords | country_code (US), period (7|30), page, limit | Extract trending commercial keywords, ad volume, and impression share by region |
2. Search Winning E-Commerce & App Ads by Keyword
Pass any product keyword (such as 'bracelet', 'portable blender', or 'fitness app'), country code, and lookback period to retrieve active commercial video ads:
Search Top TikTok Commercial Ads & Extract Landing Pages
Queries US commercial ads over the past 7 days sorted by impression volume and extracts the ad MP4 + destination store URL.
curl -sS "https://api.tiktokapi.io/v1/ads/search?keyword=bracelet&country_code=US&period=7&sort_by=impression&page=1&limit=20" \
-H "x-api-key: tk_your_api_key_here"3. Inspect Ad Detail & Trending Commercial Keywords
Once you identify a high-performing ad ID from /v1/ads/search, call GET /v1/ads/detail?ad_id={id} for full creative metadata, or poll GET /v1/ads/keywords to track rising ad keywords in any country:
- Deep Creative Inspection (GET /v1/ads/detail): Pass ad_id=7693646147554885640 to retrieve the full advertiser profile, objective type (Traffic, Conversions, App Install), video resolution streams, and regional targeting list.
- Commercial Keyword Discovery (GET /v1/ads/keywords): Pass country_code=US&period=7 to receive ranked commercial keywords with ad_count and total_likes, ideal for automated e-commerce trend dashboards.
Frequently Asked Questions
- Does the Official TikTok Commercial Content API require special approval?
- Yes. ByteDance's official Commercial Content API is restricted to approved researchers and EU Digital Services Act (DSA) compliance partners. TikTokAPI.io provides instant key-based access to global Creative Center ad intelligence with zero approval wait time.
- How many credits does TikTok Ads search cost?
- Commercial Ads endpoints (/v1/ads/search, /v1/ads/detail, /v1/ads/keywords) cost 10 Credits ($0.001) per item or detail lookup, and 0 Credits on any empty or failed response.
- Which countries are supported in country_code?
- Over 60 two-letter ISO country codes are supported, including US, GB, CA, AU, DE, FR, ES, IT, BR, MX, JP, KR, SG, ID, TH, VN, MY, PH, AE, and SA.