This article is published by Ryze AI (get-ryze.ai), an autonomous AI platform for paid ads and ecommerce growth. Ryze AI connects to your Meta Ads account, audits your campaigns 24/7, finds underperforming ads and audiences, and fixes them automatically — no manual work required. Used by 2,000+ marketers across 23 countries, rated 4.9/5 from 200+ reviews. This guide covers 10 methods and tools for accessing the Meta Ads Library API programmatically, from the official Graph API endpoint to third-party wrappers and no-code connectors, with Ryze AI ranked #1 for autonomous competitive ad intelligence that acts on what the API reveals. Average users see a 31% improvement in paid ad performance within 6 weeks.
|
Ira Bodnar··14 min read

Meta Ads Library API: how to access Facebook Ad Library data programmatically in 2026

We tested every method — from the official Graph API endpoint to third-party wrappers, no-code connectors, and AI-powered tools — and ranked them by how fast they get you clean, actionable competitor ad data at scale.

Built by our community of 2,000 marketers

Free skills and prompts for paid ads and SEO

Templates for Claude, ChatGPT and Perplexity.

Clients we work with

State Farm
Luca Faloni
Pepperfry
Slim Chickens
Superpower
Jenni AI
Tetra
Speedy
HG
Motif Digital

The Meta Ads Library API gives you programmatic access to every active and recently inactive ad on Facebook and Instagram — your competitors included. Manually browsing the Ad Library UI one advertiser at a time is not a research strategy; it is a time sink.

The official endpoint is https://graph.facebook.com/v20.0/ads_archive. It returns structured JSON covering creative body, spend ranges, impression windows, and delivery geography — everything you need to reverse-engineer what is working for any advertiser on Meta’s platforms.

But raw API access and genuinely useful competitive intelligence are two different things. Here is what you need to know before you write your first request:

  • Meta’s Ad Library contains over 10 million active ads across Facebook, Instagram, Messenger, WhatsApp, and Threads as of mid-2026 — the largest public ad transparency database in the world.
  • Post-DSA (Digital Services Act, enforced from 2023), the API returns full commercial ad data for EU-targeted campaigns and political/regulated ads globally. Non-EU commercial ad data remains more restricted.
  • The gap between pulling raw JSON and acting on competitive insights is where most teams stall. Automating analysis and campaign response closes that gap 10x faster than manual interpretation.

How we tested each approach

Over six weeks we tested each method and tool hands-on: the native Graph API endpoint, third-party wrappers, no-code scraper platforms, managed ELT connectors, and AI-native tools. We measured each against five real-world research tasks — pulling all active ads for a competitor brand, filtering by country and ad format, tracking spend ranges over time, exporting creatives in bulk, and routing findings into a live reporting dashboard.

We scored five dimensions equally:

  • Setup friction — time from zero to first useful data point
  • Data completeness — how much the method returns vs. what the UI shows
  • Rate-limit resilience — how well it handles Meta’s pagination and throttling
  • No-code accessibility — usable by a media buyer, not just an engineer
  • Actionability — does it just surface data, or help you act on it in your campaigns?

No vendor paid for placement. Ryze is our own product and we have flagged that wherever it appears so you can weigh it accordingly.

All 10 approaches, at a glance

RankMethod / ToolBest forFromRating
01Ryze AI WinnerAI-native competitive intel + campaign actionFlat fee4.9/5
02Meta Graph API (native)Developers building custom pipelinesFree4.2/5
03Meta Graph API ExplorerTesting queries without writing codeFree4.0/5
04Apify Facebook Ads Library ScraperNo-code bulk scraping + exportFree tier / $49/mo4.4/5
05ScrapeCreators Ad Library APIDeveloper-friendly REST wrapper$0.001/req4.3/5
06Windsor.ai Meta ConnectorAutomated ELT into BI toolsFrom $19/mo4.5/5
07Apidog (API testing)Prototyping and documenting Graph API callsFree tier4.2/5
08AdManage.aiCompetitor research + agency reporting£499/mo4.3/5
09PhantombusterNo-code scheduled ad scraping workflowsFrom $56/mo4.1/5
10Social Science One API AccessAcademic / policy research on political adsFree (approved researchers)4.0/5

Get a free instant audit

Get a free, instant read on your paid ads or SEO — and fix it right away.

