Skip to content
ShortVid API
Ad Intelligence Guide · $0.20/1K Ads8 min read·Updated 2026-11-15

Facebook & Meta Ad Library API: Scrape Commercial Ads Without Government ID Verification (2026)

Quick Architecture AnswerGET /v1/facebook/ads/search?query=shopify&country=US&active_status=active -> $0.20 / 1,000 Ads · Verified 2026-11-15

To search commercial Facebook and Instagram ads programmatically in the US and globally without Meta government ID verification or Graph API token refreshes, send a GET request to https://api.shortvidapi.com/v1/facebook/ads/search with query, country, and active_status. Responses arrive in ~1.4s p50 with normalized creative copy, destination URLs, and media assets.

Meta's official Ad Library Graph API restricts commercial ad queries outside EU/UK regional rules and mandates government ID verification plus expiring user access tokens. Query global US, UK, EU, APAC, and LATAM commercial Facebook & Instagram ads in ~1.5s via GET /v1/facebook/ads/search.

$0.20 / 1K Videos · $0.10 / 1K Comments & Followers · No OAuth Needed

Instant Quickstart · Copy & Run in 30 Seconds

Search US Active Meta Ads by Brand or Keyword

Execute in Live Playground →
import os
import requests

res = requests.get(
    "https://api.shortvidapi.com/v1/facebook/ads/search",
    params={
        "query": "shopify",
        "country": "US",
        "active_status": "active",
        "limit": 20,
    },
    headers={"x-api-key": os.environ["SHORTVID_API_KEY"]},
    timeout=25,
)
payload = res.json()

for ad in payload["data"]["items"]:
    creative = ad["creative"]
    print(
        ad["ad_archive_id"],
        ad["page_name"],
        ad["publisher_platform"],
        creative["cta_text"],
        creative["link_url"],
    )

Key Engineering Takeaways (TL;DR)

  • ✓Meta's official /ads_archive Graph API endpoint only returns non-political commercial ads when targeted to EU/UK audiences (or political/social-issue ads after mailed government ID verification) — leaving US, Canadian, Australian, and global e-commerce ad spy tools blind.
  • ✓GET /v1/facebook/ads/search queries Meta's public Ad Library across any country (US, GB, DE, CA, AU, BR, JP, or ALL) for any brand, keyword, or advertiser with zero Meta account or identity verification.
  • ✓Every ad item normalizes ad_archive_id, page_id, page_name, publisher_platform (FACEBOOK, INSTAGRAM, MESSENGER, AUDIENCE_NETWORK), start/end ISO dates, and full creative assets (headline title, body copy, CTA button, landing link_url, images, videos, and DCO carousel cards).
  • ✓Priced at $0.20 per 1,000 ads (2 Credits/ad, 10-Credit minimum per non-empty call), with 0 Credits charged whenever a brand or keyword returns 0 matching ads.

1. Why Meta's Official /ads_archive API Fails Commercial E-Commerce & SaaS Spy Tools

Developers integrating Meta's official Ad Library API for competitive intelligence consistently hit three hard platform blockers before shipping to production.

Official Meta Graph API (/ads_archive) vs Container Browser Actors vs ShortVid Meta Ad Library API
Feature / ConstraintShortVid API (/v1/facebook/ads/search)Official Meta /ads_archive APIHeadless Browser Container Actors
US, CA, AU & Global Commercial AdsSupported (all ISO countries + ALL)Blocked (commercial ads limited to EU/UK DSA scope)Supported (slow headless browser startup)
Identity & Government ID VerificationNone (instant x-api-key)Mandatory government ID + residential mailing checkNone
Median Response Latency~1.45s synchronous JSON (<10ms cached)~1.2s (where permitted)25–90s container cold start + polling
Creative Media Assets (Images, MP4, DCO Cards)Direct image/video URLs + resolved DCO cardsad_snapshot_url HTML iframe requiring browser renderIncluded after full DOM scroll
Unit Economics$0.20 / 1,000 ads ($0.08/1K on Business)Free quota, but US commercial ads unavailable$0.75–$5.00 / 1,000 ads + compute RAM fees

2. Query Active Facebook & Instagram Ads in Python, Node.js & cURL

Combine /v1/facebook/ads/search with /v1/ads/top/ads (TikTok Creative Center) to monitor cross-platform paid acquisition creatives from a single API key.

Search US Active Meta Ads by Brand or Keyword

Retrieve active Facebook & Instagram commercial ads, landing page URLs, CTA copy, and video creatives for any advertiser or product niche.

curl -sS "https://api.shortvidapi.com/v1/facebook/ads/search?query=shopify&country=US&active_status=active&limit=20" \
  -H "x-api-key: $SHORTVID_API_KEY"

Interactive Engineering Workbench · GET /v1/facebook/ads/search

Verify real-time latency, pagination math & JSON schema

