Ad intelligence API
See what competitors are running across the Meta, Google, LinkedIn and TikTok ad libraries: creatives, copy, start dates and platforms, in one JSON shape you can store and compare.
8 endpointsFacebook, Google, LinkedIn, TikTok
What API returns competitors' ads from the public ad libraries? Social Fetch does. Find the advertiser with the Meta, Google or LinkedIn ad library search, then list its ads: copy, creatives, start dates and the platforms each ad runs on. Meta, Google, LinkedIn and TikTok ad libraries share one API key and one response shape, and you pay per lookup.
A real run. Measured and priced.
Find a competitor's ad accounts and pull what is running, run on 21 Nov 2026 against live public data. A competitor's live Meta ads and its LinkedIn ad history, from three calls.
01 GET /v1/
facebook/ ad-library/ companies/ search ?query=Notion 15 matching pages, with Notion's own page first.
3 credits, 1.5 s
02 GET /v1/
facebook/ ad-library/ companies/ ads ?pageId=825120160874613 30 active ads, started 21 May to 28 Aug, on Facebook and Instagram.
3 credits, 4.1 s
03 GET /v1/
linkedin/ ad-library/ ads/ search ?company=Notion 24 ads on the first page, from 5,594 in all.
3 credits, 9.2 s
- Credits
- 9
- 3 calls
- Starter pack
- $0.13
- $14 per 1,000 credits
- Scale pack
- $0.015
- $1.64 per 1,000 credits
- Runtime
- 14.8 s
- Server time, calls one after another
Credits are each route's published price. Dollar figures are those credits at the list rate of each pack. Results and times are from the calls above, made on 21 Nov 2026; live data changes, so a run today returns newer numbers.
What usually breaks first
Where a home-built scraper or a marketplace API tends to fail once it runs in production.
Every ad library is its own website
Meta, Google, LinkedIn and TikTok each search differently, page differently and show different fields, so a weekly competitor review means four tabs and a lot of screenshots.
Suites lock you into contracts
Ad intelligence suites solve it with an annual contract and a fixed list of tracked brands. Adding a competitor mid-quarter can mean a call with sales.
You need each library's ads as data
Who is advertising, what the copy says, when each ad started and where it runs, so your team can diff this week against last.
The routes. 8 for this job.
The routes teams call for this job on Facebook, Google, LinkedIn, and TikTok. Each one links to its reference page, with every parameter and field.
GET /v1/ facebook/ ad-library/ companies/ search Find an advertiser's Meta page id from its name, the key for listing its ads.
GET /v1/ facebook/ ad-library/ companies/ ads Every ad a page is running on Facebook and Instagram, with copy, creatives, start dates and platforms.
GET /v1/ facebook/ ad-library/ ads/ search Search all Meta ads by keyword, for ads about a topic or product rather than one advertiser.
GET /v1/ google/ ad-library/ advertisers/ search Find an advertiser in Google's ads transparency library.
GET /v1/ google/ ad-library/ companies/ ads An advertiser's Google ads, by advertiser id or by website domain.
GET /v1/ linkedin/ ad-library/ ads/ search LinkedIn ads by company or keyword, for B2B messaging and offers.
GET /v1/ tiktok/ ad-library/ ads/ search TikTok ads by keyword, for consumer brands' short-form creative.
GET /v1/ facebook/ ad-library/ ads One Meta ad in full, when a list result needs its complete details.
5 steps. How teams wire it up.
The usual order. Change the schedule, schema and thresholds to fit your stack.
Step 1: Resolve each competitor once
Search each library for the competitor and store the ids it returns: Meta page id, Google advertiser id, LinkedIn company name.
Step 2: Pull the ads on a schedule
List each competitor's ads weekly, or daily around a launch. Store every ad by its library id with the date you saw it.
Step 3: Diff against last time
New ids are new ads. Ads that disappear have stopped. Long-running ads are the ones that work, so flag anything active for more than a month.
Step 4: Read the creative
Group ads by message, offer and format. Pass the copy to an LLM to tag the angle: price, feature, social proof, urgency.
Step 5: Report it
Send a weekly digest to the team, or feed the data to your own dashboard. Credits never expire, so quiet weeks cost nothing.
Why growth teams track ads here
Four ad libraries, one shape
Meta, Google, LinkedIn and TikTok ads come back in the same JSON layout, so one job watches them all.
Any competitor, any time
There is no tracked-brand list to fill; look up a new competitor the day you hear about it.
Pay per lookup
No annual contract and no seats: pulling ten competitors' Meta ads once a week is 120 credits over four weeks.
You only pay for completed lookups
Requests that fail on our side cost nothing.
Public data only
Every ad comes from the platforms' own public ad libraries.
Common questions
What API returns competitors' ads from the public ad libraries?
Social Fetch. It reads the Meta, Google, LinkedIn and TikTok ad libraries and returns each ad's copy, creatives, start date and platforms in one JSON shape, with one API key.
Can I see how much a competitor spends on ads?
Only where a library publishes it. For most commercial ads the libraries show the creative, the copy, the start date and where it runs, not the budget.
Is there a free way to try it?
Yes. The free Facebook Ad Library tool and LinkedIn Ad Library tool search the same data in your browser, and new accounts get free credits for the API.
How often should I pull competitor ads?
Weekly is enough for most teams. Around a competitor's launch or a sales season, daily pulls catch new creative while it is still being tested.
Start on free credits. Make your first request.
Sign up and get 100 credits, no card needed. Run the request above, then buy more when you need them. Credits never expire.