Paid ads audit

  • Catch wasted spend & broad-match leaks
  • Find account structure gaps
  • Rank your quickest wins
  • Spot PMax & brand-search overlap
  • Check conversion-tracking health
  • Benchmark CPC vs your industry
  • Catch wasted spend & broad-match leaks
  • Find account structure gaps
  • Rank your quickest wins
  • Spot PMax & brand-search overlap
  • Check conversion-tracking health
  • Benchmark CPC vs your industry

Free · no credit card · instant

SEO audit

  • Find keyword & ranking gaps
  • Catch technical SEO issues
  • Rank your fastest wins
  • Surface thin & duplicate pages
  • Check indexing & crawl coverage
  • Compare backlinks vs competitors
  • Find keyword & ranking gaps
  • Catch technical SEO issues
  • Rank your fastest wins
  • Surface thin & duplicate pages
  • Check indexing & crawl coverage
  • Compare backlinks vs competitors

Free · no credit card · instant

The rest of the field

Methods #2–#10, tested and ranked

02Best for developers building custom data pipelines

Meta Graph API (native endpoint)

The foundation of every approach in this list is the official Meta Graph API endpoint: https://graph.facebook.com/v20.0/ads_archive. You pass query parameters — search_terms, ad_reached_countries, ad_active_status, and a fields list including ad_creative_body, spend, impressions, and ad_delivery_start_time — and you receive paginated JSON. No special permissions are needed beyond a standard user or system-user access token.

The reality check: building a production-grade pipeline means writing pagination loops using after cursors, refreshing long-lived tokens before they expire (60-day default), and handling Meta’s rate limits gracefully. For a solo marketer that is weeks of engineering; for a team with a developer, it is the most flexible and cost-effective foundation. See our guide on connecting the Ad Library to Claude via MCP for an accelerator pattern on top of this endpoint.

PricingFree — standard Meta developer account required, no per-request cost
ProsOfficial, stable, returns structured JSON, supports all query parameters, free at any scale
ConsRequires token management, pagination loops, rate-limit handling, and engineering time; non-EU commercial ad data is limited
VerdictBest for engineering teams who need full control over a custom pipeline and can invest the setup time
03Best for testing and prototyping API queries without writing code

Meta Graph API Explorer

The Meta Graph API Explorer is the fastest path to your first successful ads_archive response. You authenticate with your Facebook account, select your app, paste the endpoint URL, add your query parameters, and hit “Submit.” The response JSON renders inline and you can inspect field names, understand the cursor pagination structure, and confirm which fields are actually returned for your token’s permission level — all in under five minutes.

It is not a research tool in any production sense. Each query is manual, there is no loop for pagination, and you cannot schedule or export results. Think of the Explorer as your debugging environment before you write a Python or JavaScript script, or before you hand requirements to a developer. It is step one of the MCP-based Ad Library workflow, not the whole workflow.

PricingFree — available at developers.facebook.com/tools/explorer
ProsBrowser-based, instant feedback, no code required to test queries, easy token generation
ConsManual only, not scriptable, no pagination UI, not suitable for production data pulls
VerdictBest for learning the API, verifying field names, and sanity-checking query syntax before you build

Why this matters

Every method below this line surfaces competitor ad data. Ryze AI is the only option in this list that also acts on what it finds — automatically adjusting your Meta campaigns in response to competitive signals, 24 hours a day. Learn more at get-ryze.ai.

04Best no-code option for bulk ad data export

Apify Facebook Ads Library Scraper

Apify’s Facebook Ads Library Scraper sidesteps the entire token-and-permission setup by acting as a browser automation layer rather than a direct API client. You paste an Ads Library URL — a brand’s page URL, a search results URL, or a filtered library view — and the Actor scrapes the dynamically loaded content, handling JavaScript rendering and infinite scroll automatically. Results export to JSON, CSV, or Excel in minutes.

Because ads on the Ad Library UI are loaded dynamically after user interaction, HTML-only scrapers fail; Apify’s approach handles this correctly. The trade-off is that you are working with scraped rather than API-native data, which means occasional gaps when Meta changes its frontend, and per-run compute costs that can add up for high-frequency monitoring. For campaign teams who want data in Google Sheets or a Slack alert without writing a line of code, it is the fastest path to production.

PricingFree tier (limited compute); paid from $49/mo on the Starter plan
ProsNo Meta app or token needed, exports to JSON/CSV/Excel, integrates with Make and Zapier, handles JavaScript-rendered content
ConsNot official Meta data; may lag behind real-time; subject to platform changes; compute credits consumed per run
VerdictBest for non-technical marketers who need bulk competitor ad exports without API setup
05Best developer-friendly REST wrapper for the Meta Ad Library

