Home / Use cases / How to build Advertiser lookup tool with a social data API
How to build Advertiser lookup tool with a social data API
You can build advertiser lookup tool by calling 3 Scrapall REST endpoints for Facebook Ad Library, Google Ad Library and storing the JSON they return. The typical buyer is agencies prospecting brands that already advertise. Find advertiser pages for a brand name and list their live ads.
Updated · by the Scrapall team
Platforms and endpoints
| Product | Platform | Endpoint | What it returns |
|---|---|---|---|
| Advertiser lookup tool | Facebook Ad Library | /v1/facebook/ads_search_companies | Search for Companies |
| Advertiser lookup tool | Google Ad Library | /v1/google/ads_advertisers_search | Advertiser Search |
| Advertiser lookup tool | Facebook Ad Library | /v1/facebook/ads_company_ads | Company Ads |
Example request
Every endpoint is a plain HTTPS GET or POST with your key in the X-Scapi-Key header. Responses are JSON.
curl "https://api.scrapall.bipsport.com/scapi/v1/facebook/ads_search_companies?query=nike" \
-H "X-Scapi-Key: YOUR_API_KEY"What you can build
A working advertiser lookup tool needs three parts: a collector that calls the endpoints below on a schedule, a small database that keeps every response with its fetch time, and a view or alert that shows agencies prospecting brands that already advertise what changed. Scrapall handles the data collection, so you only write the product logic.
How to build it, step by step
- Get an API key on the Buy page; new accounts start with 20 free credits.
- Call /v1/facebook/ads_search_companies first to check the response fields you need.
- Add the other endpoints (/v1/google/ads_advertisers_search, /v1/facebook/ads_company_ads) and store each JSON response with a timestamp.
- Schedule the collector (cron or a queue) and build the view or alert on top of the stored data.
FAQ
Which platforms does this use case need?
It uses public data from Facebook Ad Library, Google Ad Library, all reachable through one Scrapall API key.
How do I authenticate the requests?
Send your key in the X-Scapi-Key header on every request. Responses are JSON.
How much does it cost to start?
New accounts get 20 free credits. After that you pay per request in USDT; see the Pricing page.
Can I run it on a schedule?
Yes. Each endpoint is a plain HTTPS call, so a cron job or queue worker can collect fresh data every day.
Sources
- https://scrapall.bipsport.com/docs/facebook-ad-library/#get-v1-facebook-ads-company-ads
- https://scrapall.bipsport.com/docs/facebook-ad-library/#get-v1-facebook-ads-search-companies
- https://scrapall.bipsport.com/docs/google-ad-library/#get-v1-google-ads-advertisers-search