TikTok Scraper
Get TikTok Ad Library Ad Library Ad
Fetches one TikTok ad by ID or URL. It first checks Creative Center Top Ads (ads.tiktok.com), then TikTok's public transparency Ads Library (library.tiktok.com) when the ID is not a Top Ads material. Both sources return the same response shape. Fields TikTok does not expose for a public Ads Library ad are null, empty, or false as appropriate.
1 creditNo API key neededEndpoint
Parameters
| Name | Type | Required | Note |
|---|---|---|---|
| ad_idstring · required | string | required | Creative Center Top Ads material ID or URL, or a public Ads Library ad ID or library.tiktok.com detail URL. |
Response schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"type": "string"
},
"ctr": {
"type": "number"
},
"cost": {
"type": "number"
},
"like": {
"type": "number"
},
"share": {
"type": "number"
},
"source": {
"type": "string"
},
"comment": {
"type": "number"
},
"ad_title": {
"type": "string"
},
"favorite": {
"type": "boolean"
},
"is_search": {
"type": "boolean"
},
"brand_name": {
"type": "string"
},
"objectives": {
"type": "array"
},
"source_key": {
"type": "number"
},
"video_info": {
"type": "object",
"additionalProperties": {}
},
"voice_over": {
"type": "boolean"
},
"has_summary": {
"type": "boolean"
},
"country_code": {
"type": "array"
},
"industry_key": {
"type": "string"
},
"keyword_list": {},
"landing_page": {
"type": "string"
},
"objective_key": {
"type": "string"
},
"pattern_label": {
"type": "array"
},
"highlight_text": {
"type": "string"
},
"detail_analysis": {},
"creative_center_url": {
"type": "string"
},
"recommended_for_you": {
"type": "array"
},
"interactive_time_analysis": {
"type": "object",
"additionalProperties": {}
}
},
"additionalProperties": true
}
