Scavio icon

Scavio

Real-time structured data from Google, Amazon, Walmart, eBay, Target, Home Depot, Costco, YouTube, Reddit, TikTok, Instagram, X, LinkedIn, Facebook, Pinterest, Threads, Kuaishou, Douyin, Weibo, Twitch, GitHub, Etsy, AliExpress, Zillow, Redfin, Realtor.com, Rightmove, Booking.com, Airbnb, Tripadvisor, Yelp, Indeed, Glassdoor, the App Store, Google Play, SEC EDGAR, Companies House, Legistar, G2, Capterra, Trustpilot, ad libraries, and any URL

Actions227

Meta Ad Library → Get Advertiser Ads

AI-generated

Summary

Retrieve ads from Meta’s Ad Library for a Facebook Page. Provide the advertiser’s numeric Page ID; optionally filter by status, ad type, country, or media type, or supply a cursor to continue a previous response’s results.

Inputs

  • Page ID (required) — Numeric Facebook Page ID, 3–25 digits. Search Ad Library returns this ID on each result.
  • Active Status — Choose active, inactive, or all ads; defaults to all.
  • Ad Type — Choose all ads or political and issue ads; defaults to all. Spend, reach, impressions, and paid-for-by disclosure are exposed for political and issue ads; these fields are null for commercial ads.
  • Country — Two-letter country code for the library query; defaults to US.
  • Cursor — Use the previous response’s next_cursor to retrieve the next page. The first page contains 30 ads and subsequent pages contain 10. When a cursor is present, other filters are ignored because the cursor carries them.
  • Media Type — Filter by media type: all, image, image and meme, meme, none, or video. Defaults to all.

Output shape

A response containing advertiser ads and pagination data.

Use next_cursor from the response to request the next page. The supplied properties do not specify the exact response fields.

Examples

Example 1: Use case

Pass a Page ID to retrieve its ads, optionally filter them, and use next_cursor to fetch another page.

Links

Discussion