UnifAPI Docs

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.

GET
/tiktok/ads/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Path Parameters

id*string
Match^\d+$

Header Parameters

Unifapi-Version?"2026-07-01"

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

Default"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  }}