Ad API: Every Type Explained (Management, Public, Third-Party)

An ad API is a programmatic interface to advertising data — either to manage your own Meta ad accounts, or to read public ads from the Facebook Ad Library. Marketers, agencies and analytics teams use ad APIs for dashboards, warehouses, and competitive intelligence. This guide explains the three kinds of Meta-related ad API and when to use each.

The three types of ad API

Management ad APIs

A management ad API lets you create campaigns, upload creatives, change budgets and pull performance metrics for ad accounts you own. For Meta, that is the Meta Marketing API — the ad API behind Facebook Ads Manager. It authenticates with OAuth, scopes per account, and is rate-limited per app.

Public ad APIs

A public ad API exposes ads visible in a public ad library. Meta's ads_archive endpoint is the main first-party public ad API; it is restricted to issue, election and political ads.

For commercial ads, there is no first-party public ad API. This is exactly why a third market exists.

Third-party ad APIs (for competitive intelligence)

A third-party ad API scrapes public ad libraries on your behalf and serves the data through a clean schema. AdScrape, BigSpy and SocialPeta all run an ad API behind their dashboards. A typical third-party ad API request:

curl -X POST https://api.adscrape.in/v1/search \
  -H "Authorization: Bearer $AD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"Nike","country":"US","active":true,"limit":50}'

Which ad API do you need?

• Running your own ads? Meta Marketing API.
• Researching political ad spend? Meta Ad API (ads_archive).
• Tracking competitors' commercial ads? Third-party ad API (AdScrape or similar).
• Building an analytics SaaS? Probably two of the above stitched together.

Ad API authentication: OAuth, app tokens and API keys

Management ad APIs all use OAuth — the user grants your app permission to act on their ad account. Public ad APIs use long-lived app tokens with platform-issued permissions (e.g. ads_archive on Meta). Third-party ad APIs use simple bearer keys you mint in the provider's dashboard. Mixing the three in one product means three different auth flows in your codebase.

Ad API rate limits to plan around

The AdScrape ad API in one minute

AdScrape's ad API is a REST endpoint over the Facebook Ad Library. Authenticate with a bearer token, POST a search payload, get JSON back. Free tier is 100 ad API calls per month; paid plans scale to 100k+. We also expose a brand comparison ad API endpoint that returns two competitors side-by-side, a feature no first-party ad API offers.

Ad API FAQ

What is an ad API?

An ad API is any programmatic interface to advertising data — your own ad accounts, public ad libraries, or scraped competitor data.

Is the Meta Ad API the same as the Meta Marketing API?

No. The Meta Ad API (ads_archive) returns public political ads. The Meta Marketing API manages your own ad accounts. Different scopes, different permissions.

Is there a free ad API?

Yes. The official Meta Ad API is free for political ads. AdScrape's ad API offers a free tier for commercial ads.

Can the Meta Ad API return commercial competitor ads?

Not via the official ads_archive endpoint — only political/issue ads. For commercial ads, use a third-party ad API such as AdScrape.

Do I need an ad API if I have a dashboard?

Only if you want to embed ad data elsewhere — a BI tool, a warehouse, an internal app or an LLM workflow. For one-off research, a dashboard is enough.