TIKTOK AD LIBRARY API
Ad Library Ad
Retrieve ad library ad from TikTok Ad Library with a single API request.
GET
/api/data/v1/tiktok/ad-library/ad1credit base cost
Request parameters
Up to 1 creditCreative Center Top Ads material ID or URL, or a public Ads Library ad ID or library.tiktok.com detail URL.
Live requests use your prepaid balance. Cached responses cost zero where supported.
curl --request GET \
--url 'https://fetchgoblin.com/api/data/v1/tiktok/ad-library/ad?ad_id=1869335220395266' \
--header 'x-api-key: YOUR_FETCHGOBLIN_API_KEY'Response
Example{
"success": true,
"ad_title": "I thought this was a gimmick until I tried it! A wrinkled shirt, one button, and a few minutes later... ready to wear. Tap the link in bio and see why everyone’s talking about Bellairon before it sells out. @Bellairon LLC ",
"brand_name": "",
"comment": 1,
"cost": 1,
"country_code": [
"TR"
],
"ctr": 0.5,
"favorite": false,
"has_summary": false,
"highlight_text": "",
"id": "7646829987799334920",
"industry_key": "label_22108000000",
"is_search": false,
"keyword_list": null,
"landing_page": "https://www.amazon.com/dp/B0DRTC8XBW?ref=cm_sw_r_cso_wa_apin_dp_71W8F02XC4M4QZRQ5RQN&ref_=cm_sw_r_cso_wa_apin_dp_71W8F02XC4M4QZRQ5RQN&social_share=cm_sw_r_cso_wa_apin_dp_71W8F02XC4M4QZRQ5RQN&oas=true&utm_source=tiktok&utm_medium=paid&utm_id=__CAMPAIGN_ID__&utm_campaign=__CAMPAIGN_NAME__",
"like": 92,
"objective_key": "campaign_objective_reach",
"objectives": [
{
"label": "campaign_objective_reach",
"value": 5
}
],
"pattern_label": [],
"share": 1,
"source": "Others",
"source_key": 73,
"video_info": {
"vid": "v12044gd0000d8erq07og65h1cq991gg",
"duration": 89.767,
"cover": "https://p16-common-sign.tiktokcdn.com/tos-maliva-p-0068c799-us/oIbqBdvfEAiFpgvAOgrQHCF5R0mkDDLiEfvQDS~tplv-noop.image?dr=18692&refresh_token=2cdb79e2&x-expires=1781231880&x-signature=W%2BBTq1VGRRaNnIuMGUpWWSgmOoo%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v12044gd0000d8erq07og65h1cq991gg",
"video_url": {
"540p": "https://v16m-default.tiktokcdn.com/3e7ec770348dbc627fc02ea1e8417c25/6a2b7108/video/tos/maliva/tos-maliva-ve-0068c799-us/oIN2GPIRgHAUBHOeNfLk2HBSERoJeIALGC3jAE/?a=0&bti=NTU4QDM1NGA%3D&&bt=315&ft=cApXJCz7ThWHKnz9LGZmo0P&mime_type=video_mp4&rc=Omk6ZWQ7Nzc7OGY8PGVnOkBpajQ8Zms5cjN1OzMzZzczNEBgNDAzXl9hXjMxLzEvXjFiYSNkNm4uMmQ0bmJhLS1kMS9zcw%3D%3D&vvpl=1&l=20260612043631BE40574FD5FFAA863321&btag=e00090000",
"720p": "https://v16m-default.tiktokcdn.com/9f16ea869602069b9fdad27dc113cb48/6a2b7108/video/tos/maliva/tos-maliva-ve-0068c799-us/ooEipQa9HbhJ4ChzASIngUPhBAdXiABIvxU2E/?a=0&bti=NTU4QDM1NGA%3D&&bt=877&ft=cApXJCz7ThWHKnz9LGZmo0P&mime_type=video_mp4&rc=ZTg3OTQ0NTQzZGVpNWg6NkBpajQ8Zms5cjN1OzMzZzczNEBhNC0yMDViNi8xLV9hX2AuYSNkNm4uMmQ0bmJhLS1kMS9zcw%3D%3D&vvpl=1&l=20260612043631BE40574FD5FFAA863321&btag=e00090000"
},
"width": 720,
"height": 1280
},
"voice_over": false,
"creative_center_url": "https://ads.tiktok.com/business/creativecenter/topads/7646829987799334920/pc/en",
"detail_analysis": null,
"interactive_time_analysis": {
"ctr": {
"metric": "retain_ctr",
"analysis": [
{
"second": 0,
"value": 0.048321828136158054
}
],
"duration": 91,
"highlight": [
1
],
"percentile": 0.99
},
"cvr": {
"metric": "retain_cvr",
"analysis": [
{
"second": 0,
"value": 0
}
],
"duration": 91,
"highlight": [],
"percentile": 0.99
},
"clicks": {
"metric": "click_cnt",
"analysis": [
{
"second": 0,
"value": 0.2631578947368421
}
],
"duration": 91,
"highlight": [
1
],
"percentile": 0.99
},
"conversion": {
"metric": "convert_cnt",
"analysis": [
{
"second": 0,
"value": 0
}
],
"duration": 91,
"highlight": [],
"percentile": 0.99
},
"remain": {
"metric": "play_retain_cnt",
"analysis": [
{
"second": 0,
"value": 1
}
],
"duration": 91,
"highlight": [],
"percentile": 0.99
}
},
"recommended_for_you": [
{
"ad_title": "Adımlarınıza eğlence katmaya hazır mısınız? \"Hiç böyle çorap görmüş müydünüz?\" diyoruz ve iddiamızı ortaya koyuyoruz! Giyimkent Outlet İndirim Çadırı'nda çorap modasına yepyeni bir boyut getirdik. Sevdiğiniz popüler kültür ve kült anime karakterlerini, kolları hareket edebilen bu özel 3 boyutlu tasarım çoraplarla tarzınıza taşıyın. İster günlük kombinlerinize eğlenceli bir dokunuş yapın, ister arkadaşlarınıza tebessüm ettirecek harika bir hediye seçin. Videomuzdaki gibi ister halay çektirin, ister horon teptirin; seçim sizin! Bu benzersiz ve eğlenceli tasarım çoraplarda dev fırsat: 2 Adet Sadece 100 TL! Favori karakterleriniz tükenmeden sizleri de Esenler'deki Giyimkent Outlet indirim çad",
"brand_name": "",
"cost": 0,
"ctr": 0.63,
"favorite": false,
"id": "7644102379697602567",
"industry_key": "label_22108000000",
"is_search": false,
"like": 127,
"objective_key": "campaign_objective_reach",
"video_info": {
"vid": "v1c044g50000d86qrfnog65v7nuvf30g",
"duration": 13.213,
"cover": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0037/ogCtJD4GUCr8GavLIfI1jAQ9IDvNeGEAfjQgg9~tplv-noop.image?dr=18692&refresh_token=fc9b28a3&x-expires=1781231805&x-signature=zYq%2F3BQnXoM8CMFBFKDON6lhPBs%3D&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=317596d8&idc=my&VideoID=v1c044g50000d86qrfnog65v7nuvf30g",
"video_url": {
"720p": "https://v16m-default.tiktokcdn.com/1342656e028b133716a1e892a89e214a/6a2b70bd/video/tos/alisg/tos-alisg-pve-0037c001/os3NtUfeIHH1ALjc3Q4IWADrx9BGCBG8IEgejj/?a=0&bti=NTU4QDM1NGA%3D&&bt=837&ft=cApXJCz7ThWHanz9LGZmo0P&mime_type=video_mp4&rc=ZDY4NTppZjg4ZWY6Nzc2NEBpajZ5cXk5cml0OzMzODczNEAwYi41YWMwNWMxYGEyM2IyYSMtY3I0MmRrbzNhLS1kMWBzcw%3D%3D&vvpl=1&l=20260612043632D3452D043274878B2384&btag=e000b0000"
},
"width": 576,
"height": 1024
}
}
],
"credits_charged": 1,
"credits_remaining": 1000,
"request_id": "00000000-0000-4000-8000-000000000000"
}Example data from the API specification. Run a request to retrieve current data.
Response shape
This schema describes the documented data shape. Some platform fields may be absent or null. The response also includes your FetchGoblin request ID and current credit balance.
View JSON Schema +
{
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"ad_title": {
"type": "string"
},
"brand_name": {
"type": "string"
},
"comment": {
"type": "integer"
},
"cost": {
"type": "integer"
},
"country_code": {
"type": "array",
"items": {
"type": "string"
}
},
"ctr": {
"type": "number"
},
"favorite": {
"type": "boolean"
},
"has_summary": {
"type": "boolean"
},
"highlight_text": {
"type": "string"
},
"id": {
"type": "string"
},
"industry_key": {
"type": "string"
},
"is_search": {
"type": "boolean"
},
"keyword_list": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"landing_page": {
"type": "string"
},
"like": {
"type": "integer"
},
"objective_key": {
"type": "string"
},
"objectives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {
"type": "integer"
}
}
}
},
"pattern_label": {
"type": "array"
},
"share": {
"type": "integer"
},
"source": {
"type": "string"
},
"source_key": {
"type": "integer"
},
"video_info": {
"type": "object",
"properties": {
"vid": {
"type": "string"
},
"duration": {
"type": "number"
},
"cover": {
"type": "string"
},
"video_url": {
"type": "object",
"properties": {
"540p": {
"type": "string"
},
"720p": {
"type": "string"
}
}
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
}
}
},
"voice_over": {
"type": "boolean"
},
"creative_center_url": {
"type": "string"
},
"detail_analysis": {
"type": [
"string",
"object",
"array",
"number",
"boolean",
"null"
]
},
"interactive_time_analysis": {
"type": "object",
"properties": {
"ctr": {
"type": "object",
"properties": {
"metric": {
"type": "string"
},
"analysis": {
"type": "array",
"items": {
"type": "object",
"properties": {
"second": {
"type": "integer"
},
"value": {
"type": "number"
}
}
}
},
"duration": {
"type": "integer"
},
"highlight": {
"type": "array",
"items": {
"type": "integer"
}
},
"percentile": {
"type": "number"
}
}
},
"cvr": {
"type": "object",
"properties": {
"metric": {
"type": "string"
},
"analysis": {
"type": "array",
"items": {
"type": "object",
"properties": {
"second": {
"type": "integer"
},
"value": {
"type": "integer"
}
}
}
},
"duration": {
"type": "integer"
},
"highlight": {
"type": "array"
},
"percentile": {
"type": "number"
}
}
},
"clicks": {
"type": "object",
"properties": {
"metric": {
"type": "string"
},
"analysis": {
"type": "array",
"items": {
"type": "object",
"properties": {
"second": {
"type": "integer"
},
"value": {
"type": "number"
}
}
}
},
"duration": {
"type": "integer"
},
"highlight": {
"type": "array",
"items": {
"type": "integer"
}
},
"percentile": {
"type": "number"
}
}
},
"conversion": {
"type": "object",
"properties": {
"metric": {
"type": "string"
},
"analysis": {
"type": "array",
"items": {
"type": "object",
"properties": {
"second": {
"type": "integer"
},
"value": {
"type": "integer"
}
}
}
},
"duration": {
"type": "integer"
},
"highlight": {
"type": "array"
},
"percentile": {
"type": "number"
}
}
},
"remain": {
"type": "object",
"properties": {
"metric": {
"type": "string"
},
"analysis": {
"type": "array",
"items": {
"type": "object",
"properties": {
"second": {
"type": "integer"
},
"value": {
"type": "integer"
}
}
}
},
"duration": {
"type": "integer"
},
"highlight": {
"type": "array"
},
"percentile": {
"type": "number"
}
}
}
}
},
"recommended_for_you": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ad_title": {
"type": "string"
},
"brand_name": {
"type": "string"
},
"cost": {
"type": "integer"
},
"ctr": {
"type": "number"
},
"favorite": {
"type": "boolean"
},
"id": {
"type": "string"
},
"industry_key": {
"type": "string"
},
"is_search": {
"type": "boolean"
},
"like": {
"type": "integer"
},
"objective_key": {
"type": "string"
},
"video_info": {
"type": "object",
"properties": {
"vid": {
"type": "string"
},
"duration": {
"type": "number"
},
"cover": {
"type": "string"
},
"video_url": {
"type": "object",
"properties": {
"720p": {
"type": "string"
}
}
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
}
}
}
}
}
},
"credits_charged": {
"type": "integer",
"minimum": 0,
"description": "FetchGoblin credits charged for this request."
},
"credits_remaining": {
"type": "integer",
"description": "Your FetchGoblin credit balance after this request."
},
"request_id": {
"type": "string",
"format": "uuid",
"description": "FetchGoblin request identifier."
}
}
}