Skip to content

Gaurang18/adscrape-docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AdScrape — Meta Ad Library Intelligence Platform & API

Website API Docs Sign up free

AdScrape is the fastest way to search, monitor, and automate research on the Meta Ad Library (Facebook & Instagram ads). Use a polished dashboard for competitive research, or wire the same data into your product with a clean REST API — one account, one API key, no Graph API token, no proxy setup.

Live product: https://www.adscrape.in · API base: https://api.adscrape.in · Docs: adscrape.in/docs


Why AdScrape?

Most ad-intelligence tools make you choose between a UI and an API. AdScrape ships both on one account:

Capability Dashboard REST API
Keyword & brand search across 240M+ live Meta ads
Brand typeahead → Facebook Page ID resolution
Creative download (image / video)
Bookmarks & AI competitive briefs
Brand & keyword trackers + weekly intel reports
Cursor pagination up to 500 ads per call
Per-key usage logs & rate limits

1,000 free credits on signup — no credit card required.


Quickstart (60 seconds)

1. Get an API key

  1. Create a free account at adscrape.in/signup
  2. Open Settings → API Keys and create a key
  3. Copy your sk_live_… token (shown once)

2. Search Meta ads

curl -X POST https://api.adscrape.in/api/v1/search \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"nike","country":"US","max_results":25}'

3. Paginate the full result set

curl -X POST https://api.adscrape.in/api/v1/search/next \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"session_token":"SESSION_FROM_FIRST_RESPONSE","page_size":100}'

Repeat until has_more is false. See examples/ for Python and JavaScript clients.


What you can build

  • Competitive intelligence — monitor every ad a rival brand runs on Meta
  • Creative research — filter by country, media type, active status, and keyword
  • Sales enrichment — resolve a company name to its verified Facebook Page ID
  • Automated pipelines — drain a brand's full ad footprint into your data warehouse
  • Weekly competitor briefs — brand & keyword trackers email you new creatives automatically
  • Ad analysis — AI teardown of hooks, CTAs, and strategy (dashboard)

API overview

Method Endpoint Description
POST /api/v1/search Search by keyword, brand, or Ad Library URL
POST /api/v1/search/next Cursor pagination for the same session
POST /api/v1/suggestions Meta brand typeahead with Page IDs
GET /api/v1/ads/{archive_id} Full ad record
GET /api/v1/media/{archive_id} Download image or video creative
GET /api/v1/billing/credits Credit balance & ledger

Authentication: X-API-Key: sk_live_… on every billable request.

Full reference: adscrape.in/docs


Credit model

Action Cost
Search — per ad returned 1 credit
Suggestions — per result block 1 credit
Media download 2 credits
GET reads (ads, usage, billing) Free

Plans start at $49/mo (5,000 credits). Details: adscrape.in/pricing


Examples in this repo

Language Script What it does
Python examples/python/search_ads.py Search + paginate all results
Python examples/python/brand_suggestions.py Resolve brand → Page ID
Python examples/python/download_creative.py Save ad video/image
JavaScript examples/javascript/search_ads.mjs Search + paginate (Node 18+)
Shell examples/curl/examples.sh Copy-paste cURL recipes

Set your key once:

export ADSCRAPE_API_KEY="sk_live_your_key_here"

Dashboard features

Prefer clicking over coding? The AdScrape dashboard includes:

  • Discover — keyword & brand search with Meta-matching filters
  • Brand Spy — typeahead search with verification badges
  • Bookmarks — save winning creatives to collections
  • Trackers — weekly competitor intelligence in your inbox
  • Playground — test API calls without leaving the browser
  • Export — JSON & CSV download

AdScrape vs. raw Meta Ad Library

Meta Ad Library (native) AdScrape
Programmatic access ❌ No public API ✅ REST API + dashboard
Brand → Page ID lookup Manual clicking ✅ Typeahead API
Bulk export Tedious copy-paste ✅ Paginate 500 ads/call
Creative download Expiring CDN links ✅ Stable media endpoint
Competitor monitoring Manual re-checks ✅ Automated trackers
Graph API token required Often yes ❌ One AdScrape key

FAQ

Is AdScrape affiliated with Meta? No. AdScrape reads the same public transparency data the Ad Library shows in your browser. You are responsible for complying with Meta's Terms and applicable law.

Do I need a Facebook developer account? No Graph API token, app review, or proxy configuration. Sign up, create a key, and call the API.

What countries are supported? Any country Meta's Ad Library supports. Pass ISO country codes (e.g. US, IN, GB) in search requests.

Where is the OpenAPI spec? Interactive docs live at adscrape.in/docs.

Need help? Email contact@adscrape.in or use the contact form.


Related open-source tools

AdScrape also powers scrapers on Apify under ScrapeIO:

For a managed dashboard + API on Meta specifically, use AdScrape.


Links

Resource URL
Website https://www.adscrape.in
Sign up (free) https://www.adscrape.in/signup
API documentation https://www.adscrape.in/docs
Pricing https://www.adscrape.in/pricing
Brand Spy https://www.adscrape.in/brand-spy
Blog https://www.adscrape.in/blog

Built by AdScrape
Meta Ad Library intelligence — dashboard, API, and weekly competitor reports.

About

Official AdScrape docs & API examples — Meta Ad Library intelligence platform. https://www.adscrape.in

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors