How to Use FairGiveaway
Everything you need to know to run provably fair giveaways on X (Twitter).
Quick Start Guide
- 1
Pick Your Platform
Go to the Platforms page and select X (Twitter). More platforms will be supported in the future.
- 2
Enter the Tweet URL
Paste the full URL or tweet ID of your giveaway post. Choose whether to draw from likers or retweeters.
- 3
Configure Anti-Bot Filters
Enable filters to ensure only real accounts win: profile picture check, bio check, minimum account age, minimum post count, and comment verification.
- 4
Draw Winners
Click "Draw" to randomly select winners using the Web Crypto API. Each winner is automatically verified against your filters.
- 5
Finalize & Share
Review your results, then save the draw permanently. Share the results as a quote tweet or comment on the original post.
Anti-Bot Filters
These filters are applied during winner verification to ensure only legitimate accounts win. All filters are optional — enable the ones that suit your giveaway.
Profile Picture
Rejects accounts using the default Twitter avatar (egg/silhouette). Real users almost always upload a custom photo.
Bio Check
Rejects accounts with an empty bio/description. Bot accounts often skip filling out their profile.
Account Age
Rejects accounts younger than a configurable threshold (default: 1 month). Prevents newly created bot farms.
Activity Check
Rejects accounts with fewer than a configurable number of posts (default: 10). Ensures the account has real activity.
Comment Verification
Requires the winner to have commented on the giveaway tweet. Proves genuine engagement with the post.
Engagement Tasks
Organizers can require participants to complete engagement tasks beyond just liking or retweeting. These are checked during the verification phase.
Must Like
Require candidates to have liked the giveaway tweet.
Must Comment
Require candidates to have commented on the giveaway tweet.
Must Follow
Require candidates to follow one or more specified accounts.
External Tweet
Require engagement (like, repost, comment, or quote) on a second tweet.
API Documentation
FairGiveaway exposes a RESTful API for programmatic access. Explore the interactive Scalar documentation for all available endpoints, schemas, and examples.
Open API Docs