TikTok

TikTok Ad Detail

Get full detail for a single TikTok ad by its id - title, brand, campaign objective, engagement (likes, comments, shares), the countries it ran in, its landing page and a playable video. Costs 1 credit per call.

POST/api/v1/tiktok/ads/detail

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

ad_idstringrequired

The ad's numeric id, as carried by every search result.

Example: 7361015644840312839

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.tiktok.ads_detail(ad_id="7361015644840312839")
print(results)

Response

"ad_id": "7361015644840312839",

"title": "Busy routine mein bhi fitness possible hai.FitFlex app subscribe karo aur ghar par workout karo.",

"brand": "Fitflex App",

"industry_key": "label_20109000000",

"objective_key": "campaign_objective_conversion",

"objective": "conversion",

"ctr": 0.84,

"likes": 269,

"comments": 1,

"shares": 1,

"favorites": false,

"is_search": false,

"keywords": null,

"landing_page": "https://services.jazz.com.pk/signin/FitFlex?ref=6&var=1&camp=FitFlex_Default&utm_source=tiktok&utm_id=__CAMPAIGN_ID__&utm_campaign=__CAMPAIGN_NAME__&utm_medium=paid",

"highlight_text": null,

"source": "TikTok Ads Manager",

"response_time": 1262,

"credits_used": 1,

"credits_remaining": 4570

}