# List Advertiser Ads Lists all ads from a specific Facebook advertiser by their page ID. Returns raw ad data with full filter support. - Platform: [Facebook Ad Library](https://docs.upscrape.com/docs/platforms/fb-adlibrary) - Capability ID: `fb-adlibrary.advertiser-ads.list` - Cost: 1 credit per request - Maximum runtime: 120 seconds - Execute endpoint: `POST https://data.upscrape.com/execute` ## Request Use the exact public capability ID in the shared execute envelope. ```bash curl -X POST https://data.upscrape.com/execute \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{"country":"US","limit":5,"page_id":"15087023444"},"capability":"fb-adlibrary.advertiser-ads.list"}' ``` ## Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `active` | `string` | No | Filter by active status: all, active, inactive (default: all) | | `country` | `string` | No | ISO country code (default: US) | | `end_date` | `string` | No | Filter ads with impressions until this date (YYYY-MM-DD) | | `languages` | `array` | No | Filter by content language codes (e.g. ["en"]) | | `limit` | `integer` | No | Maximum number of ads to return (default: 50) | | `media_type` | `string` | No | Filter by media type: all, image, video, meme, none (default: all) | | `page_id` | `string` | Yes | Facebook page ID of the advertiser | | `platforms` | `array` | No | Filter by publisher platform: facebook, instagram, messenger, audience_network | | `sort_by` | `string` | No | Sort results: relevance, date, impressions (default: impressions) | | `start_date` | `string` | No | Filter ads with impressions from this date (YYYY-MM-DD) | ### Example input ```json { "country": "US", "limit": 5, "page_id": "15087023444" } ``` ## Response Successful output is returned in `results[0].data`. Raw platform output is intentionally open-ended and may evolve with the upstream source. ### Illustrative sample output This redacted fixture is an example, not a fixed response schema. ```json { "items": [ { "ad_archive_id": "1869276447125570", "ad_id": null, "categories": [ "UNKNOWN" ], "collation_count": null, "collation_id": null, "contains_digital_created_media": false, "contains_sensitive_content": false, "currency": "", "end_date": 1785567600, "fev_info": null, "gated_type": "ELIGIBLE", "has_user_reported": false, "hide_data_status": "NONE", "impressions_with_index": { "impressions_index": -1, "impressions_text": null }, "is_aaa_eligible": false, "is_active": true, "menu_items": [], "page_id": "15087023444", "page_is_deleted": false, "page_name": "Nike", "publisher_platform": [ "FACEBOOK", "INSTAGRAM", "AUDIENCE_NETWORK" ], "reach_estimate": null, "regional_regulation_data": { "finserv": { "is_deemed_finserv": false, "is_limited_delivery": false }, "tw_anti_scam": { "is_limited_delivery": false } }, "report_count": null, "snapshot": { "additional_info": null, "body": { "text": "Celebra tu cumpleaños con Nike y obtén acceso a productos exclusivos, MSI, envío y devoluciones gratis el resto del año." }, "branded_content": null, "brazil_tax_id": "[redacted:brazil_tax_id]", "byline": null, "caption": "itunes.apple.com", "cards": [ { "body": "Celebra tu cumpleaños con Nike y obtén acceso a productos exclusivos, MSI, envío y devoluciones gratis el resto del año.", "caption": "itunes.apple.com", "cta_text": "Install Now", "cta_type": "INSTALL_MOBILE_APP", "image_crops": [], "link_description": "Download Nike: Shoes, Apparel, Stories by Nike, Inc on the App Store. See screenshots, ratings and reviews, user tips, and more apps like Nike: Shoes, Apparel,…", "link_url": "https://www.nike.com/mx/t/calcetines-de-fútbol-hasta-la-rodilla-academy-wwdjrW/SX4120-101?cp=54413048966_soc_", "original_image_url": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=t8SuOt5bvHEQ7kNvwHyrgDn&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73C2B0", "resized_image_url": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=t8SuOt5bvHEQ7kNvwHyrgDn&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73C2B0", "title": "Nike", "video_hd_url": null, "video_preview_image_url": null, "video_sd_url": null, "watermarked_resized_image_url": "", "watermarked_video_hd_url": null, "watermarked_video_sd_url": null }, { "body": "Celebra tu cumpleaños con Nike y obtén acceso a productos exclusivos, MSI, envío y devoluciones gratis el resto del año.", "caption": "itunes.apple.com", "cta_text": "Install Now", "cta_type": "INSTALL_MOBILE_APP", "image_crops": [], "link_description": "Download Nike: Shoes, Apparel, Stories by Nike, Inc on the App Store. See screenshots, ratings and reviews, user tips, and more apps like Nike: Shoes, Apparel,…", "link_url": "https://www.nike.com/mx/t/espinillera-de-fútbol-charge-MFtBhV/DX4608-100?cp=54413048966_soc_", "original_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=ttLZDV5dN64Q7kNvwGsKZNo&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73B003", "resized_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=ttLZDV5dN64Q7kNvwGsKZNo&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73B003", "title": "Nike", "video_hd_url": null, "video_preview_image_url": null, "video_sd_url": null, "watermarked_resized_image_url": "", "watermarked_video_hd_url": null, "watermarked_video_sd_url": null }, { "body": "Celebra tu cumpleaños con Nike y obtén acceso a productos exclusivos, MSI, envío y devoluciones gratis el resto del año.", "caption": "itunes.apple.com", "cta_text": "Install Now", "cta_type": "INSTALL_MOBILE_APP", "image_crops": [], "link_description": "Download Nike: Shoes, Apparel, Stories by Nike, Inc on the App Store. See screenshots, ratings and reviews, user tips, and more apps like Nike: Shoes, Apparel,…", "link_url": "https://www.nike.com/mx/t/[redacted:token]/FD0645-100?cp=54413048966_soc_", "original_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=rBw2W5DumT4Q7kNvwGhmRQE&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73B73C", "resized_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=rBw2W5DumT4Q7kNvwGhmRQE&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73B73C", "title": "Nike", "video_hd_url": null, "video_preview_image_url": null, "video_sd_url": null, "watermarked_resized_image_url": "", "watermarked_video_hd_url": null, "watermarked_video_sd_url": null } ], "country_iso_code": null, "cta_text": "Install now", "cta_type": "INSTALL_MOBILE_APP", "disclaimer_label": null, "display_format": "DPA", "ec_certificates": [], "event": null, "extra_images": [], "extra_links": [], "extra_texts": [], "extra_videos": [], "images": [], "is_reshared": false, "link_description": null, "link_url": "http://itunes.apple.com/app/id1095459556", "page_categories": [ "Sportswear" ], "page_id": "15087023444", "page_is_deleted": false, "page_like_count": 39577509, "page_name": "Nike", "page_profile_picture_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=drdbCFFung0Q7kNvwFoNV71&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A7393D6", "page_profile_uri": "https://www.facebook.com/nike/", "root_reshared_post": null, "title": "Nike: Shoes, Apparel, Stories", "videos": [] }, "spend": null, "start_date": 1773730800, "state_media_run_label": null, "targeted_or_reached_countries": [], "total_active_time": null }, { "ad_archive_id": "161966936869658", "ad_id": null, "categories": [ "UNKNOWN" ], "collation_count": null, "collation_id": null, "contains_digital_created_media": false, "contains_sensitive_content": false, "currency": "", "end_date": 1774854000, "fev_info": null, "gated_type": "ELIGIBLE", "has_user_reported": false, "hide_data_status": "NONE", "impressions_with_index": { "impressions_index": -1, "impressions_text": null }, "is_aaa_eligible": true, "is_active": false, "menu_items": [], "page_id": "15087023444", "page_is_deleted": false, "page_name": "Nike", "publisher_platform": [ "FACEBOOK", "INSTAGRAM", "AUDIENCE_NETWORK" ], "reach_estimate": null, "regional_regulation_data": { "finserv": { "is_deemed_finserv": false, "is_limited_delivery": false }, "tw_anti_scam": { "is_limited_delivery": false } }, "report_count": null, "snapshot": { "additional_info": null, "body": { "text": "Entra a Nike.com y encuentra actualizaciones semanales de producto con envío gratis." }, "branded_content": null, "brazil_tax_id": "[redacted:brazil_tax_id]", "byline": null, "caption": "nike.com/mx", "cards": [ { "body": "Entra a Nike.com y encuentra actualizaciones semanales de producto con envío gratis.", "caption": "ad.doubleclick.net", "cta_text": "Shop Now", "cta_type": "SHOP_NOW", "image_crops": [], "link_description": "", "link_url": "https://www.nike.com/mx/t/[redacted:token]?cp=77438547234_soc_", "original_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=aCJ4QS2wWeUQ7kNvwGS9076&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73B830", "resized_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=aCJ4QS2wWeUQ7kNvwGS9076&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73B830", "title": "Calzado de entrenamiento para hombre Nike MC Trainer 2 - Azul", "video_hd_url": null, "video_preview_image_url": null, "video_sd_url": null, "watermarked_resized_image_url": "", "watermarked_video_hd_url": null, "watermarked_video_sd_url": null }, { "body": "Entra a Nike.com y encuentra actualizaciones semanales de producto con envío gratis.", "caption": "ad.doubleclick.net", "cta_text": "Shop Now", "cta_type": "SHOP_NOW", "image_crops": [], "link_description": "", "link_url": "https://www.nike.com/mx/t/shorts-de-tejido-woven-jordan-essentials-sPBbsb?cp=77438547234_soc_", "original_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=qvSnQLxbtZUQ7kNvwHaeyrP&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73C2A1", "resized_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=qvSnQLxbtZUQ7kNvwHaeyrP&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73C2A1", "title": "Shorts de tejido Woven para hombre Jordan Essentials - Negro", "video_hd_url": null, "video_preview_image_url": null, "video_sd_url": null, "watermarked_resized_image_url": "", "watermarked_video_hd_url": null, "watermarked_video_sd_url": null }, { "body": "Entra a Nike.com y encuentra actualizaciones semanales de producto con envío gratis.", "caption": "ad.doubleclick.net", "cta_text": "Shop Now", "cta_type": "SHOP_NOW", "image_crops": [], "link_description": "", "link_url": "https://www.nike.com/mx/t/[redacted:token]?cp=77438547234_soc_", "original_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=rqZpzBJfjNIQ7kNvwHDbUtI&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73A3EC", "resized_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=rqZpzBJfjNIQ7kNvwHDbUtI&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73A3EC", "title": "Calzado de entrenamiento para hombre Nike Metcon 8 - Gris", "video_hd_url": null, "video_preview_image_url": null, "video_sd_url": null, "watermarked_resized_image_url": "", "watermarked_video_hd_url": null, "watermarked_video_sd_url": null } ], "country_iso_code": null, "cta_text": "Shop now", "cta_type": "SHOP_NOW", "disclaimer_label": null, "display_format": "DPA", "ec_certificates": [], "event": null, "extra_images": [], "extra_links": [], "extra_texts": [], "extra_videos": [], "images": [], "is_reshared": false, "link_description": null, "link_url": "https://ad.doubleclick.net/ddm/trackclk/N8893.2410306FACEBOOKADS/B30448992.373431644;dc_trk_aid=564542764;dc_trk_cid=196659869;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;ltd=;dc_tdv=1", "page_categories": [ "Sportswear", "Product/service" ], "page_id": "15087023444", "page_is_deleted": false, "page_like_count": 39577509, "page_name": "Nike", "page_profile_picture_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=08Vi-ht-T5IQ7kNvwHdsoHJ&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73A4E8", "page_profile_uri": "https://www.facebook.com/nike/", "root_reshared_post": null, "title": "{{product.name}}", "videos": [] }, "spend": null, "start_date": 1692082800, "state_media_run_label": null, "targeted_or_reached_countries": [], "total_active_time": null }, { "ad_archive_id": "1249043200627555", "ad_id": null, "categories": [ "UNKNOWN" ], "collation_count": null, "collation_id": null, "contains_digital_created_media": false, "contains_sensitive_content": false, "currency": "", "end_date": 1785567600, "fev_info": null, "gated_type": "ELIGIBLE", "has_user_reported": false, "hide_data_status": "NONE", "impressions_with_index": { "impressions_index": -1, "impressions_text": null }, "is_aaa_eligible": false, "is_active": true, "menu_items": [], "page_id": "15087023444", "page_is_deleted": false, "page_name": "Nike", "publisher_platform": [ "FACEBOOK", "INSTAGRAM", "AUDIENCE_NETWORK" ], "reach_estimate": null, "regional_regulation_data": { "finserv": { "is_deemed_finserv": false, "is_limited_delivery": false }, "tw_anti_scam": { "is_limited_delivery": false } }, "report_count": null, "snapshot": { "additional_info": null, "body": { "text": "Celebra tu cumpleaños con Nike y obtén acceso a productos exclusivos, MSI, envío y devoluciones gratis el resto del año." }, "branded_content": null, "brazil_tax_id": "[redacted:brazil_tax_id]", "byline": null, "caption": "play.google.com", "cards": [ { "body": "Celebra tu cumpleaños con Nike y obtén acceso a productos exclusivos, MSI, envío y devoluciones gratis el resto del año.", "caption": "play.google.com", "cta_text": "Shop Now", "cta_type": "SHOP_NOW", "image_crops": [], "link_description": "Unlock the latest from Nike & Jordan. Shop sneakers & apparel for all athletes.", "link_url": "https://www.nike.com/mx/t/espinillera-de-fútbol-charge-MFtBhV/DX4608-010?cp=54413048966_soc_", "original_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=bz2W6vy2HzwQ7kNvwEu-i-y&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73B98F", "resized_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=bz2W6vy2HzwQ7kNvwEu-i-y&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73B98F", "title": "Nike", "video_hd_url": null, "video_preview_image_url": null, "video_sd_url": null, "watermarked_resized_image_url": "", "watermarked_video_hd_url": null, "watermarked_video_sd_url": null }, { "body": "Celebra tu cumpleaños con Nike y obtén acceso a productos exclusivos, MSI, envío y devoluciones gratis el resto del año.", "caption": "play.google.com", "cta_text": "Shop Now", "cta_type": "SHOP_NOW", "image_crops": [], "link_description": "Unlock the latest from Nike & Jordan. Shop sneakers & apparel for all athletes.", "link_url": "https://www.nike.com/mx/t/[redacted:token]/DX7906-010?cp=54413048966_soc_", "original_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=1PpVh2HYf3kQ7kNvwGnCwkN&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A739255", "resized_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=1PpVh2HYf3kQ7kNvwGnCwkN&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A739255", "title": "Nike", "video_hd_url": null, "video_preview_image_url": null, "video_sd_url": null, "watermarked_resized_image_url": "", "watermarked_video_hd_url": null, "watermarked_video_sd_url": null }, { "body": "Celebra tu cumpleaños con Nike y obtén acceso a productos exclusivos, MSI, envío y devoluciones gratis el resto del año.", "caption": "play.google.com", "cta_text": "Shop Now", "cta_type": "SHOP_NOW", "image_crops": [], "link_description": "Unlock the latest from Nike & Jordan. Shop sneakers & apparel for all athletes.", "link_url": "https://www.nike.com/mx/t/calcetines-de-fútbol-hasta-la-rodilla-academy-wwdjrW/SX4120-101?cp=54413048966_soc_", "original_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?_nc_cat=101&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=QB8IlJ0V8-QQ7kNvwGlLPt_&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73B076", "resized_image_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=101&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=QB8IlJ0V8-QQ7kNvwGlLPt_&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A73B076", "title": "Nike", "video_hd_url": null, "video_preview_image_url": null, "video_sd_url": null, "watermarked_resized_image_url": "", "watermarked_video_hd_url": null, "watermarked_video_sd_url": null } ], "country_iso_code": null, "cta_text": "Shop now", "cta_type": "SHOP_NOW", "disclaimer_label": null, "display_format": "DPA", "ec_certificates": [], "event": null, "extra_images": [], "extra_links": [], "extra_texts": [], "extra_videos": [], "images": [], "is_reshared": false, "link_description": null, "link_url": "http://play.google.com/store/apps/details?id=com.nike.omega", "page_categories": [ "Sportswear" ], "page_id": "15087023444", "page_is_deleted": false, "page_like_count": 39577509, "page_name": "Nike", "page_profile_picture_url": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/[redacted:token].jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=ZLrvyEtvspIQ7kNvwEb50LW&_nc_oc=[redacted:token]&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=w9gukb2vim_EwS-QtQHgkg&_nc_ss=7b289&oh=[redacted:token]&oe=6A739DA7", "page_profile_uri": "https://www.facebook.com/nike/", "root_reshared_post": null, "title": "Nike: Shoes, Apparel & Stories", "videos": [] }, "spend": null, "start_date": 1773730800, "state_media_run_label": null, "targeted_or_reached_countries": [], "total_active_time": null } ], "next_cursor": "[redacted:token]", "total_items": 5 } ``` ### Illustrative output fields Derived from the sample above for orientation only. These fields are not a fixed response schema. | Path | Observed type | Example | | --- | --- | --- | | `items` | `array` | 3 items | | `items` | `array` | 3 items | | `next_cursor` | `string` | [redacted:token] | | `total_items` | `integer` | 5 | ## Execution behavior A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job. See [jobs and results](https://docs.upscrape.com/docs/api/jobs), [errors and retries](https://docs.upscrape.com/docs/api/errors), and [idempotency](https://docs.upscrape.com/docs/api/idempotency). ## Machine-readable contract - [Capability OpenAPI 3.1](https://docs.upscrape.com/docs/platforms/fb-adlibrary/fb-adlibrary.advertiser-ads.list/openapi.json) - [Platform OpenAPI 3.1](https://upscrape.com/scrapers/fb-adlibrary/openapi.json) - [Focused coding-agent prompt](https://upscrape.com/scrapers/fb-adlibrary/capabilities/fb-adlibrary.advertiser-ads.list/llm.md)