5,000 videos/day
10,000 comments/day
20,000 followers/day
Our HTTP Calls/Day
452
Large page sizes
Legacy Provider Calls
1,334
30-item small pages
Official Research API
Within 1K Cap
1,000 req/day limit
Estimated Monthly Pipeline Cost (30 Days)
$72.73/ mo with Business bonus ($120.00 base rate)
Daily consumption: 40,000 Credits ($4.00/day)
ShortVid API (with volume bonus):$72.73 / mo
Legacy Scrapers ($1.50 / 1K calls):$60.03 / mo
Failed / 404 request fee:$0.00 (0 Credits)

Frequently Asked Questions

Does /v1/facebook/ads/search return Instagram ads as well as Facebook ads?
Yes. Meta's Ad Library indexes ads across Facebook, Instagram, Messenger, and Audience Network. Every returned item includes a publisher_platform array showing exactly where the creative runs.
Are Dynamic Creative Optimization (DCO) template placeholders like {{product.name}} resolved?
Yes. When an advertiser uses Advantage+ catalog or DCO templates where top-level snapshot fields contain {{product.*}} macros, our parser automatically resolves concrete headlines, copy, and destination URLs from the ad's rendered variation cards.
Am I billed if a competitor brand has 0 active ads in a given country?
Never. Empty search results (items.length === 0) return HTTP 200 with x-credits-cost: 0 so automated brand-monitoring cron jobs can poll emerging competitors for free until ads launch.

More engineering guides

View all guides →

Architecture Guide · 2026

Unofficial TikTok API vs Official TikTok API: Complete 2026 Developer Guide

8 min read →

Video Parser Guide · 1080p HD

How to Get TikTok Video Metadata & 1080p No-Watermark MP4 via API

6 min read →

Search & Discovery Guide

TikTok Search API Guide: Search Videos, Creators & Commercial Ads by Keyword

7 min read →

Pricing & Cost Analysis · 2026

TikAPI Pricing Breakdown (2026): Real Cost per 1,000 Videos & Pay-As-You-Go Comparison

6 min read →

Troubleshooting · HTTP Error 403 & WAF Fix

Access to www.tiktok.com Was Denied (HTTP 403): 30-Second Browser & Python API Fix

8 min read →

Ad Intelligence Tutorial

TikTok Ads Library & Creative Center API: Scrape Winning Ads, CTR & Keywords

8 min read →

Social Listening Tutorial

TikTok Comments & Replies Scraper API: Extract Threads at $0.10/1K

7 min read →

Creator & Follower Graph Guide

TikTok Profile & Followers Scraper API: Fetch User Data, Videos & 200-Item Follower Lists

8 min read →

Analytics & Python SDK · 2026

TikTok Analytics API & Python Guide: Creator Engagement, Video Velocity & Studio Metrics

8 min read →

Creator Discovery · 2026

TikTok Influencer Search API: Find Creators by Niche & Follower Tier

8 min read →

Lead Generation · 2026

How to Extract Creator Emails & Bio Leads from TikTok via API (Python & Node.js)

7 min read →

Trend Intelligence · 2026

TikTok Hashtag, Sound & Viral Trends API: Track Breakout Topics in Real Time

8 min read →

No-Code & AI Workflows · 2026

n8n & Make.com TikTok API Integration: Automate Video & Creator Workflows

7 min read →

E-Commerce & Affiliates · 2026

TikTok Shop Affiliate & E-Commerce Product Intelligence via API

8 min read →

Official API Architecture · 2026

TikTok Research API: Academic Eligibility, 1,000/Day Quota & Commercial REST Endpoints

8 min read →

OAuth & Scopes Reference · 2026

TikTok Display API: OAuth 2.0 Scopes, Limitations & How to Fetch Public Profiles

6 min read →

Python SDK & Asyncio Hub · 2026

Python TikTok API Tutorial (2026): requests, asyncio & Why Playwright Libraries Break

9 min read →

Scraper Architecture · $0.20/1K Videos

TikTok Scraper API: Extract Public Videos, Profiles, Comments & Ads at Scale

8 min read →

Pricing & Unit Math · 2026

EnsembleData Pricing & Daily Units Explained (2026): Real Cost Per 1,000 Video Requests

7 min read →

Pricing & Credit Math · 2026

ScrapeCreators Pricing Breakdown (2026): Credit Pack Tiers & Cost Per 1,000 API Calls

7 min read →

Cloud Scraper TCO Math · 2026

Apify TikTok Scraper Pricing Math (2026): Pay-Per-Result, Actor Compute & Proxy Burn

8 min read →

Instagram Engineering Guide · $0.20/1K Reels

Instagram Reels & Profile API: Extract Public Reels, Play Counts, MP4 Streams & Comments (2026)

8 min read →

AI & Speech Pipeline Guide · 2026

TikTok Transcript & Subtitles API in Python: Extract SRT, TXT & JSON at Scale (2026)

8 min read →