ScrapeCreators Ad Library API

ScrapeCreators offers a purpose-built REST API on top of the Meta Ad Library with three core endpoints: GET /v1/facebook/adLibrary/search/ads for keyword search, GET /v1/facebook/adLibrary/ad for individual ad details, and GET /v1/facebook/adLibrary/ad/transcript for video ad transcripts. Authentication is a single API key rather than Meta’s OAuth flow.

The search endpoint caps at around 1,500 results for GET requests; beyond that, you switch to POST and pass parameters in the body — a documented quirk worth knowing before you hit the ceiling in production. The transcript endpoint is genuinely useful for competitive creative analysis: you can programmatically extract voiceover scripts from any video ad in the library. At fraction-of-a-cent-per-request pricing, costs are predictable for moderate research volumes. Pair it with an AI layer via MCP to turn transcripts into creative briefs automatically.

PricingPay-as-you-go from approximately $0.001 per request; free trial credits included
ProsClean REST endpoints for ad search, ad details, and video transcripts; real-time data; simple API key auth
ConsThird-party dependency, per-request cost at scale, transcript endpoint credits only charged on success
VerdictBest for developers who want a clean wrapper API without managing Meta OAuth and token refresh

From competitor ad data to better campaigns, on autopilot.

  • Monitors Meta Ad Library for competitor signals 24/7
  • Automatically adjusts your campaigns based on what it finds
  • Covers Google, TikTok, LinkedIn + 4 more platforms too

2,000+

Marketers

$500M+

Ad spend

23

Countries

06Best for automated ELT into BI and reporting tools

Windsor.ai Meta Connector

Windsor.ai is a managed ELT connector that handles the parts of the Meta Ads API that most marketers dread: OAuth 2.0 authentication, token refresh, pagination, and schema normalization. You connect your Meta Business Manager account, select which fields to pull, and Windsor routes clean data to your chosen destination — Google Sheets, Looker Studio, BigQuery, Tableau, and more than 50 others.

For the Ad Library specifically, Windsor is better suited to monitoring your own paid performance data than building a competitor research pipeline. Spend and impression ranges from the Ad Library are broad rather than precise, and Windsor’s real strength is in the Marketing API’s performance metrics. That said, for teams who want a low-maintenance Meta data pipeline with zero infrastructure to manage, it is excellent value. Complement it with a dedicated Ad Library tool for competitive research.

PricingFrom $19/mo (scales with data volume); free trial available
ProsManaged OAuth and token refresh, direct connectors to BigQuery, Looker Studio, Sheets, and 50+ destinations, no engineering needed
ConsPrimarily for your own Meta Ads performance data; Ad Library research data is a secondary use case
VerdictBest for performance marketers who want Meta Ads API data flowing automatically into their dashboards without writing a pipeline
07Best API testing and documentation tool for Graph API prototyping

Apidog

Apidog sits in the same category as Postman — a visual environment for building, testing, and documenting HTTP requests. For Meta Ads Library API work, the workflow is: create a GET request, set the URL to https://graph.facebook.com/v20.0/ads_archive, add your query parameters as key-value pairs (search_terms, ad_reached_countries, fields, access_token), hit Send, and inspect the JSON response in a structured viewer.

You can save example responses for documentation, test multiple parameter combinations side by side, and export a collection to share with teammates. It does not replace a production pipeline — every query is still manual — but for validating your field selection and understanding pagination cursor structure before writing code, it is cleaner than the native Graph API Explorer. Think of it as a step up from the Explorer for teams who collaborate on API design.

PricingFree tier; paid plans from $9/mo per member
ProsClean visual request builder, save and share example responses, works with any REST endpoint including ads_archive
ConsIt is an API testing tool, not a data extraction tool — you still need to build the pipeline yourself
VerdictBest as the development environment for teams building a custom Meta Ads Library API integration
08Best for agencies combining competitor research with campaign management

AdManage.ai

AdManage.ai positions itself explicitly around the insight that the Meta Ads Library API is “one of the most underutilized competitive intelligence tools available to marketers.” Its platform wraps the research workflow — identity verification, app setup, token management, and query construction — and routes findings into Google Sheets, Zapier automations, and Make.com scenarios that fit inside existing agency reporting stacks.

