Get a top TikTok ad by ID
Returns a TikTok Creative Center top ad by its numeric ID, with engagement counts, the regions it ran in, keywords, landing page, and creative video.
Pricing — $ · min $0.001
Billed per record at 1 credit ($0.001) each, with a 1-credit ($0.001) minimum per call.
Authorization
bearerAuth UnifAPI API key. Provider credentials are managed by UnifAPI.
In: header
Path Parameters
^\d+$Header Parameters
Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md
"2026-07-01"Value in
- "2026-07-01"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/tiktok/ads/string"{ "request_id": "string", "data": { "id": "string", "title": "string", "brand_name": "string", "industry_key": "string", "objective_key": "string", "ctr": 0, "like_count": 0, "comment_count": 0, "share_count": 0, "budget_level": 0, "country_codes": [ "string" ], "keywords": [ "string" ], "landing_page_url": "string", "source": "string", "video": { "id": "string", "duration": 0, "cover_image_url": "string", "play_url": "string", "width": 0, "height": 0 } }, "billing": { "credits_charged": 0, "records_charged": 0, "balance_remaining": 0, "truncated_due_to_balance": true }}