Winify X API

Roll the giveawayin one call.

The engine behind Winify, opened up. Pull X data per item, or hand us a tweet and eight entry requirements and get back a winner you can prove you did not choose.

Independent service — we are not affiliated with X / Twitter in any way.

  • One call rolls the giveaway

    Collect every entrant, apply eight entry rules, and get back one winner — with the seeds to prove the draw.

  • Nobody left out of the draw

    A plain retweeter list can return some entrants as unavailable. The roll looks them up one by one, so they stay in the draw.

  • Provably fair by default

    Server seed, client seed and the pool hash ship with every roll. Anyone can recompute the winner.

  • Prepaid, per item

    No plan, no seat, no monthly minimum. Failed calls cost nothing and your balance never expires.

Pay for what you pull

No plan, no seat, no monthly minimum. You hold a prepaid balance and every call debits exactly what it returned — an empty page costs the floor, not a full page. The rate card below is served live from the meter itself.

Per retweeter / follower

$0.00020

per profile from a full page — retweeters, followers, list members

Per profile lookup

$0.00360

per profile looked up directly by handle

Per tweet / reply

$0.00300

per tweet returned — timelines, replies, quotes, search

Minimum call

$0.00300

the floor on any billable call; failed calls are never billed

Page-fill tiers

Full pages cost $0.00020 a profile; sparse pages cost more, because they cost us more.

Errors are free

A 4xx or 5xx is never billed. You pay for data that arrived.

Balance never expires

Credits sit there until you spend them. No monthly reset, no forfeit.

Every endpoint, priced

Served from GET /v1/billing/pricing — the same table the meter charges from.

EndpointWhat it returnsPer unitMinimum
/v1/user/infoProfile by handle$0.00360per profile returned$0.00300
/v1/user/aboutProfile 'about' panel$0.00360per profile returned$0.00300
/v1/user/relationshipFollow-relationship checkflat$0.00300
/v1/search/usersUser search$0.00020per profile returned (tiered by page fill)$0.00300
/v1/search/users/allfetch-allUser search (fetch-all)$0.00020per profile returned (tiered by page fill)$0.20

What a roll actually costs

Entry method
Winners

A roll costs the same whether people entered by retweet, reply or quote. Requirements are checked only on the accounts the draw picks, the same way rolls work on Winify — not on every entrant. Profile rules are free.

One /giveaway/roll call

$1.0330

Roll fee
$0.03
5,000 retweeters
$1.00
1 follow check
$0.00300

+$0.00300 for each drawn account that doesn't follow and gets redrawn.

Top up

Card or crypto. Balance lands instantly and never expires.

We are not affiliated with X / Twitter in any way

Winify is an independent service. We are not affiliated, associated, authorised, endorsed by, sponsored by, or in any way officially connected with X Corp. or Twitter, Inc., or any of their subsidiaries or affiliates. The same is true of Kick, YouTube and Google, Discord, Telegram, Twitch, and every casino, sportsbook or other brand that appears on the Service. "X", "Twitter", "Tweet" and every other third-party name and logo are trademarks of their respective owners, used only to describe what our tools work with. The Winify X API is not an official X product and is not provided, reviewed, approved or supported by X Corp. You are responsible for how you use the API and the data it returns — see our Terms of Service, Privacy Policy and Disclaimers.