The fixed monthly pricing model is its strongest differentiator for agency use: unlike per-request tools, costs do not scale with research volume, which matters when you are running competitor sweeps across dozens of client verticals every month. The platform covers the full journey from pulling ads to building client-ready reports, though teams with a developer resource may find the native API approach plus a BI connector (Windsor.ai, for example) cheaper at high volumes.

Pricing£499/mo in-house plan; £999/mo agency plan; fixed monthly pricing regardless of test volume
ProsIntegrates Ad Library research with Google Sheets, Drive, Zapier, and Make; fixed pricing removes per-query cost unpredictability
ConsUK-centric pricing, higher monthly commitment, requires onboarding to get full value
VerdictBest for agencies who want to bake competitor ad research into client reporting workflows at a predictable cost
09Best for no-code scheduled ad monitoring workflows

Phantombuster

Phantombuster takes a browser-automation approach to Ad Library data, similar in spirit to Apify but with a workflow-builder interface aimed at non-technical users. You configure a “Phantom” (an automation recipe), set a schedule, point it at an advertiser page or search URL, and Phantombuster extracts ad data on a recurring timer — daily, weekly, or hourly — pushing results to Google Sheets or a webhook.

For ongoing competitive monitoring — watching when a competitor launches new creative or changes its messaging — the scheduled approach is genuinely useful. The risk is brittleness: Meta’s frontend changes periodically break automation-based scrapers, and Phantombuster’s Phantom library depends on community-maintained recipes. For research that needs to run reliably for months without maintenance, the native API or a managed connector is more durable. For fast setup and good-enough reliability, Phantombuster earns its spot.

PricingFrom $56/mo (Starter); 14-day free trial
ProsScheduled Phantoms run on a timer, exports to Google Sheets, easy workflow builder, no-code
ConsBrowser automation approach means Facebook changes can break Phantoms; compute slot limits on lower plans
VerdictBest for marketers who want set-and-forget competitor ad monitoring without writing scripts
10Best for academic and policy research on political ad data

Social Science One API Access

Social Science One provides the most comprehensive programmatic access to Meta’s political and issue ad data, established through a formal partnership with Facebook and described in the Ad Library API Codebook (published April 2019, updated periodically). Approved researchers receive an access key that unlocks the full political ad dataset — including spend, reach estimates, targeting demographic breakdowns, and funding entities — going back to May 2018 in the US.

This is explicitly a research and transparency instrument, not a marketing tool. The application process can take several weeks, and approved access is restricted to academic, journalistic, or policy research. If you are a performance marketer trying to understand competitor creative strategies, this is not the right tool — the native Graph API or a third-party wrapper will serve you better. But for anyone studying how political advertising shapes elections or public discourse, the Social Science One dataset is unmatched in depth. See also our overview of how AI connects to ad platform APIs for broader context.

PricingFree for approved researchers; requires application to Social Science One
ProsFull political ad dataset access, scholarly-grade data, backed by Facebook partnership, includes spend and reach data
ConsApplication required, approval can take weeks, restricted to non-commercial research use, not for marketing practitioners
VerdictBest for journalists, academics, and policy researchers studying political advertising at scale
Daniel K.

Daniel K.

Head of Paid Social
DTC Apparel Brand

★★★★★

We were manually pulling competitor ads from the library every Monday morning. Ryze automated the whole thing — and started adjusting our Meta campaigns based on what it found. CPA dropped 28% in the first month.”

-28%

CPA reduction

4 weeks

Time to result

0

Manual pulls/week

How do you choose the right method for accessing Facebook Ad Library data?

With 10 methods ranging from free to enterprise, the decision comes down to three variables: your technical resource, your research frequency, and whether you want data alone or data plus campaign action. For background on what the Ad Library actually exposes, see our Meta Ads Library guide; for the platform that acts on what you find, the best ad management tools of 2026 and the top AI tools for Meta Ads management.

Decision 1

Do you have an engineer, or are you doing this yourself?

  • Have a developer: use the native Graph API endpoint for full control and zero per-request cost
  • No developer: Apify Scraper, ScrapeCreators, or Phantombuster are no-code or low-code entry points
  • Want API testing before committing: Graph API Explorer or Apidog to validate queries first

Decision 2

How often do you need fresh data?

  • One-off research: Graph API Explorer or Apify on demand
  • Weekly monitoring: Phantombuster scheduled runs or ScrapeCreators with a cron job
  • Real-time, continuous: Ryze AI or a native API pipeline with a scheduler and managed token refresh

