vexqo Request access
Part of the vexqo ecommerce data API

Meta Ad Library API for ad intelligence tools

Send an advertiser's page ID or its Ad Library URL. vexqo returns the ads the public Facebook Ad Library shows for it as JSON, with every creative card, the run dates, the advertiser details and the product each ad links to.

Blocked and failed requests are never billed.

One ad from a public Ad Library page

The adactive

AdvertiserSephora

Ad ID2087003595270151

FormatDynamic product ad, 6 cards

Running since22 Oct 2026

PlatformsFacebook, Instagram, Threads

Spendnull

The product its first card links toverified

ProductTOM FORD Black Orchid Eau de Parfum

VariantSKU 1008572, 1 oz / 30 mL

PriceUSD 125.00

Captured logged out on 18 November 2026.

verified_productThe ad record, trimmed1 of 6 cards shown

{
  "adArchiveID": "2087003595270151",
  "pageName": "Sephora",
  "isActive": true,
  "spend": null,
  "snapshot": {
    "displayFormat": "DPA",
    "cards": [
      {
        "title": "TOM FORD Black Orchid Eau de Parfum with Black Truffle & Ylang Ylang 1 oz/ 30 mL",
        "linkUrl": "https://www.sephora.com/product/black-orchid-P183301?skuId=1008572&om_mmc=paid_social_Facebook_DPA"
      }
    ]
  },
  "ecommerceData": [
    {
      "name": "Black Orchid Eau de Parfum with Black Truffle & Ylang Ylang",
      "offers": { "price": "125.00", "priceCurrency": "USD" }
    }
  ]
}

What an ad record holds

One JSON record per ad, with the advertiser's page details beside it. A value the library does not publish stays null.

The product behind the ad

An ad record says what was shown. For a commerce ad, vexqo also reads the page it links to, so you know which product it sold and at what price.

How the match works

  • vexqo follows the link the ad card carries, including its SKU parameter.
  • The price and image come from the variant the ad selected, not the default one or the cheapest one.
  • Prices are decimal strings with the currency code the retailer states.
  • A link to an app or a landing page returns an empty list, not a guessed product.

Retailers are added on request, starting with a sample from your own advertisers.

Three ads from one advertiser

2087003595270151product

TOM FORD Black Orchid Eau de Parfum, 1 oz / 30 mL

SKU 1008572, USD 125.00

2345600249520402product

CLINIQUE Acne Solutions Clarifying Lotion, 6.7 oz / 200 mL

SKU 1027473, USD 23.00

1229350099285014no product

App landing page

Returned as an empty list

From Sephora's public Ad Library page on 18 November 2026. Each price is the retailer's price at capture time, not the price when the ad first ran.

What the public Ad Library does not show

vexqo returns what Meta publishes and leaves the rest null. It does not estimate.

Meta's official Ad Library API

vexqo is not a Meta API. This is what Meta's documentation says about the official route, next to what vexqo does.

The official route

  • Meta's Ad Library API returns ads about social issues, elections or politics. Other ads come back only if they reached the EU.
  • Access needs a confirmed identity and an access token from a Meta developer app.

As Meta documented it, checked in November 2026.

What vexqo does

  • Reads the public Ad Library page, logged out, with no Meta account.
  • Returns the ads that page shows for an advertiser, commercial ads included.
  • Reports its coverage with every capture.

This is web scraping. Meta has not approved it. Check that your intended use fits their terms.

Questions

Something else? Write to [email protected].

Is this Meta's official Ad Library API?

No. vexqo reads public Ad Library pages, logged out, with no Meta account. It is web scraping, with no approval from Meta and no claim of one. Check that your intended use fits their terms.

Can I search ads by keyword?

Not today. You send an advertiser's page ID or its Ad Library URL. If your product needs keyword search, say so in your request.

Do you return every ad an advertiser runs?

The coverage report with each capture says how many ads the library page showed and how many records came back. For advertisers with thousands of ads, we agree the depth in the pilot.

Do you estimate spend or performance?

No. A value the library does not publish stays null.

Which retailers can you match ads to?

The sample matches ads to Sephora product pages. Other retailers are added on request, starting with a sample from your own advertisers.

How often can you re-check an advertiser?

Tell us the advertisers and the schedule you need. We size it in the pilot and report what each run captured.

What does it cost?

Prices are quoted per 1,000 verified results. Blocked requests, retries and failed parses are our cost, and you set the monthly cap.

What else does vexqo cover?

The same API returns marketplace listings through the eBay sold listings API. The ecommerce data API page lists every source.

Send us your advertisers

Tell us the advertiser pages and how often you need them checked. We reply with a sample from those pages, the gaps marked, and a scope for a pilot.

  • A sample from your own advertisers before any pilot
  • Blocked and failed requests never billed
  • You set the monthly cap

Request access

How you want it

We use these details to reply to your request and for nothing else.