Twitter Giveaway History API & Past Draw Results

{
  "draws": [],
  "hasMore": false
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

GET

draws

Twitter Giveaway History API & Past Draw Results

curl --request GET \
  --url https://xquik.com/api/v1/draws \
  --header 'x-api-key: <x-api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

fetch('https://xquik.com/api/v1/draws', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/draws"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "draws": [
    {
      "id": "<string>",
      "tweetUrl": "<string>",
      "status": "<string>",
      "totalEntries": 123,
      "validEntries": 123,
      "createdAt": "<string>",
      "drawnAt": "<string>"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

List every Twitter giveaway draw owned by the authenticated Xquik account. Review source tweets, draw statuses, entry counts, and completion times. Continue through older results with an opaque cursor. This endpoint returns draw summaries. It does not return winner objects or eligibility rules. Retrieve one draw when winner verification needs those details.

Free - does not consume credits

List Past Twitter Giveaway Draws

Use GET /draws for a Twitter giveaway history page or audit queue. Results are ordered by createdAt and draw ID, newest first. Each row identifies its source tweet and inspected candidate counts.

List draw history

Call GET /draws for draw IDs, tweet URLs, statuses, entry counts, and timestamps. Follow nextCursor when hasMore is true.

Review past winners

Call GET /draws/{id} for source tweet metrics and ordered winner rows. Keep primary and backup winners separate.

Export audit records

Call GET /draws/{id}/export for winners or entries. Choose CSV, JSON, Markdown, PDF, text, or XLSX.

Run another draw

Call POST /draws with the source tweet and eligibility rules. Do not reuse an old draw ID for a new selection.

Use list results for discovery. Use detail results for winner verification. Use exports for review, customer support, or campaign archives.

curl --fail-with-body "https://xquik.com/api/v1/draws?limit=10" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

const response = await fetch(
  "https://xquik.com/api/v1/draws?limit=10",
  {
    headers: { "x-api-key": "xq_YOUR_KEY_HERE" },
  }
);
const page = await response.json();
if (!response.ok) {
  throw new Error(page.message || "Giveaway history request failed.");
}

const drawRows = page.draws.map((draw) => ({
  draw_id: draw.id,
  tweet_url: draw.tweetUrl,
  status: draw.status,
  total_entries: draw.totalEntries,
  valid_entries: draw.validEntries,
  created_at: draw.createdAt,
  drawn_at: draw.drawnAt || null,
}));
process.stdout.write(
  `${JSON.stringify({ drawRows, hasMore: page.hasMore, nextCursor: page.nextCursor || null })}\n`,
);

import requests

response = requests.get(
    "https://xquik.com/api/v1/draws",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
    params={"limit": 10},
)
response.raise_for_status()
page = response.json()
draw_rows = [
    {
        "draw_id": draw["id"],
        "tweet_url": draw["tweetUrl"],
        "status": draw["status"],
        "total_entries": draw["totalEntries"],
        "valid_entries": draw["validEntries"],
        "created_at": draw["createdAt"],
        "drawn_at": draw.get("drawnAt"),
    }
    for draw in page["draws"]
]
print({"draws": draw_rows, "next_cursor": page.get("nextCursor")})

package main

import (
	"fmt"
	"io"
	"log"
	"net/http"
)

func main() {
	req, err := http.NewRequest("GET", "https://xquik.com/api/v1/draws?limit=10", nil)
	if err != nil {
		log.Fatal(err)
	}
	req.Header.Set("x-api-key", "xq_YOUR_KEY_HERE")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		log.Fatal(err)
	}
	defer resp.Body.Close()

	body, err := io.ReadAll(resp.Body)
  if err != nil {
  	log.Fatal(err)
  }
  if resp.StatusCode < 200 || resp.StatusCode >= 300 {
  	log.Fatalf("giveaway history failed with %d: %s", resp.StatusCode, string(body))
  }
  fmt.Println(string(body))
}

Choose the Correct Giveaway Result

The list route answers which draws exist. It also shows when each draw ran. It cannot answer who won or which reply qualified. Use this handoff for each returned row:

Find Past Draws

Call GET /draws. Preserve id, tweetUrl, status, and createdAt.

Compare Entry Counts

Read totalEntries and validEntries from each list summary.

Verify Winners

Call GET /draws/{id}. Preserve position, username, tweet ID, and backup state.

Review the Source Tweet

Read the tweet ID, text, author, and engagement counts from draw detail.

Download Results

Call GET /draws/{id}/export. Select winners or entries and one format.

Do not label validEntries as a winner count. It counts inspected entries that passed the configured filters. Winner rows exist only in the detail response.

Build a Twitter Giveaway Audit Handoff

Store one summary row per draw. Keep the public draw ID as the join key. Preserve the source tweet URL instead of extracting a mutable username.

{
  "draw_id": "f4bd00a2-7b4e-4e59-8e1b-72e2c9f12345",
  "tweet_url": "https://x.com/xquik/status/1893456789012345678",
  "status": "completed",
  "total_entries": 847,
  "valid_entries": 312,
  "created_at": "2026-02-24T10:00:00.000Z",
  "drawn_at": "2026-02-24T10:05:00.000Z",
  "detail_path": "/api/v1/draws/f4bd00a2-7b4e-4e59-8e1b-72e2c9f12345",
  "winner_export_path": "/api/v1/draws/f4bd00a2-7b4e-4e59-8e1b-72e2c9f12345/export?format=csv&type=winners"
}

Fetch detail rows before publishing past giveaway winners. Preserve winner position and isBackup. This prevents backup winners from appearing as primary winners in dashboards or announcements.

Query Parameters

number

Results per page. Default 50, max 100.

string

Cursor for pagination. Pass the nextCursor value from a previous response to fetch the next page.

Headers

string

required

Send your Xquik API key. Generate one from the dashboard.

string

Send Bearer <token> instead of x-api-key when using OAuth 2.1.

Response

200 OK

array

List of draw objects ordered by creation date (newest first). Draw object fields:

string

Draw public ID returned by Xquik.

string

Original tweet URL used for the draw.

string

Draw status (e.g. completed).

number

Total replies collected from the tweet.

number

Entries that passed all filters.

string

ISO 8601 timestamp of when the draw was created.

string

ISO 8601 timestamp of when winners were selected. Present only for completed draws.

boolean

true if additional pages exist beyond this result set.

string

Pagination cursor. Pass it as cursor for the next page.

{
  "draws": [
    {
      "id": "f4bd00a2-7b4e-4e59-8e1b-72e2c9f12345",
      "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": "9a78ce15-2f3d-4f90-a86b-1049c7a26e92",
      "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"
}

401 Unauthenticated

{ "error": "unauthenticated" }

Missing or invalid API key / session cookie.

429 Rate Limited

{ "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 1 }

Too many requests. Wait for the Retry-After header before retrying.

Paginate Twitter Giveaway History

Draws use cursor pagination. Pass nextCursor as the next cursor value.

curl --fail-with-body "https://xquik.com/api/v1/draws?limit=10" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

curl --fail-with-body "https://xquik.com/api/v1/draws?limit=10&cursor=MjAyNi0wMi0yM1QxNjozMDowMC4wMDBafDY2NjY1" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

Continue fetching pages until hasMore is false. Cursors are opaque strings. Do not parse or construct them manually. Use a stable loop for a complete history export:

Node.js

const seenCursors = new Set();
const draws = [];
let cursor;

do {
  const url = new URL("https://xquik.com/api/v1/draws");
  url.searchParams.set("limit", "100");
  if (cursor) url.searchParams.set("cursor", cursor);

  const response = await fetch(url, {
    headers: { "x-api-key": "xq_YOUR_KEY_HERE" },
  });
  const page = await response.json();
  if (!response.ok) {
    throw new Error(page.message || "Giveaway history page failed.");
  }

  draws.push(...page.draws);
  const next = page.nextCursor;
  if (page.hasMore && (!next || seenCursors.has(next))) {
    throw new Error("Giveaway history cursor did not advance.");
  }

  if (next) seenCursors.add(next);
  cursor = page.hasMore ? next : undefined;
} while (cursor);

process.stdout.write(`${JSON.stringify(draws)}\n`);

Save the last accepted cursor after each durable batch. Restart from that cursor after a worker failure. Never build a cursor from timestamps or draw IDs.

Handle Giveaway History Responses

200 Draw Page

Read draws and hasMore. Read nextCursor only when another page exists.

401 Authentication

Authentication failed. Replace the API key or OAuth bearer token first.

429 Rate Limit

Too many requests. Honor Retry-After, then resume with the same cursor.

Do not advance the cursor after a failed request. A retry must request the same page. Append results only after the response succeeds.

Twitter Giveaway History Questions

How Do I View Past Twitter Giveaway Draws?

Call GET /draws with your Xquik API key. The newest draw summaries appear first. Follow nextCursor for older results.

Does Giveaway History Include Past Winners?

The list response does not include winners. Pass its id to GET /draws/{id} for primary and backup winner rows.

Can I Download Previous Twitter Giveaway Winners?

Yes. Fetch the draw ID first. Then export type=winners in CSV, JSON, Markdown, PDF, text, or XLSX.

What Do Total and Valid Entries Mean?

totalEntries counts inspected candidate entries. validEntries counts entries that passed the draw filters. Neither field reports the winner count.

How Do I Audit a Twitter Giveaway Result?

Store the list summary and draw ID. Fetch draw details and preserve winner order. Export entries when the review needs candidate-level evidence.

Does Listing Giveaway Draws Consume Credits?

No. Listing draw history is free. Running a new draw can consume credits.

Related: Get Draw retrieves one result. Use Create Draw for a new winner selection.

{
  "draws": [],
  "hasMore": false
}

{
  "error": "unauthenticated",
  "message": "Authentication required. Provide a valid API key or bearer token."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

Twitter Giveaway History API & Past Draw Results

curl --request GET \
  --url https://xquik.com/api/v1/draws \
  --header 'x-api-key: <x-api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

fetch('https://xquik.com/api/v1/draws', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/draws"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "draws": [
    {
      "id": "<string>",
      "tweetUrl": "<string>",
      "status": "<string>",
      "totalEntries": 123,
      "validEntries": 123,
      "createdAt": "<string>",
      "drawnAt": "<string>"
    }
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

​List Past Twitter Giveaway Draws

List draw history

Review past winners

Export audit records

Run another draw

​Choose the Correct Giveaway Result

Find Past Draws

Compare Entry Counts

Verify Winners

Review the Source Tweet

Download Results

​Build a Twitter Giveaway Audit Handoff

​Query Parameters

​Headers

​Response

​200 OK

​401 Unauthenticated

​429 Rate Limited

​Paginate Twitter Giveaway History

​Handle Giveaway History Responses

200 Draw Page

401 Authentication

429 Rate Limit

​Twitter Giveaway History Questions

​How Do I View Past Twitter Giveaway Draws?

​Does Giveaway History Include Past Winners?

​Can I Download Previous Twitter Giveaway Winners?

​What Do Total and Valid Entries Mean?

​How Do I Audit a Twitter Giveaway Result?

​Does Listing Giveaway Draws Consume Credits?

List Past Twitter Giveaway Draws

Choose the Correct Giveaway Result

Build a Twitter Giveaway Audit Handoff

Query Parameters

Headers

Response

200 OK

401 Unauthenticated

429 Rate Limited

Paginate Twitter Giveaway History

Handle Giveaway History Responses

Twitter Giveaway History Questions

How Do I View Past Twitter Giveaway Draws?

Does Giveaway History Include Past Winners?

Can I Download Previous Twitter Giveaway Winners?

What Do Total and Valid Entries Mean?

How Do I Audit a Twitter Giveaway Result?

Does Listing Giveaway Draws Consume Credits?