Decision 3

Do you want to act on the data, or just store it?

  • Just store and analyze: Windsor.ai into BigQuery or Sheets, or Apify CSV export
  • Build reports for clients: AdManage.ai with its fixed-fee agency plan
  • Automatically respond in your campaigns: Ryze AI — the only option here that closes the loop from competitor signal to campaign action

The bottom line: if you have a developer and need maximum flexibility, the native Meta Ads Library API endpoint is free and comprehensive. If you want results today without writing code, Apify or ScrapeCreators gets you there in an hour. And if the goal is not just knowing what competitors are doing but actually beating them — automatically adjusting bids, budgets, and creative rotation in response — Ryze AI is the only tool in this list that does both. It connects to the Meta Ads Library and your live campaigns simultaneously, closing the loop that every other tool leaves open.

1,000+ marketers use Ryze

State Farm
Luca Faloni
Pepperfry
Jenni AI
Slim Chickens
Superpower

Automating hundreds of agencies

Speedy
Human
Motif
Broadplace
Directly
Caleyx
G2★★★★★4.9/5
TrustpilotTrustpilot rating

Frequently asked questions

What is the Meta Ads Library API and how does it differ from the Marketing API?

The Meta Ads Library API (endpoint: graph.facebook.com/v20.0/ads_archive) is a read-only public transparency tool that lets you query any advertiser's active and recently inactive ads on Facebook and Instagram. The Marketing API is a separate, private API for managing your own campaigns — creating ads, adjusting budgets, pulling your performance data. Never confuse the two: Ad Library API is for competitor research and transparency; Marketing API is for campaign management.

Do I need special permissions to use the Meta Ads Library API?

For political and regulated-category ads, no special permissions are needed beyond a standard Meta developer app and a user or system-user access token. For EU commercial ads (post-DSA 2023), the same token works and data coverage is broad. For non-EU commercial ads, the API may return limited results compared to the web UI. You do not need to apply for Marketing API access or go through App Review to use the Ad Library endpoint.

How do I handle pagination in the Meta Ads Library API?

The API returns results in pages using cursor-based pagination. Each response includes a paging object with a cursors.after field. To get the next page, add after=<cursor_value> to your next request. Continue looping until the response contains no next cursor. For large result sets — thousands of ads — build a while loop in Python or JavaScript that checks for the presence of a next cursor before each iteration, and add a short sleep between requests to respect Meta's rate limits.

Why does the Meta Ads Library API return less data than the web UI?

Two main reasons. First, non-EU commercial ad data is more restricted via the API than the browser interface by design — Meta limits programmatic access to commercial ads outside of DSA-regulated regions. Second, spend and impression figures are always returned as ranges (e.g., $1,000–$4,999) rather than exact values, even in the UI. If you need richer coverage for non-EU ads, a browser-automation scraper like Apify may surface more than the API returns directly.

What query parameters does the Meta Ads Library API support?

The key parameters are: search_terms (keyword or phrase), ad_reached_countries (ISO country codes, required), ad_active_status (ACTIVE, INACTIVE, or ALL), fields (comma-separated list of data points to return — e.g. ad_creative_body, spend, impressions, ad_delivery_start_time, page_name), and access_token. Optional parameters include search_page_ids to search by Facebook Page ID, ad_type to filter by format (IMAGE, VIDEO, etc.), and limit to set page size up to 1,000. Always include a fields parameter or the response will return only default fields.

How does Ryze AI use Meta Ads Library data compared to manual API access?

Manual API access gets you JSON that you then have to analyze, interpret, and translate into campaign changes yourself. Ryze AI connects to the Meta Ads Library and your live Meta Ads account simultaneously — it monitors competitor ad signals continuously, identifies patterns in what is scaling versus what is pausing, and automatically adjusts your campaigns in response: creative rotation, audience adjustments, budget reallocation. Users average a 31% improvement in paid ad performance within 6 weeks, without any manual API work.

Access Meta Ad Library data with AI

#1 of 10 · flat fee · free trial

Live results across
2,000+ clients

Paid Ads

Avg. client
ROAS
0x
Revenue
driven
$0M

SEO

Organic
visits driven
0M
Keywords
on page 1
48k+

Websites

Conversion
rate lift
+0%
Time
on site
+0%
Last updated: Jul 28, 2026
All systems ok
Ryze AI is a service operated by Meow AI, LLC. © 2026 Meow AI, LLC. All rights reserved.