Ads Transparency
Advertiser, dates, images or video and status.
Pull Google ads as JSON. Failed requests are free.
100 free credits. No card needed.
Data
Advertiser, dates, images or video and status.
Uses
See the ads a brand has run, with dates.
Search advertisers by name, then pull their ads.
Example
1curl -G "https://api.socialscrape.dev/v1/google/ad-library/advertisers/search" \2 -H "x-api-key: $SOCIALSCRAPE_API_KEY" \3 --data-urlencode "query=nike" \4 --data-urlencode "region=US"1import os2import requests34params = {5 "query": "nike",6 "region": "US",7}8res = requests.get(9 "https://api.socialscrape.dev/v1/google/ad-library/advertisers/search",10 headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},11 params=params,12)13body = res.json()1415if body["ok"]:16 print(body["data"])17else:18 print(body["error"]["code"], body["error"]["message"])1const url = new URL("https://api.socialscrape.dev/v1/google/ad-library/advertisers/search");2url.search = new URLSearchParams({3 "query": "nike",4 "region": "US"5}).toString();6const res = await fetch(url, {7 headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },8});9const body = await res.json();1011if (body.ok) {12 console.log(body.data);13} else {14 console.error(body.error.code, body.error.message);15}{ "ok": true, "credits_charged": 1, "credits_remaining": 4999, "cached": false, "cached_at": null, "request_id": "req_7b41fb6b4e347350def3e7b8", "data": { "object": "list", "items": [ { "object": "advertiser", "platform": "google", "id": "AR16735076323512287233", "name": "Nike, Inc.", "url": "https://adstransparency.google.com/advertiser/AR16735076323512287233", "page_id": null, "country": "US", "verified": null, "ad_count": 9000, "extra": { ... } }, { "object": "advertiser", "platform": "google", "id": "AR17567291692413878273", "name": "Nike Klara", "url": "https://adstransparency.google.com/advertiser/AR17567291692413878273", "page_id": null, "country": "US", "verified": null, "ad_count": 11, "extra": null } ], "cursor": null, "has_more": false, "parent": null }, "cursor": null, "has_more": false }
Pricing
Packs never expire. Monthly plans too. See pricing
Reference
FAQ
Most requests cost 1 credit, and transcripts have their own rule; each endpoint page states it. New accounts get 100 free credits. See pricing.
No. You send your SocialScrape key and never a platform password.
Yes. The endpoints are live: built, tested against recorded responses and watched by canaries. Get an API key.