Giveaway Radar: XCROP API Documentation
Giveaway Radar
Giveaway Radar is a free page on this site that lists giveaways running on X right now. It is not an API endpoint, so it does not change the endpoint count. No login, no API key, and no credits
How posts are collected
| Step | Cadence | What happens |
|---|---|---|
| Search | Every 10 minutes | 8 search queries on X (giveaway, whitelist, airdrop, raffle, sweepstakes, contest, "chance to win" and similar wording), English posts only. Replies, reposts and quote posts are skipped, only original posts are listed |
| Refresh | Every 10 minutes | Every post already held and younger than 7 days is read again to update its counters and drop deleted ones |
| Host check | Before the first card, then every 7 days | The host’s recent posts and replies are read to see whether past giveaways were announced (below) |
| Page | Cached 1 minute | The list is rendered on the server, 18 cards a page |
What counts as a giveaway
A post is kept only when it has all three: a giveaway word (giveaway, giving away, raffle, whitelist, WL spots, airdrop, sweepstakes, "win a ..."), an entry step (follow, retweet, repost, like, tag, reply, comment, quote, "to enter"), and at least one step that is an interaction with the post itself: retweet or repost, like, or quote. A giveaway that only asks for a follow, or only for a reply, a comment or a tag, is not listed
Entrants and the threshold
| Post | Listed from | Active until |
|---|---|---|
| Names a deadline | 500 entrants | Its deadline, then it moves to Ended |
| Names no deadline | 2,000 entrants | 3 days after posting, then it moves to Ended |
Entrants are the reposts plus quotes (the number X shows on its repost button), or the replies if that is larger, read from X’s own counters. Replies are not added on top: one person who reposts and replies would count twice. Likes are not counted: liking is often one of the steps, but X hides who liked a post, so a like count is not a number anyone can check. Posts older than 7 days leave the page whatever their deadline
Hosts that never announce winners
A past giveaway becomes due 2 days after its deadline, or 5 days after posting when it named none (3 days assumed for the draw, then the same 2). It counts as announced when the host later posted, or replied or quoted in that giveaway’s conversation, naming someone (@handle) with a winner word such as winner, congrats or won. A host with at least one due giveaway and not a single announcement loses every card. A new host is checked before its first card goes live, in the same pass that found the post. Hosts are checked again every 7 days and come back as soon as an announcement is found, and a new host whose history cannot be read yet stays off the page until a later check reads it. The rule is generous on purpose: one "congrats" post can cover several earlier giveaways
Tabs
| Tab | Order |
|---|---|
| Trending | Entrants gained per hour over the last 6 hours, so a post growing now ranks above a bigger one that has stalled |
| Newest | Most recent post first |
| Top | Most entrants first |
| Biggest | Largest prize pool first, in USD: cash and stablecoins as written, coins at the current price, per-winner amounts multiplied out, named products at a typical retail price. Posts whose prize cannot be read come last |
| Ends in 24h | A real deadline parsed from the post falls within 24 hours, soonest first. Posts with no stated deadline never appear here |
| Ended | The deadline has passed, or 3 days have passed for a post that named none |
What it does not do
There is no API endpoint for the list and no email or Telegram alert. It does not enter giveaways, check whether you entered, or promise that a prize is real or paid; the payout check only hides hosts with a record of not announcing. It sees giveaways that are already running and public on X, nothing earlier. A host who wants to pick winners from a post can use the Draw winners button, which opens Winner Picker