Home / Use cases / How to build Event lead finder with a social data API
How to build Event lead finder with a social data API
You can build event lead finder by calling 3 Scrapall REST endpoints for Facebook Events and storing the JSON they return. The typical buyer is event marketers and local sponsors. Find public events in a city and topic to plan sponsorships.
Updated · by the Scrapall team
Platforms and endpoints
| Product | Platform | Endpoint | What it returns |
|---|---|---|---|
| Event lead finder | Facebook Events | /v1/facebook/events_search | Search Events |
| Event lead finder | Facebook Events | /v1/facebook/event_details | Event Details |
| Event lead finder | Facebook Events | /v1/facebook/events | Events |
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/events_search?query=Event name or description" \
-H "X-Scapi-Key: YOUR_API_KEY"What you can build
A working event lead finder 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 event marketers and local sponsors 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/events_search first to check the response fields you need.
- Add the other endpoints (/v1/facebook/event_details, /v1/facebook/events) 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 Events, 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-events/#get-v1-facebook-event-details
- https://scrapall.bipsport.com/docs/facebook-events/#get-v1-facebook-events
- https://scrapall.bipsport.com/docs/facebook-events/#get-v1-facebook-events-search