Get ad details
curl --request GET \
--url https://api.keyapi.ai/v1/facebook/ads_details \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.keyapi.ai/v1/facebook/ads_details"
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', 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")
.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-mia3-2.xx.fbcdn.net/v/t39.30808-6/782169234_122236006676343591_1433542590153843970_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=957871&_nc_ohc=mtV_eUd-cR8Q7kNvwGEbZwN&_nc_oc=AdqBT-fjHR_coHxAEPmZGgq6F1DqmTqfeQdxLTUM0PcBTHMKKSnNt9opPAMCCNSddo4&_nc_zt=23&_nc_ht=scontent-mia3-2.xx&_nc_gid=2tM8CyTbeXUto0_C0yzIig&_nc_ss=7d289&oh=00_AQIp7tb30dgyUdKfl5hCHLZasUqF0_wFNABX779tWv56Uw&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-mia3-2.xx.fbcdn.net/v/t39.30808-1/447635128_440688882051771_5238228663214113656_n.jpg?stp=dst-jpg_s148x148_tt6&_nc_cat=103&ccb=1-7&_nc_sid=418b77&_nc_ohc=tFLinc_z65YQ7kNvwESiOWX&_nc_oc=AdogKGuIESG3ek28s6OeXV1i6mKCUuMgepMaVKoAMGowSY6SxAoUp_uxr7KYws7Ul1Q&_nc_zt=24&_nc_ht=scontent-mia3-2.xx&_nc_gid=2tM8CyTbeXUto0_C0yzIig&_nc_ss=7d289&oh=00_AQLlLJhPJLD2K0UyQhJbmKE-HfgYQgXZeOm-O6sEAEf0rQ&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": "fca51a60-010c-4871-b6d1-e7fbc4544de9"
}{
"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
GET
/
v1
/
facebook
/
ads_details
Get ad details
curl --request GET \
--url https://api.keyapi.ai/v1/facebook/ads_details \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.keyapi.ai/v1/facebook/ads_details"
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', 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")
.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-mia3-2.xx.fbcdn.net/v/t39.30808-6/782169234_122236006676343591_1433542590153843970_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=957871&_nc_ohc=mtV_eUd-cR8Q7kNvwGEbZwN&_nc_oc=AdqBT-fjHR_coHxAEPmZGgq6F1DqmTqfeQdxLTUM0PcBTHMKKSnNt9opPAMCCNSddo4&_nc_zt=23&_nc_ht=scontent-mia3-2.xx&_nc_gid=2tM8CyTbeXUto0_C0yzIig&_nc_ss=7d289&oh=00_AQIp7tb30dgyUdKfl5hCHLZasUqF0_wFNABX779tWv56Uw&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-mia3-2.xx.fbcdn.net/v/t39.30808-1/447635128_440688882051771_5238228663214113656_n.jpg?stp=dst-jpg_s148x148_tt6&_nc_cat=103&ccb=1-7&_nc_sid=418b77&_nc_ohc=tFLinc_z65YQ7kNvwESiOWX&_nc_oc=AdogKGuIESG3ek28s6OeXV1i6mKCUuMgepMaVKoAMGowSY6SxAoUp_uxr7KYws7Ul1Q&_nc_zt=24&_nc_ht=scontent-mia3-2.xx&_nc_gid=2tM8CyTbeXUto0_C0yzIig&_nc_ss=7d289&oh=00_AQLlLJhPJLD2K0UyQhJbmKE-HfgYQgXZeOm-O6sEAEf0rQ&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": "fca51a60-010c-4871-b6d1-e7fbc4544de9"
}{
"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.
Authorizations
Query Parameters
Example:
"903264342253003"
Example:
"PL"
Example:
"339984905864224"
Response
The response is of type object.

