curl "https://xquik.com/api/v1/draws?limit=10" \
-H "x-api-key: xq_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2" | jq
Query Parameters
Results per page. Default 50, max 100.
Cursor for pagination. Pass the nextCursor value from a previous response to fetch the next page.
Your API key. This endpoint also accepts session cookie authentication.
Response
200 OK
401 Unauthenticated
List of draw objects ordered by creation date (newest first). Original tweet URL used for the draw.
Draw status (e.g. completed).
Total replies collected from the tweet.
Entries that passed all filters.
ISO 8601 timestamp of when the draw was created.
ISO 8601 timestamp of when winners were selected. Present only for completed draws.
true if additional pages exist beyond this result set.
Pagination cursor. Pass as the after query parameter to fetch the next page. Present only when hasMore is true.
{
"draws" : [
{
"id" : "66666" ,
"tweetUrl" : "https://x.com/xquik/status/1893456789012345678" ,
"status" : "completed" ,
"totalEntries" : 847 ,
"validEntries" : 312 ,
"createdAt" : "2026-02-24T10:00:00.000Z" ,
"drawnAt" : "2026-02-24T10:05:00.000Z"
},
{
"id" : "66665" ,
"tweetUrl" : "https://x.com/xquik/status/1893456789012340000" ,
"status" : "completed" ,
"totalEntries" : 1240 ,
"validEntries" : 980 ,
"createdAt" : "2026-02-23T16:30:00.000Z" ,
"drawnAt" : "2026-02-23T16:35:00.000Z"
}
],
"hasMore" : true ,
"nextCursor" : "MjAyNi0wMi0yM1QxNjozMDowMC4wMDBafDY2NjY1"
}
{ "error" : "unauthenticated" }
Missing or invalid API key / session cookie.
Draws use cursor-based pagination . Each response includes hasMore and (when true) a nextCursor value. Pass nextCursor as the after query parameter to retrieve the next page.
curl "https://xquik.com/api/v1/draws?limit=10" \
-H "x-api-key: xq_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2" | jq
Continue fetching pages until hasMore is false. Cursors are opaque strings โ do not parse or construct them manually.
Related: Get Draw to retrieve full details for a specific draw ยท Create Draw to run a new giveaway draw.