Home / Use cases / How to build Ad library spy tool with a social data API
How to build Ad library spy tool with a social data API
You can build ad library spy tool by calling 3 Scrapall REST endpoints for Facebook Ad Library, Google Ad Library and storing the JSON they return. The typical buyer is performance marketers and media buyers. Search running ads by keyword or advertiser to see creatives and offers.
Updated · by the Scrapall team
Platforms and endpoints
| Product | Platform | Endpoint | What it returns |
|---|---|---|---|
| Ad library spy tool | Facebook Ad Library | /v1/facebook/ads_search_ads | Search |
| Ad library spy tool | Facebook Ad Library | /v1/facebook/ads_company_ads | Company Ads |
| Ad library spy tool | Google Ad Library | /v1/google/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_ads?query=running" \
-H "X-Scapi-Key: YOUR_API_KEY"What you can build
A working ad library spy 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 performance marketers and media buyers 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_ads first to check the response fields you need.
- Add the other endpoints (/v1/facebook/ads_company_ads, /v1/google/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-ads
- https://scrapall.bipsport.com/docs/google-ad-library/#get-v1-google-company-ads