Ads

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.

Provide exactly one of: page_id, slug, url.

Credits: 2 (refunded on failure).

get/api/v1/ads/meta

Request

  • Base URL: https://scrapewhale.dev
  • URL: https://scrapewhale.dev/api/v1/ads/meta
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

page_idstring

Numeric Facebook page id (fastest — skips resolution).

slugstring

Facebook page slug, e.g. nike for facebook.com/nike.

urlstring uri

Full Facebook page URL.

max_pagesinteger

Pages of 30 ads to fetch (1–10, default 3).

format'json' | 'markdown' | 'both'

Response shape: "json" (structured data only), "markdown" (markdown only), or "both".

Response

Success.

idstring required
status'completed' required
extractorstring required

Extractor name, e.g. "traffic", "meta-ads", "instagram-profile".

titlestring nullable
sourceUrlstring nullable

Canonical public URL of the extracted source.

creditsChargedinteger required

0 when served from the shared cache.

cachedboolean

True when served from the shared extraction cache (free).

createdAtinteger required

Unix epoch milliseconds.

dataobject nullable

Raw structured payload from the source.

markdownstring

Clean markdown rendering of the payload.

Changes

No recorded changes to this operation across all 1 revision of this API.