Data APIs / Facebook & Meta ads

Facebook Scraper API

Page profiles and active advertising in one place: pull a page's likes, follows, category, website, and contact details, then list the ads it is running from the Meta Ad Library — creatives, copy, start dates, and platforms.

Get 10 free creditsAPI reference

From 1 credit per call · cache hits free · failed calls refunded · no card for the free tier

One request, structured data and markdown

Every endpoint accepts format=json, markdown, or both. Use the JSON to filter and store; drop the markdown straight into a prompt.

  • Page: name, page id, category, likes, follows, website, address, phone, email
  • Ads: every active creative with primary text, headline, CTA, media, start date, platforms
  • Resolve a page slug or URL to its numeric page id automatically
  • Paginated ad results with max_pages
request
curl 'https://scrapewhale.dev/api/v1/ads/meta?slug=nike&max_pages=1&format=json' \
  -H 'Authorization: Bearer <api-key>'
response · json
{
  "extractor": "meta-ads",
  "creditsCharged": 2,
  "data": {
    "page_id": "15087023444",
    "count": 30,
    "ads": [
      {
        "ad_archive_id": "1234567890",
        "start_date": "2026-08-12",
        "publisher_platform": ["FACEBOOK", "INSTAGRAM"],
        "snapshot": { "body": { "text": "Run your first 5K with…" }, "cta_text": "Shop now" }
      }
    ]
  }
}

Abridged; each ad carries the full Ad Library snapshot.

Endpoints

2 endpoints in this family. Full parameter reference and a try-it console are in the API docs.

get/api/v1/social/facebook/page1 credit

Facebook page details

Page name, category, followers/likes, website, phone/email/address when public, page id (usable with /api/v1/ads/meta), and whether the page is currently running ads.

slug
Facebook page slug, e.g. nike for facebook.com/nike.
url
Full Facebook page URL (alternative to slug).
Try in Playground
get/api/v1/ads/meta2 credits

Ads a Facebook page is running (Meta Ad Library)

Active and recent ads for a Facebook page from the Meta Ad Library, including creative text, CTA, format, dates, and the raw ad nodes in data. Identify the page by numeric page_id, by page slug, or by page url — slugs/URLs are resolved to the page id internally at no extra credit cost. total_count reports the full Ad Library count even when fewer ads are fetched.

page_id
Numeric Facebook page id (fastest — skips resolution).
slug
Facebook page slug, e.g. nike for facebook.com/nike.
url
Full Facebook page URL.
max_pages
Pages of 30 ads to fetch (1–10, default 3).
Try in Playground

What teams use it for

Competitor ad monitoring

Diff a competitor's active ads weekly to see new angles, offers, and creatives.

Prospecting

Qualify leads by whether they advertise at all and how many ads they run.

Agency reporting

Automate the "what are they running" slide.

Frequently asked questions

Related APIs

Google Ads Transparency Center API

Every ad a domain is running in the Google Ads Transparency Center — formats, first/last shown, regions, and creative previews — as JSON and markdown via a single API call.

Instagram Scraper API

Get Instagram profile data by username: followers, following, bio, verification, links, and avatar. No login, no Graph API approval. JSON + markdown.

Company Data API — one-call brand dossier

One call returns a brand dossier for any domain: logo, estimated traffic, domain authority, active Google ads, homepage as markdown, plus optional organic, backlinks, registration, and agent-readiness.

Start with 10 free credits

No card required. Run any endpoint from the Playground, then create an API key when you are ready to automate.

Create free accountSee pricing