Meta Ad Library API

Meta Ad Library API for
advertiser pages, ads and creative records.

Resolve the advertiser page first, then inspect the public ads tied to that exact source ID.

Try the Meta Ad Library API See a real response

150 free credits to start·No card required

GET/meta_ads/search-companies

monocrawl / meta_ads

Recorded response

Nike in Meta Ad Library page search

page_id: 15087023444
name: Nike
category: Sportswear Store
likes: 39,533,900
verified: true
ig_handle: nike

Selected public fields2026-09-21

Recorded excerpt. Values may change; missing fields stay null.

Structured JSONData you can work with

One API keyYour Monocrawl integrations

cURL · TypeScript · PythonStart in your own stack

The data

Meta Ad Library data,
ready to work with.

A brand name can match several pages in the Meta Ad Library. Search-companies returns page identifiers and public page context; the Nike result shown here includes a category, Instagram handle and source logo from one recorded response. Keep the page ID before requesting company ads, because a familiar name alone is not an advertiser key. An ad-detail request then opens one selected creative record. These operations support campaign research without assuming the search result itself contains ad copy or that every returned ad is still running. Monocrawl exposes the public records as JSON with the original identifiers intact.

Advertiser pages

Resolve a brand to returned page IDs and public page context.

brand → pages

Page ads

Inspect the available ad window for one selected page.

page ID → ads

Ad search

Find matching public ad records by query.

query → ads

Ad details

Open a particular ad using its source identifier.

ad ID → record

Request → response

From Meta Ad Library
to structured JSON.

Inspect selected fields from a recorded Meta Ad Library response for Nike in Meta Ad Library page search. Choose a language and use your own key to request current data.

1
Get your Monocrawl key
Create an account and collect your key.
2
Choose your inputs
Replace the example inputs with your own target. Send your key in the x-api-key header.
3
Use the returned JSON
Read the returned record from data. Check credits_used for the call’s confirmed credit usage.

Your requestGET /v1/meta_ads/search-companies

curl "https://www.monocrawl.com/v1/meta_ads/search-companies?query=Nike" \
  -H "x-api-key: mn_your_key_here"

What comes backdata excerpt

{
  "items": [
    {
      "page_id": "15087023444",
      "name": "Nike",
      "category": "Sportswear Store",
      "likes": 39533900,
      "verified": true,
      "ig_handle": "nike"
    }
  ]
}

Recorded 21 Sep 2026 for Nike in Meta Ad Library page search. Selected fields only; this is a historical snapshot.

Recorded response for the inputs shownTry the Meta Ad Library API

What you can build

What you can build
with Meta Ad Library data.

Use Meta Ad Library data in the products and workflows you’re already building.

Brand query
Matching public pages
Your advertiser list

Identify an advertiser page

Search a brand and retain the returned page ID before inspecting its public ads.

Explore this workflow

Page ID
Returned ads
Your creative watch

Review a page’s ads

Use that page ID to inspect the returned ad window and its source links.

Explore this workflow

Ad ID
Source record
Your evidence log

Record a particular ad

Open an ad by its source ID instead of assuming a search card contains every creative field.

Explore this workflow

Start with a working workflowIntegration guide

Meta Ad Library API pricing

Try the Meta Ad Library API for free.

Start with 150 free credits. Choose a paid plan when you need a monthly allowance.

Free

No card required

$0/ month

150 free credits to start

Try the endpoints your application needs, with your own API key.

Email verification required. Free usage limits apply. See limits

Starter

Monthly subscription

$29/ month

10,000 credits every month

More monthly credits for your Meta Ad Library integration and other supported platforms.

Explore the Starter plan

USD, before applicable tax. See pricing for subscription terms.

Compare all plans

Explore by data type

Meta Ad Library API endpoints

5 currently available operations. Open an endpoint for parameters, response details and pricing.

Listed credit prices are per request. Metered or variable-cost operations can settle differently; check the endpoint reference when budgeting.

Meta Ad Library documentation Try the Meta Ad Library API

Before you build

Meta Ad Library API questions,
answered.

Need to check a particular workflow?
Talk to us

Comparing providers for Meta Ad Library data?
Ad library APIs compared

Does a matching Meta page name identify the right advertiser?

Not by itself. This search returned several Nike-related pages. Use the returned page ID and inspect the page context before joining its ads.

Are returned Meta ads active now?

A saved response is a dated observation. Check the returned ad dates and request again before making a current activity claim.

What Meta Ad Library operations can I use?

The catalogue shows 5 currently available operations with their individual prices. Open an endpoint for its accepted inputs, returned fields and limitations.

How much does the Meta Ad Library API cost?

Start with 150 free credits. Paid subscriptions start at $29 per month for 10,000 credits, before applicable tax. Each operation has its own price. Check the endpoint reference for variable charges. Compare plans

How do I authenticate requests?

Use your Monocrawl API key in the x-api-key header. The endpoint reference lists any additional inputs needed for the operation. Authentication guide

What request limits apply?

Limits depend on your Monocrawl plan. The Free account ceiling is 600 requests per minute and 50 simultaneous requests. Endpoint capacity and Free daily protections also apply; these ceilings do not guarantee source throughput. Read the limits guide

What should I know about Meta Ad Library coverage?

A matching page name does not prove ownership of every related account; preserve the source page ID. Ad activity, creative availability and library coverage can change after an archived response.

Is Monocrawl affiliated with Meta Ad Library?

Monocrawl is an independent service. Third-party names identify data sources and do not imply a partnership or endorsement.