Can I see spend and impressions?

The API returns estimated spend bands, reach ranges and placement mix. Exact figures are only published for political and issue ads.

Can I search by advertiser name?

Yes. Pass a page name or page ID and the advertiser endpoint returns every ad that page is currently running, grouped by creative.

Do you keep a history of creatives?

Search responses carry first seen and last seen dates. Poll a watchlist on a schedule, or use a monitor webhook, to build your own historical archive.

Why does ads search cost more credits?

Each result carries a full creative object rather than an identifier, so a page of ads search is priced at five credits instead of one.

Facebook Ads Library API

Facebook Ads Library API for every active ad, creative included.

Search the Meta ads library by advertiser, keyword or country and read the full creative, call to action, landing page and first seen date as structured JSON.

See pricing

Public data only
One key, every platform
Cancel anytime

api.socialmediaapi.lol200 OK

GET /v1/facebook/ads/search?query=nike&country=US&limit=25
Authorization: Bearer sk_live_...

{
  "data": {
    "query": "nike",
    "ads": [ { "page_name": "Nike", "creative": { "cta": "SHOP_NOW" } } ],
    "total_estimate": 2184
  },
  "credits_used": 5
}

12.4Brequests served in the last year

38,000+developers building on the API

99.95%rolling 12 month uptime

380msmedian response time

Ad intelligence

See what your market is paying to say.

The ads library is the only place where competitor messaging, creative angles and calls to action are all public. Reading it by hand does not scale past a handful of advertisers, which is exactly why an API exists.

Search by advertiser, keyword or country, then pull the creative detail for each ad: headline, body copy, call to action, landing page, media and the date the ad was first seen. Grouping by advertiser turns a flat list into a ranked view of who is spending into a keyword right now.

Ads Library endpoints

Ad search by advertiser, keyword, country or date range
Every ad a page is currently running, grouped by creative
Creative detail with copy, CTA, landing page and media
Estimated spend bands, reach ranges and placement mix
First seen and last seen dates for longevity analysis

Endpoints

Facebook Ads Library API endpoints

Same auth header, same response envelope, cursor pagination on every list.

Facebook Ads Library API

Details

Every ad in the Meta ads library, with creatives, advertisers and spend signals.

GET/v1/facebook/ads/search

Search the ads library by advertiser, keyword, country or date range.

query
country
active

GET/v1/facebook/ads/advertiser

Every ad a page is running, grouped by campaign and creative variant.

page_id
creatives

GET/v1/facebook/ads/creative

Copy, call to action, landing page, media and first seen date.

copy
cta
landing_page

GET/v1/facebook/ads/insights

Estimated spend bands, reach ranges and platform placement mix.

spend
reach
placements

Playground

Try any endpoint before you write a line of code.

Pick an endpoint, set the parameters and run it. Sign in with Google to unlock the playground, and your subscription decides whether you land here or on pricing.

GET https://api.socialmediaapi.lol/v1/facebook/profile?handle=zuck&fields=about%2CfollowersJSON

Endpoint

Public profile fields for any handle: bio, follower count, work history and verified status.

HandleFields

Sign in with Google to unlock the playground. Accounts without an active plan are sent to pricing, where every plan includes the full sandbox and a live API key.

sandbox response200 OK

Response bodynot sent yet

{
  "status": "idle",
  "message": "Run the request to see the response shape returned by this endpoint.",
  "endpoint": "/v1/facebook/profile"
}

Read-only access. We never post, like or follow on your behalf.
Credit based pricing, so one page of data costs one credit.
Public data only, sourced from the platforms own public surfaces.

Creative analysis

Turn a wall of ads into themes you can act on.

Because copy comes back as plain text, you can cluster headlines and body copy into themes and watch how those themes shift week over week. An advertiser that has run the same creative for ninety days is telling you something very different from one that rotates every three days.

Placement mix and estimated spend bands add the second half of the picture: not just what a competitor says, but roughly how much reach is behind it and where it runs.

Common ads workflows

Competitor creative monitoring
Ad longevity and fatigue analysis
Landing page and offer teardown
Keyword level spend estimation
Creative brief generation from live examples

Why socialmediaapi.lol

Why teams pick our Facebook Ads Library API

The parts of a social data pipeline you would otherwise build and maintain yourself.

Full creative payload

Headline, body, CTA, landing page and media in one object.

Country aware search

Filter the ads library by country to compare regional strategy.

Longevity signals

First seen and last seen dates expose ad fatigue at a glance.

Spend and reach bands

Estimated spend ranges and reach bands per ad set.

Advertiser grouping

Every ad a page runs, sorted into creative variants.

Monitor webhooks

Get pushed only when a watched advertiser ships something new.

Operations

Scheduled, so you stop checking manually.

Poll a watchlist of advertisers on a schedule and diff the results, or subscribe to a monitor webhook and get pushed only when a new ad appears. Either way the payload is identical to what the REST endpoint returns.

Ads search is the heaviest endpoint because each result carries a full creative, which is why it is priced at five credits per page. Everything else on the platform starts at one.

Code examples

Three lines to your first response.

Send an API key, get JSON back. No OAuth dance, no browser automation and no session to keep warm.

Bearer token auth, one header for every endpoint
Cursor pagination on every list response
Errors carry a machine readable code and a retry hint
Sandbox and live modes share the same contract

curl -G "https://api.socialmediaapi.lol/v1/facebook/profile" \
  -H "Authorization: Bearer $SOCIALMEDIAAPI_KEY" \
  -d "handle=zuck" \
  -d "fields=about%2Cfollowers"

FAQ

Facebook Ads Library API questions

Every ad Meta is required to publish, which covers ads about social issues, elections and politics plus all ads shown to EU audiences. Coverage outside those categories depends on what the advertiser has published.

Start using the Facebook Ads Library API today.

Create an account, generate a key and make your first request in the next five minutes.

Compare plans

Public data only
Cancel anytime
Human support

Keep exploring

Facebook Ads Library API for every active ad, creative included.

See what your market is paying to say.

Ads Library endpoints

Facebook Ads Library API endpoints

Facebook Ads Library API

Try any endpoint before you write a line of code.

Turn a wall of ads into themes you can act on.

Common ads workflows

Why teams pick our Facebook Ads Library API

Full creative payload

Country aware search

Longevity signals

Spend and reach bands

Advertiser grouping

Monitor webhooks

Scheduled, so you stop checking manually.

Three lines to your first response.

Facebook Ads Library API questions

Start using the Facebook Ads Library API today.

Related APIs and guides

Facebook API

Instagram API

Facebook Groups API

Facebook Pages API

Social Media API

Facebook Ads Library API for every active ad, creative included.

Ads Library endpoints

Common ads workflows

Full creative payload

Country aware search

Longevity signals

Spend and reach bands

Advertiser grouping

Monitor webhooks

Which ads appear in the library?

Can I see spend and impressions?

Can I search by advertiser name?

Do you keep a history of creatives?

Why does ads search cost more credits?

Start using the Facebook Ads Library API today.

Ship notes, once a month

Facebook API

Instagram API

Facebook Groups API

Facebook Pages API

Social Media API