Home / Use cases / How to build Giveaway winner picker with a social data API
How to build Giveaway winner picker with a social data API
You can build giveaway winner picker by calling 3 Scrapall REST endpoints for Instagram, TikTok, YouTube and storing the JSON they return. The typical buyer is creators and small brands running giveaways. Collect all comments of a giveaway post and pick a fair random winner.
Updated · by the Scrapall team
Platforms and endpoints
| Product | Platform | Endpoint | What it returns |
|---|---|---|---|
| Giveaway winner picker | /v1/instagram/post_comments_plus | Comments | |
| Giveaway winner picker | TikTok | /v1/tiktok/video_comments | Comments |
| Giveaway winner picker | YouTube | /v1/youtube/video_comments | Comments |
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/instagram/post_comments_plus?url=https://www.instagram.com/reel/DOq6eV6iIgD" \
-H "X-Scapi-Key: YOUR_API_KEY"What you can build
A working giveaway winner picker 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 creators and small brands running giveaways 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/instagram/post_comments_plus first to check the response fields you need.
- Add the other endpoints (/v1/tiktok/video_comments, /v1/youtube/video_comments) 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 Instagram, TikTok, YouTube, 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/instagram/#get-v1-instagram-post-comments-plus
- https://scrapall.bipsport.com/docs/tiktok/#get-v1-tiktok-video-comments
- https://scrapall.bipsport.com/docs/youtube/#get-v1-youtube-video-comments