curl -X POST https://xquik.com/api/v1/draws \ -H "x-api-key: xq_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2" \ -H "Content-Type: application/json" \ -d '{ "tweetUrl": "https://x.com/xquik/status/1893456789012345678", "winnerCount": 3, "backupCount": 2, "mustRetweet": true, "filterMinFollowers": 10, "requiredKeywords": ["giveaway"] }' | jq
Your API key. This endpoint also accepts session cookie authentication.
Must be application/json.
Body Full tweet URL to run the draw on. Accepts x.com and twitter.com formats (e.g. https://x.com/user/status/1893456789012345678).
Number of winners to draw. Defaults to 1 if omitted.
Number of backup winners to draw. Backup winners are selected in case primary winners are disqualified.
When true, each author can only win once regardless of how many replies they posted.
When true, only entries from users who retweeted the original tweet are eligible.
X username that entrants must follow to be eligible. The @ prefix is stripped if included.
Minimum follower count required for eligible entries.
Minimum account age in days. Accounts younger than this are excluded.
Filter entries by tweet language code (e.g. en, tr, es).
Array of keywords that must appear in the reply text. Entries missing any keyword are excluded.
Array of hashtags that must appear in the reply text. Include the # prefix.
Array of usernames that must be mentioned in the reply text. Include the @ prefix.
Response X tweet ID extracted from the URL.
Total number of replies collected from the tweet.
Entries that passed all filters.
Selected winners and backup winners. Winner position (1-indexed).
X username of the winner.
Tweet ID of the winning reply.
true if this is a backup winner.
{ "id" : "66666" , "tweetId" : "1893456789012345678" , "totalEntries" : 847 , "validEntries" : 312 , "winners" : [ { "position" : 1 , "authorUsername" : "alice_web3" , "tweetId" : "1893456789012345700" , "isBackup" : false }, { "position" : 2 , "authorUsername" : "bob_dev" , "tweetId" : "1893456789012345701" , "isBackup" : false }, { "position" : 3 , "authorUsername" : "charlie_nft" , "tweetId" : "1893456789012345702" , "isBackup" : false }, { "position" : 4 , "authorUsername" : "diana_crypto" , "tweetId" : "1893456789012345703" , "isBackup" : true }, { "position" : 5 , "authorUsername" : "eve_trades" , "tweetId" : "1893456789012345704" , "isBackup" : true } ] }
{ "error" : "invalid_input" }
Missing or malformed request body. Ensure tweetUrl is a string. { "error" : "unauthenticated" }
Missing or invalid API key / session cookie. { "error" : "no_subscription" }
No active subscription or usage cap reached. Possible error values: no_subscription, subscription_inactive, usage_limit_reached. Check your usage quota . { "error" : "x_api_unavailable" }
The upstream X API returned an error. Retry after a short delay. Next steps: Get Draw to retrieve full draw details including tweet metadata, Export Draw to download results as CSV/XLSX/Markdown, or List Draws to see your draw history.
