Get TikTok Ads Library ad details | TikTok Ads Library API

Returns one public Ads Library ad with its media, advertiser, run dates, impressions, and targeting where available. Requires ad_id from a search result; lang sets the label language.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

ad_id*string

Numeric ad id from a /search result or from an Ads Library ad-detail URL. Keep it as a string.

Match^\d+$

Lengthlength <= 40

lang?string

Locale used for translated region and display labels. Defaults to en-GB.

Default"en-GB"

Value in

"bg-BG"
"cs-CZ"
"da-DK"
"de-DE"
"el-GR"
"en-GB"
"en-US"
"es-ES"
"et-EE"
"fi-FI"
"fr-FR"
"hr-HR"
"hu-HU"
"it-IT"
"lt-LT"
"lv-LV"
"nb-NO"
"nl-NL"
"pl-PL"
"pt-PT"
"ro-RO"
"sk-SK"
"sl-SI"
"sv-SE"

curl -X GET "https://example.com/v1/tiktok-ads/ads/detail?ad_id=1871327475870130" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "property1": null,    "property2": null  }}