Home / Use cases / How to build Competitor ad alert service with a social…
How to build Competitor ad alert service with a social data API
You can build competitor ad alert service by calling 3 Scrapall REST endpoints for Facebook Ad Library, Google Ad Library, LinkedIn Ad Library and storing the JSON they return. The typical buyer is agencies managing many ad accounts. Send an alert when a tracked competitor starts a new ad on any network.
Updated · by the Scrapall team
Platforms and endpoints
| Product | Platform | Endpoint | What it returns |
|---|---|---|---|
| Competitor ad alert service | Facebook Ad Library | /v1/facebook/ads_company_ads | Company Ads |
| Competitor ad alert service | Google Ad Library | /v1/google/company_ads | Company Ads |
| Competitor ad alert service | LinkedIn Ad Library | /v1/linkedin/ads_search | Search 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_company_ads" \
-H "X-Scapi-Key: YOUR_API_KEY"What you can build
A working competitor ad alert service 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 managing many ad accounts 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_company_ads first to check the response fields you need.
- Add the other endpoints (/v1/google/company_ads, /v1/linkedin/ads_search) 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, LinkedIn 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/google-ad-library/#get-v1-google-company-ads
- https://scrapall.bipsport.com/docs/linkedin-ad-library/#get-v1-linkedin-ads-search