Free, no signup. A limited number of lookups per visitor each hour. Public data only.
How it works
Meta publishes ads on its public Ad Library. The tool searches it for a keyword and lists the ads with the advertiser, the text, the button, when the ad started and whether it is still running. Each row links to the ad on the Library.
Use this in your app
This tool calls GET /v1/facebook/ad-library/search. See the reference, or get early access for a key.
import os
import requests
params = {
"query": "nike",
"region": "US",
"cursor": "eyJrIjoiZmJhZHMiLCJjIjoiQVFIVHR6TWN1R1ZGekcxSF85UzBpNjN5VTVMYjFzZHFDZmZaRjRYeHRHS205dXlVNG1BTUpkT2F3VEg1YUM4VWdvV2EifQ",
}
res = requests.get(
"https://api.socialscrape.io/v1/facebook/ad-library/search",
headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},
params=params,
)
body = res.json()
if body["ok"]:
print(body["data"])
else:
print(body["error"]["code"], body["error"]["message"])
TypeScript
const url = new URL("https://api.socialscrape.io/v1/facebook/ad-library/search");
url.search = new URLSearchParams({
"query": "nike",
"region": "US",
"cursor": "eyJrIjoiZmJhZHMiLCJjIjoiQVFIVHR6TWN1R1ZGekcxSF85UzBpNjN5VTVMYjFzZHFDZmZaRjRYeHRHS205dXlVNG1BTUpkT2F3VEg1YUM4VWdvV2EifQ"
}).toString();
const res = await fetch(url, {
headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },
});
const body = await res.json();
if (body.ok) {
console.log(body.data);
} else {
console.error(body.error.code, body.error.message);
}
n8n
{"nodes":[{"name":"SocialScrape Facebook Ad Library search","type":"n8n-nodes-base.httpRequest","typeVersion":4.2,"position":[0,0],"parameters":{"method":"GET","url":"https://api.socialscrape.io/v1/facebook/ad-library/search","sendQuery":true,"queryParameters":{"parameters":[{"name":"query","value":"nike"},{"name":"region","value":"US"},{"name":"cursor","value":"eyJrIjoiZmJhZHMiLCJjIjoiQVFIVHR6TWN1R1ZGekcxSF85UzBpNjN5VTVMYjFzZHFDZmZaRjRYeHRHS205dXlVNG1BTUpkT2F3VEg1YUM4VWdvV2EifQ"}]},"sendHeaders":true,"headerParameters":{"parameters":[{"name":"x-api-key","value":"={{ $env.SOCIALSCRAPE_API_KEY }}"}]}}}],"connections":{}}
Questions
Does it show spend or impressions?
Only when the Library gives them. For most commercial ads it does not, and the fields are left out.
How do I search one advertiser?
The API has an advertiser search and a per-company ads endpoint. This tool searches by keyword.
Is this tool free?
Yes. No account and no card. Each visitor gets a limited number of lookups an hour, so it stays free for everyone.
How do I get this data in my own app?
Send GET /v1/facebook/ad-library/search with your key in the x-api-key header. A request costs 1 credit. A repeat of something fetched recently costs 0 credits, and failed requests are free. See the reference.