Frequently Asked Questions
Everything you need to know about FairGiveaway. Can't find what you're looking for? Contact us.
General
What is FairGiveaway?
FairGiveaway is an open-source platform for running provably fair giveaways on social media. We scrape participants from tweets, randomly draw winners using cryptographically secure algorithms, and store results as permanent public records.
Is FairGiveaway free?
Yes, completely free. We are an open-source project under the MIT license. No hidden fees, no premium tiers, no ads.
Which platforms are supported?
Currently, we support X (Twitter). We plan to add support for more platforms in the future.
Fairness & Security
How do you ensure the draw is fair?
Winners are selected using the Web Crypto API (crypto.getRandomValues), the same cryptographic randomness engine used by banks and security systems. The selection is mathematically unbiased and cannot be manipulated.
Can the host manipulate the results?
No. Once participants are scraped, the random selection algorithm runs independently. The host cannot influence which participants are drawn. Additionally, all finalized results are stored as immutable public records that anyone can audit.
How can I verify that a draw was fair?
Every finalized draw has a unique ID. You can look up any draw in our History page or use the Verify Draw feature to see the complete participant list, winner verification results, and draw configuration.
Anti-Bot Protection
What are anti-bot filters?
Anti-bot filters are optional checks applied to each drawn winner to ensure they are a real person, not a bot account. Filters include: profile picture check, bio check, minimum account age, minimum post count, and comment verification.
What happens if a winner fails verification?
If a winner fails any enabled anti-bot filter, they are marked as "failed" with a reason, and a backup winner is automatically drawn in their place. The failed candidate and the reason are still recorded in the public record for transparency.
Can I customize which filters are applied?
Yes. All filters are optional and configurable. You can enable/disable each one individually and adjust thresholds (like minimum account age in months or minimum post count) to suit your giveaway.
Data & Privacy
What data do you collect?
We collect publicly available Twitter data: usernames, avatar URLs, and tweet engagement data (likes/reposts). We do not collect passwords, personal information, or use tracking cookies. See our Privacy Policy for full details.
Do you store my Twitter cookies?
No. Twitter session cookies (auth_token, ct0) are used in-memory only during the scraping process and are never saved to disk or any database.
Can I delete my data?
You can request data deletion by contacting us. However, finalized giveaway records are designed to be immutable public audit trails, so individual participant entries from completed draws may not be removable without compromising record integrity.
How long is data stored?
Active draw sessions expire after 15 minutes. Finalized giveaway records are stored permanently as public audit trails. Contact form submissions are only in our email inbox.
Technical
Is FairGiveaway open source?
Yes! Both the frontend and backend are fully open source under the MIT license. You can view, audit, fork, or contribute to the code on GitHub.
Do you have an API?
Yes. FairGiveaway has a RESTful API with interactive Scalar documentation. You can access it for programmatic draw creation, verification, and history queries.
What tech stack does FairGiveaway use?
Frontend: Next.js with TailwindCSS. Backend: ElysiaJS (Bun runtime). Database: MongoDB Atlas. Cache: Upstash Redis. Scraping: Puppeteer. Containerization: Docker.
Still have questions?
We're here to help. Reach out via email, X, or GitHub Discussions.