Get page ads
curl --request GET \
--url https://api.keyapi.ai/v1/facebook/ads_page_search \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.keyapi.ai/v1/facebook/ads_page_search"
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_page_search', 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_page_search")
.header("Authorization", "Bearer <token>")
.asString();{
"code": 0,
"message": "success",
"data": {
"ads": [
{
"ad_archive_id": "1623486605837756",
"collation_count": 1,
"collation_id": "1087189690507310",
"is_active": true,
"page_id": "118526624562575",
"page_is_deleted": false,
"snapshot": {
"branded_content": null,
"page_id": "118526624562575",
"page_is_deleted": false,
"page_profile_uri": "https://facebook.com/TemuPoland",
"root_reshared_post": null,
"byline": null,
"disclaimer_label": null,
"page_name": "Temu Poland",
"page_profile_picture_url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/818262696_1657415535952157_8268807946708984970_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=6sx_0jO9R0EQ7kNvwEIVCMJ&_nc_oc=AdqwwSslkJ-nixawy6-2JXVsU0Vpenlm3rrQIWSnZpUmcMX8AfVDndvzIm_vkOZy1xI&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=bzQYJkvu0-edIYA8UpXzAQ&_nc_ss=7d289&oh=00_AQLLbDMHgM_5f3v8-7Ct4_vwrIZmw8cHo75Gk55iT-YVFg&oe=6AB80F7B",
"event": null,
"caption": "www.temu.com",
"cta_text": "Shop now",
"cards": [],
"body": {
"text": "Duża deska do krojenia idealna na blat kuchenny. Wystarczająca na warzywa, mięso i pieczywo jednocześnie. 🔪🥦🍞 Znajdziesz ją pod https://temu.to/m/e3hlkcza7gt lub z kodem fdb7936. #Temu #OdkryciaTemu #Kuchnia"
},
"cta_type": "SHOP_NOW",
"display_format": "VIDEO",
"link_description": null,
"link_url": "https://www.temu.com/ul/kuiper/un1.html?subj=feed-un&_bg_fs=1&_p_mat1_type=1&_p_jump_id=725&_x_vst_scene=adg&locale_override=211~~USD&adg_ctx=a-627f0c24&goods_id=601099944287601&_p_rfs=1&_x_ads_channel=kol_metabca&_x_ads_sub_channel=official&_x_cid=Bm5PXBEs_43400672_kol_official_instagram_official&_x_bg_adid=udp2013414079&_x_ads_set={{campaign.id}}&_x_ads_id={{adset.id}}&_x_ads_creative_id={{ad.id}}&_x_ns_source={{site_source_name}}&_x_ns_placement={{placement}}",
"images": [],
"page_categories": [
"Shopping"
],
"page_like_count": 441894,
"title": null,
"videos": [
{
"video_hd_url": "https://video-bos5-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQP_s7lt1h9Tfv5mU0UVIbxElHpiZSoRmp1KqdXs_VXmxSA9y1rlcyJgsfMcsYm67mgG9FaOgEQS6j2hReUjmE-97ZQTmBNJut37AQ_Ckg.mp4?_nc_cat=101&_nc_sid=ef5aa3&_nc_ht=video-bos5-1.xx.fbcdn.net&_nc_ohc=MgArh--b8ysQ7kNvwHe07cc&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5WSV9VU0VDQVNFX1BST0RVQ1RfVFlQRS4uQzMuNzIwLnByb2dyZXNzaXZlX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjoxODAwMzEzNzE2ODk5NTg4MCwiYXNzZXRfYWdlX2RheXMiOjE3LCJ2aV91c2VjYXNlX2lkIjoxMjM3NCwiZHVyYXRpb25fcyI6MTcsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=bzQYJkvu0-edIYA8UpXzAQ&_nc_ss=7d289&_nc_zt=28&oh=00_AQKhmEhcDRcw_QNlvRtEUhamU6nnx8Ob1dvUD3dNiFeCZg&oe=6AB7F695",
"video_preview_image_url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/815922050_1410508084542466_8132844064606268888_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=LWbA8FF07-oQ7kNvwGQn3Vz&_nc_oc=AdpAvYmfzcDKNfarsjlBckmo6FxA1pWjUUYYdQY6S45QkeLgcEn1rlIXaGqKdlyLi0g&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=bzQYJkvu0-edIYA8UpXzAQ&_nc_ss=7d289&oh=00_AQJKx0NCocPKxYN4WcIAbcBXdilArEUmXcaKSiNmpqKifw&oe=6AB7FA77",
"video_sd_url": "https://video-bos5-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQPvPhxcaoy9vo1P0QpMqDePIXmqFt8pxpKWj_y24sVzAMg3uchFfy_ryElArsfbKnco9bKSq-hNUIvavIcYep-Dm1qi04R4PPUg7dldWg.mp4?_nc_cat=110&_nc_sid=ef5aa3&_nc_ht=video-bos5-1.xx.fbcdn.net&_nc_ohc=QErz4ECnZHQQ7kNvwH3q5NC&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5WSV9VU0VDQVNFX1BST0RVQ1RfVFlQRS4uQzMuMzYwLnByb2dyZXNzaXZlX2gyNjQtYmFzaWMtZ2VuMl8zNjBwIiwieHB2X2Fzc2V0X2lkIjoxODAwMzEzNzE2ODk5NTg4MCwiYXNzZXRfYWdlX2RheXMiOjE3LCJ2aV91c2VjYXNlX2lkIjoxMjM3NCwiZHVyYXRpb25fcyI6MTcsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=bzQYJkvu0-edIYA8UpXzAQ&_nc_ss=7d289&_nc_zt=28&oh=00_AQI8HGV4Z2wVZPhIfLpt8KyI8YuspgK4rmAk-IOlAJSQ3A&oe=6AB81E84",
"watermarked_video_hd_url": null,
"watermarked_video_sd_url": null
}
],
"is_reshared": false,
"extra_links": [],
"extra_texts": [],
"extra_images": [],
"extra_videos": [],
"country_iso_code": null,
"brazil_tax_id": null,
"additional_info": null,
"ec_certificates": []
},
"has_user_reported": false,
"report_count": null,
"menu_items": [],
"state_media_run_label": null,
"page_name": "Temu Poland",
"impressions_with_index": {
"impressions_text": "<100",
"impressions_index": 0
},
"gated_type": "ELIGIBLE",
"categories": [
"UNKNOWN"
],
"is_aaa_eligible": false,
"contains_digital_created_media": false,
"reach_estimate": null,
"currency": "",
"spend": null,
"end_date": 1790060400,
"publisher_platform": [
"FACEBOOK",
"INSTAGRAM",
"AUDIENCE_NETWORK",
"THREADS"
],
"start_date": 1789887600,
"contains_sensitive_content": false,
"total_active_time": null,
"regional_regulation_data": {
"finserv": {
"is_deemed_finserv": false,
"is_limited_delivery": false
},
"tw_anti_scam": {
"is_limited_delivery": false
}
},
"hide_data_status": "NONE",
"fev_info": null,
"ad_id": null,
"targeted_or_reached_countries": []
}
],
"cursor": null
},
"requestId": "abbe2c45-1205-4541-9008-42444edf2d9a"
}{
"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 page ads
GET
/
v1
/
facebook
/
ads_page_search
Get page ads
curl --request GET \
--url https://api.keyapi.ai/v1/facebook/ads_page_search \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.keyapi.ai/v1/facebook/ads_page_search"
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_page_search', 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_page_search")
.header("Authorization", "Bearer <token>")
.asString();{
"code": 0,
"message": "success",
"data": {
"ads": [
{
"ad_archive_id": "1623486605837756",
"collation_count": 1,
"collation_id": "1087189690507310",
"is_active": true,
"page_id": "118526624562575",
"page_is_deleted": false,
"snapshot": {
"branded_content": null,
"page_id": "118526624562575",
"page_is_deleted": false,
"page_profile_uri": "https://facebook.com/TemuPoland",
"root_reshared_post": null,
"byline": null,
"disclaimer_label": null,
"page_name": "Temu Poland",
"page_profile_picture_url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/818262696_1657415535952157_8268807946708984970_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=6sx_0jO9R0EQ7kNvwEIVCMJ&_nc_oc=AdqwwSslkJ-nixawy6-2JXVsU0Vpenlm3rrQIWSnZpUmcMX8AfVDndvzIm_vkOZy1xI&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=bzQYJkvu0-edIYA8UpXzAQ&_nc_ss=7d289&oh=00_AQLLbDMHgM_5f3v8-7Ct4_vwrIZmw8cHo75Gk55iT-YVFg&oe=6AB80F7B",
"event": null,
"caption": "www.temu.com",
"cta_text": "Shop now",
"cards": [],
"body": {
"text": "Duża deska do krojenia idealna na blat kuchenny. Wystarczająca na warzywa, mięso i pieczywo jednocześnie. 🔪🥦🍞 Znajdziesz ją pod https://temu.to/m/e3hlkcza7gt lub z kodem fdb7936. #Temu #OdkryciaTemu #Kuchnia"
},
"cta_type": "SHOP_NOW",
"display_format": "VIDEO",
"link_description": null,
"link_url": "https://www.temu.com/ul/kuiper/un1.html?subj=feed-un&_bg_fs=1&_p_mat1_type=1&_p_jump_id=725&_x_vst_scene=adg&locale_override=211~~USD&adg_ctx=a-627f0c24&goods_id=601099944287601&_p_rfs=1&_x_ads_channel=kol_metabca&_x_ads_sub_channel=official&_x_cid=Bm5PXBEs_43400672_kol_official_instagram_official&_x_bg_adid=udp2013414079&_x_ads_set={{campaign.id}}&_x_ads_id={{adset.id}}&_x_ads_creative_id={{ad.id}}&_x_ns_source={{site_source_name}}&_x_ns_placement={{placement}}",
"images": [],
"page_categories": [
"Shopping"
],
"page_like_count": 441894,
"title": null,
"videos": [
{
"video_hd_url": "https://video-bos5-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQP_s7lt1h9Tfv5mU0UVIbxElHpiZSoRmp1KqdXs_VXmxSA9y1rlcyJgsfMcsYm67mgG9FaOgEQS6j2hReUjmE-97ZQTmBNJut37AQ_Ckg.mp4?_nc_cat=101&_nc_sid=ef5aa3&_nc_ht=video-bos5-1.xx.fbcdn.net&_nc_ohc=MgArh--b8ysQ7kNvwHe07cc&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5WSV9VU0VDQVNFX1BST0RVQ1RfVFlQRS4uQzMuNzIwLnByb2dyZXNzaXZlX2gyNjQtYmFzaWMtZ2VuMl83MjBwIiwieHB2X2Fzc2V0X2lkIjoxODAwMzEzNzE2ODk5NTg4MCwiYXNzZXRfYWdlX2RheXMiOjE3LCJ2aV91c2VjYXNlX2lkIjoxMjM3NCwiZHVyYXRpb25fcyI6MTcsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=bzQYJkvu0-edIYA8UpXzAQ&_nc_ss=7d289&_nc_zt=28&oh=00_AQKhmEhcDRcw_QNlvRtEUhamU6nnx8Ob1dvUD3dNiFeCZg&oe=6AB7F695",
"video_preview_image_url": "https://scontent-bos5-1.xx.fbcdn.net/v/t39.35426-6/815922050_1410508084542466_8132844064606268888_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=LWbA8FF07-oQ7kNvwGQn3Vz&_nc_oc=AdpAvYmfzcDKNfarsjlBckmo6FxA1pWjUUYYdQY6S45QkeLgcEn1rlIXaGqKdlyLi0g&_nc_zt=14&_nc_ht=scontent-bos5-1.xx&_nc_gid=bzQYJkvu0-edIYA8UpXzAQ&_nc_ss=7d289&oh=00_AQJKx0NCocPKxYN4WcIAbcBXdilArEUmXcaKSiNmpqKifw&oe=6AB7FA77",
"video_sd_url": "https://video-bos5-1.xx.fbcdn.net/o1/v/t2/f2/m367/AQPvPhxcaoy9vo1P0QpMqDePIXmqFt8pxpKWj_y24sVzAMg3uchFfy_ryElArsfbKnco9bKSq-hNUIvavIcYep-Dm1qi04R4PPUg7dldWg.mp4?_nc_cat=110&_nc_sid=ef5aa3&_nc_ht=video-bos5-1.xx.fbcdn.net&_nc_ohc=QErz4ECnZHQQ7kNvwH3q5NC&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5WSV9VU0VDQVNFX1BST0RVQ1RfVFlQRS4uQzMuMzYwLnByb2dyZXNzaXZlX2gyNjQtYmFzaWMtZ2VuMl8zNjBwIiwieHB2X2Fzc2V0X2lkIjoxODAwMzEzNzE2ODk5NTg4MCwiYXNzZXRfYWdlX2RheXMiOjE3LCJ2aV91c2VjYXNlX2lkIjoxMjM3NCwiZHVyYXRpb25fcyI6MTcsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=bzQYJkvu0-edIYA8UpXzAQ&_nc_ss=7d289&_nc_zt=28&oh=00_AQI8HGV4Z2wVZPhIfLpt8KyI8YuspgK4rmAk-IOlAJSQ3A&oe=6AB81E84",
"watermarked_video_hd_url": null,
"watermarked_video_sd_url": null
}
],
"is_reshared": false,
"extra_links": [],
"extra_texts": [],
"extra_images": [],
"extra_videos": [],
"country_iso_code": null,
"brazil_tax_id": null,
"additional_info": null,
"ec_certificates": []
},
"has_user_reported": false,
"report_count": null,
"menu_items": [],
"state_media_run_label": null,
"page_name": "Temu Poland",
"impressions_with_index": {
"impressions_text": "<100",
"impressions_index": 0
},
"gated_type": "ELIGIBLE",
"categories": [
"UNKNOWN"
],
"is_aaa_eligible": false,
"contains_digital_created_media": false,
"reach_estimate": null,
"currency": "",
"spend": null,
"end_date": 1790060400,
"publisher_platform": [
"FACEBOOK",
"INSTAGRAM",
"AUDIENCE_NETWORK",
"THREADS"
],
"start_date": 1789887600,
"contains_sensitive_content": false,
"total_active_time": null,
"regional_regulation_data": {
"finserv": {
"is_deemed_finserv": false,
"is_limited_delivery": false
},
"tw_anti_scam": {
"is_limited_delivery": false
}
},
"hide_data_status": "NONE",
"fev_info": null,
"ad_id": null,
"targeted_or_reached_countries": []
}
],
"cursor": null
},
"requestId": "abbe2c45-1205-4541-9008-42444edf2d9a"
}{
"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:
"118526624562575"
Example:
"US"
defualt: ALL. Available values: ALL ACTIVE INACTIVE
Response
The response is of type object.

