Get ad details by just id
curl --request GET \
--url https://api.keyapi.ai/v1/facebook/ads_details_id \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.keyapi.ai/v1/facebook/ads_details_id"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.keyapi.ai/v1/facebook/ads_details_id', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api.keyapi.ai/v1/facebook/ads_details_id")
.header("Authorization", "Bearer <token>")
.asString();{
"code": 0,
"message": "success",
"data": {
"details": {
"advertiser": {
"page": {
"about": {
"text": "😎Twój ulubiony sklep internetowy z okularami\nTy definiujesz swój wygląd!"
},
"is_delegate_page_with_linked_primary_profile": false,
"id": "339984905864224"
},
"ad_library_page_info": {
"page_spend": {
"current_week": null,
"lifetime_by_disclaimer": [],
"weekly_by_disclaimer": [],
"is_political_page": false
},
"page_info": {
"entity_type": "PERSON_PROFILE",
"ig_followers": 17346,
"ig_username": "firmoopoland",
"ig_verification": false,
"likes": 35566,
"page_alias": "firmoo.poland",
"page_category": "Sunglasses and eyewear shop",
"page_cover_photo": "https://scontent.fccu4-3.fna.fbcdn.net/v/t39.30808-6/782169234_122236006676343591_1433542590153843970_n.jpg?_nc_cat=103&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=957871&_nc_ohc=mtV_eUd-cR8Q7kNvwED_-Xp&_nc_oc=AdpogrARo2e5i39sSPH8s3ttaTfgAJmjKWjZ0izEDcKC1N5pKNZYO7t6v0UQe77QUEs&_nc_zt=23&_nc_ht=scontent.fccu4-3.fna&_nc_gid=HtHUvqHMoeDyw2cBj7fWyg&_nc_ss=7d289&oh=00_AQIUHsF5xa0EDfgDSng5VDQl_8V3y1B-gdqY2_gTccT0dA&oe=6AB80441",
"page_id": "339984905864224",
"page_is_deleted": false,
"page_is_restricted": false,
"page_name": "Firmoo.poland",
"page_profile_uri": "https://facebook.com/firmoo.poland",
"page_verification": "NOT_VERIFIED",
"profile_photo": "https://scontent.fccu4-3.fna.fbcdn.net/v/t39.30808-1/447635128_440688882051771_5238228663214113656_n.jpg?stp=dst-jpg_s148x148_tt6&_nc_cat=103&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=418b77&_nc_ohc=tFLinc_z65YQ7kNvwFaTZ_h&_nc_oc=Adp98k-FI4wQLDmp6n5fbVAwkvlKguFtF8jin8WSj1-pkon6T_TA7OGMTfoV4g-O1E8&_nc_zt=24&_nc_ht=scontent.fccu4-3.fna&_nc_gid=HtHUvqHMoeDyw2cBj7fWyg&_nc_ss=7d289&oh=00_AQJq7yyvWmcgl24KWvX28YKqjbM4spSl12clapcJKv8-Dg&oe=6AB81CB5",
"is_profile_page": false
}
}
},
"aaa_info": {
"payer_beneficiary_data": [
{
"payer": "MeetSocial (HongKong)Digital Marketing Co., Limited16:06",
"beneficiary": "Firmoo poland"
}
],
"targets_eu": true,
"has_violating_payer_beneficiary": false,
"is_ad_taken_down": false
},
"violation_types": [],
"verified_voice_context": null,
"transparency_by_location": {
"br_transparency": null,
"eu_transparency": {
"targets_eu": true,
"location_audience": [
{
"name": "Poland",
"num_obfuscated": 0,
"type": "countries",
"excluded": false
}
],
"gender_audience": "All",
"age_audience": {
"min": 18,
"max": 65
},
"eu_total_reach": 4437106,
"age_country_gender_reach_breakdown": [
{
"country": "PL",
"age_gender_breakdowns": [
{
"age_range": "18-24",
"male": 162273,
"female": 726079,
"unknown": 20939
},
{
"age_range": "45-54",
"male": 149808,
"female": 378998,
"unknown": 6839
},
{
"age_range": "Unknown",
"male": 95,
"female": 692,
"unknown": 128
},
{
"age_range": "65+",
"male": 40460,
"female": 105295,
"unknown": 1565
},
{
"age_range": "55-64",
"male": 60306,
"female": 145577,
"unknown": 2266
},
{
"age_range": "35-44",
"male": 280084,
"female": 837549,
"unknown": 12276
},
{
"age_range": "25-34",
"male": 382706,
"female": 1250666,
"unknown": 22748
}
]
}
]
},
"uk_transparency": null
},
"is_siep_advertiser_eligible_for_ai_disclosure": true,
"is_violating_eu_siep": false
}
},
"requestId": "f07a8e7c-6d55-4630-8da2-82295bab11af"
}{
"code": 400,
"data": null,
"message": "Missing required parameter: handle"
}{
"code": 401,
"data": null,
"message": "apiKey is null"
}{
"code": 402,
"data": null,
"message": "apiKey quota is not enough"
}{
"code": 429,
"data": null,
"message": "qps limit exceeded"
}{
"code": 500,
"data": null,
"message": "Internal server error"
}Ads Library
Get ad details by just id
GET
/
v1
/
facebook
/
ads_details_id
Get ad details by just id
curl --request GET \
--url https://api.keyapi.ai/v1/facebook/ads_details_id \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.keyapi.ai/v1/facebook/ads_details_id"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.keyapi.ai/v1/facebook/ads_details_id', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api.keyapi.ai/v1/facebook/ads_details_id")
.header("Authorization", "Bearer <token>")
.asString();{
"code": 0,
"message": "success",
"data": {
"details": {
"advertiser": {
"page": {
"about": {
"text": "😎Twój ulubiony sklep internetowy z okularami\nTy definiujesz swój wygląd!"
},
"is_delegate_page_with_linked_primary_profile": false,
"id": "339984905864224"
},
"ad_library_page_info": {
"page_spend": {
"current_week": null,
"lifetime_by_disclaimer": [],
"weekly_by_disclaimer": [],
"is_political_page": false
},
"page_info": {
"entity_type": "PERSON_PROFILE",
"ig_followers": 17346,
"ig_username": "firmoopoland",
"ig_verification": false,
"likes": 35566,
"page_alias": "firmoo.poland",
"page_category": "Sunglasses and eyewear shop",
"page_cover_photo": "https://scontent.fccu4-3.fna.fbcdn.net/v/t39.30808-6/782169234_122236006676343591_1433542590153843970_n.jpg?_nc_cat=103&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=957871&_nc_ohc=mtV_eUd-cR8Q7kNvwED_-Xp&_nc_oc=AdpogrARo2e5i39sSPH8s3ttaTfgAJmjKWjZ0izEDcKC1N5pKNZYO7t6v0UQe77QUEs&_nc_zt=23&_nc_ht=scontent.fccu4-3.fna&_nc_gid=HtHUvqHMoeDyw2cBj7fWyg&_nc_ss=7d289&oh=00_AQIUHsF5xa0EDfgDSng5VDQl_8V3y1B-gdqY2_gTccT0dA&oe=6AB80441",
"page_id": "339984905864224",
"page_is_deleted": false,
"page_is_restricted": false,
"page_name": "Firmoo.poland",
"page_profile_uri": "https://facebook.com/firmoo.poland",
"page_verification": "NOT_VERIFIED",
"profile_photo": "https://scontent.fccu4-3.fna.fbcdn.net/v/t39.30808-1/447635128_440688882051771_5238228663214113656_n.jpg?stp=dst-jpg_s148x148_tt6&_nc_cat=103&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=418b77&_nc_ohc=tFLinc_z65YQ7kNvwFaTZ_h&_nc_oc=Adp98k-FI4wQLDmp6n5fbVAwkvlKguFtF8jin8WSj1-pkon6T_TA7OGMTfoV4g-O1E8&_nc_zt=24&_nc_ht=scontent.fccu4-3.fna&_nc_gid=HtHUvqHMoeDyw2cBj7fWyg&_nc_ss=7d289&oh=00_AQJq7yyvWmcgl24KWvX28YKqjbM4spSl12clapcJKv8-Dg&oe=6AB81CB5",
"is_profile_page": false
}
}
},
"aaa_info": {
"payer_beneficiary_data": [
{
"payer": "MeetSocial (HongKong)Digital Marketing Co., Limited16:06",
"beneficiary": "Firmoo poland"
}
],
"targets_eu": true,
"has_violating_payer_beneficiary": false,
"is_ad_taken_down": false
},
"violation_types": [],
"verified_voice_context": null,
"transparency_by_location": {
"br_transparency": null,
"eu_transparency": {
"targets_eu": true,
"location_audience": [
{
"name": "Poland",
"num_obfuscated": 0,
"type": "countries",
"excluded": false
}
],
"gender_audience": "All",
"age_audience": {
"min": 18,
"max": 65
},
"eu_total_reach": 4437106,
"age_country_gender_reach_breakdown": [
{
"country": "PL",
"age_gender_breakdowns": [
{
"age_range": "18-24",
"male": 162273,
"female": 726079,
"unknown": 20939
},
{
"age_range": "45-54",
"male": 149808,
"female": 378998,
"unknown": 6839
},
{
"age_range": "Unknown",
"male": 95,
"female": 692,
"unknown": 128
},
{
"age_range": "65+",
"male": 40460,
"female": 105295,
"unknown": 1565
},
{
"age_range": "55-64",
"male": 60306,
"female": 145577,
"unknown": 2266
},
{
"age_range": "35-44",
"male": 280084,
"female": 837549,
"unknown": 12276
},
{
"age_range": "25-34",
"male": 382706,
"female": 1250666,
"unknown": 22748
}
]
}
]
},
"uk_transparency": null
},
"is_siep_advertiser_eligible_for_ai_disclosure": true,
"is_violating_eu_siep": false
}
},
"requestId": "f07a8e7c-6d55-4630-8da2-82295bab11af"
}{
"code": 400,
"data": null,
"message": "Missing required parameter: handle"
}{
"code": 401,
"data": null,
"message": "apiKey is null"
}{
"code": 402,
"data": null,
"message": "apiKey quota is not enough"
}{
"code": 429,
"data": null,
"message": "qps limit exceeded"
}{
"code": 500,
"data": null,
"message": "Internal server error"
}🪙4 creditsper request
Copy for AI
🤖 Why Code When AI Can Do It For You?
Stop writing code like it’s 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.

