Facebook Ad Library

Facebook Company Ads API

Ads for one Meta page — active by default, cursor through the HTML batch, same envelope as /facebook/search.

List ads for one Meta page/advertiser. Prefer pageId (or libraryUrl) from /facebook/search-companies. status defaults to ACTIVE so the first page is what the page is running now — use ALL for historical/inactive variants (collation siblings share copy and consume a limit slot). A limit above 30 also scrolls the library past Meta's first ~30 ads, up to ~70–80 per call (~45–60s). nextCursor pages that fetched batch; hasMore is true only when nextCursor is present, and null with truncatedReason=library-page when the batch is spent but Meta still has more ads. searchResultsCount is Meta's upstream match count; retrievableCount is how many ads this cursor walk can actually return. A search-companies libraryUrl with active_status=all is rewritten to the requested filter. Flat 2 credits native.

Docs: https://captapi.com/apis/facebook-ad-library-company-ads

get/v1/ad-library/facebook/company-ads

Request

  • Base URL: https://api.captapi.com
  • URL: https://api.captapi.com/v1/ad-library/facebook/company-ads
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

urlstring required

pageId from /search-companies (preferred), libraryUrl, vanity page URL (facebook.com/nike/), or Ad Library URL with view_all_page_id. Do not pass profileId from facebook.com/{digits}/ when it differs from pageId. The URL platform must match this endpoint's platform. Do not pass cross-platform URLs, e.g. YouTube to TikTok, Instagram to Facebook, LinkedIn to X/Twitter, or Pinterest to Rumble.

countrystring

Two-letter ISO country code. Default US. Non-ISO codes are a definitive 400 INVALID_COUNTRY.

limitinteger

Max items to return (default 20, max 200). Flat 2 credits per call on the native path; the extended fallback bills per returned ad.

status'ALL' | 'ACTIVE' | 'INACTIVE'

Ad delivery status: ACTIVE (default), INACTIVE, or ALL. Use ACTIVE for "what are they running now?".

cursorstring

Pagination cursor from a previous nextCursor. Pages through the current Meta HTML result batch.

cacheboolean

Set true to serve from the 24h response cache (0 credits on hit). Default false — always fetch fresh.

Response

Success. The data object for this endpoint.

successunknown required

Changes

No recorded changes to this operation across all 3 revisions of this API.