Twitter Extraction Status & Result Progress

{
  "job": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "toolType": "follower_explorer",
    "status": "completed"
  },
  "results": [],
  "hasMore": false
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

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

{
  "error": "not_found",
  "message": "Resource not found."
}

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

GET

extractions

{id}

Twitter Extraction Status & Result Progress

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

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

fetch('https://xquik.com/api/v1/extractions/{id}', 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/extractions/{id}"

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

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

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

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

	fmt.Println(string(body))

}

{
  "job": {},
  "results": [
    {}
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

Free - does not consume credits

curl -X GET "https://xquik.com/api/v1/extractions/a1b2c3d4-e5f6-7890-abcd-ef1234567890?limit=100" \
  -H "x-api-key: xq_YOUR_KEY_HERE" | jq

const extractionId = "a1b2c3d4-e5f6-7890-abcd-ef1234567890";
const params = new URLSearchParams({ limit: "100" });

const response = await fetch(`https://xquik.com/api/v1/extractions/${extractionId}?${params}`, {
  method: "GET",
  headers: {
    "x-api-key": "xq_YOUR_KEY_HERE",
  },
});
const data = await response.json();

import requests

extraction_id = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
response = requests.get(
    f"https://xquik.com/api/v1/extractions/{extraction_id}",
    headers={"x-api-key": "xq_YOUR_KEY_HERE"},
    params={"limit": 100},
)
data = response.json()

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    req, err := http.NewRequest("GET", "https://xquik.com/api/v1/extractions/a1b2c3d4-e5f6-7890-abcd-ef1234567890?limit=100", nil)
    if err != nil {
        panic(err)
    }
    req.Header.Set("x-api-key", "xq_YOUR_KEY_HERE")

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

    var data map[string]interface{}
    if err := json.NewDecoder(resp.Body).Decode(&data); err != nil {
        panic(err)
    }
    fmt.Println(data)
}

Headers

string

required

Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.

Path parameters

string

required

Extraction job ID returned from Create Extraction or List Extractions.

Query parameters

number

Number of results to return per page. Default: 100. Maximum: 1000.

string

Result ID cursor for pagination. Use the nextCursor value from the previous response to fetch the next page.

string

Result fields: compact, full, or raw. Defaults to full.

string

Keep enrichment nested or merge it with flat.

string

Field names: source, camelCase, or snake_case.

boolean

Deprecated. Use outputMode=raw.

Extraction result page column	Response source	Export rule
Job ID	`job.id`	Keep this ID with every exported row.
Extraction tool	`job.toolType`	Preserve the tweet, follower, reply, or profile workflow.
Job state	`job.status`	Export final rows only after completion.
Total rows	`job.totalResults`	Compare this count with all saved pages.
Result ID	`results[].id`	Use this ID for result-page deduplication.
X user ID	`results[].xUserId`	Preserve the stable profile join.
Tweet fields	`tweetId`, `tweetText`, and `tweetCreatedAt`	Store them only when returned.
More pages	`hasMore`	Continue only while this value is `true`.
Next page	`nextCursor`	Pass this value as the next `cursor` parameter.

Response

200 OK

object

Extraction job metadata. Job object fields:

string

Unique extraction job ID.

string

Tool type used for this extraction.

string

Job status: completed, failed, or running.

number

Total number of extracted results.

string

Target tweet ID. Present for tweet-based tools.

string

Target username. Present for user-based tools.

string

Target X user ID. Present for user-based tools.

string

Target community ID. Present for community_extractor, community_moderator_explorer, community_post_extractor, community_search.

string

Search query. Present for people_search, community_search.

string

Error description. Only present for failed jobs.

string

ISO 8601 timestamp of when the job was created.

string

ISO 8601 timestamp of when the job finished. Only present for completed jobs.

object[]

Array of extracted user/tweet records for the current page.

Only id and xUserId are guaranteed on every result. All other fields are omitted entirely when unavailable (never set to null). Always check for the presence of a field before accessing it.

Result object fields:

string

required

Unique result ID.

string

required

X user ID.

string

X username (handle). Omitted if unavailable.

string

X display name. Omitted if unavailable.

number

Follower count at time of extraction. Omitted if unavailable.

boolean

Whether the user has a verified badge. Omitted if unavailable.

string

URL to the user’s profile image. Omitted if unavailable.

string

Tweet ID. Omitted for non-tweet-based extractions.

string

Tweet text content. Omitted for non-tweet-based extractions.

string

ISO 8601 timestamp of the tweet. Omitted for non-tweet-based extractions.

string

ISO 8601 timestamp of when the result was created.

object

Additional profile, tweet, and article metadata. Omitted when unavailable. Contains nested user fields (description, location, coverPicture, followingCount, favouritesCount, mediaCount, statusesCount), tweet fields (likeCount, replyCount, repostCount, quoteCount, viewCount, bookmarkCount, conversationId, lang, source), and article fields (title, bodyText, previewText).

Enrichment data is returned directly in the API response via the enrichmentData field and is also available through Export Extraction in CSV, XLSX, or Markdown format with flattened columns.

boolean

Whether more results exist beyond this page.

string

Cursor for the next cursor parameter. Only present when hasMore is true.

{
  "job": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "toolType": "reply_extractor",
    "status": "completed",
    "totalResults": 150,
    "targetTweetId": "1893704267862470862",
    "createdAt": "2026-02-24T10:00:00.000Z",
    "completedAt": "2026-02-24T10:00:12.000Z"
  },
  "results": [
    {
      "id": "b2c3d4e5-f6a1-7890-abcd-ef2345678901",
      "xUserId": "44196397",
      "xUsername": "elonmusk",
      "xDisplayName": "Elon Musk",
      "xFollowersCount": 210500000,
      "xVerified": true,
      "xProfileImageUrl": "https://pbs.twimg.com/profile_images/el0n.jpg",
      "tweetId": "1893710452812718080",
      "tweetText": "This is a great thread, thanks for sharing.",
      "tweetCreatedAt": "2026-02-24T10:05:00.000Z",
      "createdAt": "2026-02-24T10:00:05.000Z"
    },
    {
      "id": "c3d4e5f6-a1b2-7890-abcd-ef3456789012",
      "xUserId": "1849726401547751424",
      "xUsername": "xquik_",
      "xDisplayName": "Xquik",
      "xFollowersCount": 2400,
      "xVerified": false,
      "xProfileImageUrl": "https://pbs.twimg.com/profile_images/xquik.jpg",
      "tweetId": "1893712000288563200",
      "tweetText": "Agreed, very useful tool.",
      "tweetCreatedAt": "2026-02-24T10:08:30.000Z",
      "createdAt": "2026-02-24T10:00:06.000Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "c3d4e5f6-a1b2-7890-abcd-ef3456789012"
}

401 Unauthenticated

{ "error": "unauthenticated" }

Missing or invalid API key.

404 Not Found

{ "error": "not_found" }

No extraction job exists with this ID, or it belongs to a different account.

429 Rate Limited

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

Wait for the Retry-After value before polling again.

Paginating results

Results are ordered by ID ascending. To iterate through all results for a large extraction:

Make the initial request without the cursor parameter.
Check hasMore. Pass nextCursor as the next cursor value.
Repeat until hasMore is false.

import { appendFile } from "node:fs/promises";



const extractionId = "a1b2c3d4-e5f6-7890-abcd-ef1234567890";
let cursor = undefined;
let pageIndex = 0;

do {
  const params = new URLSearchParams({ limit: "1000" });
  if (cursor) params.set("cursor", cursor);
  const pageCursor = cursor ?? null;

  const response = await fetch(
    `https://xquik.com/api/v1/extractions/${extractionId}?${params}`,
    { headers: { "x-api-key": "xq_YOUR_KEY_HERE" } },
  );
  const data = await response.json();

  const rows = data.results.map((result) => ({
    extraction_id: extractionId,
    row_id: result.id,
    x_user_id: result.xUserId,
    x_username: result.xUsername,
    tweet_id: result.tweetId,
    tweet_text: result.tweetText,
    page_index: pageIndex,
    page_cursor: pageCursor,
    next_cursor: data.nextCursor ?? null,
    has_more: data.hasMore,
    handoff_format: "jsonl",
  }));

  if (rows.length > 0) {
    await appendFile(
      "xquik-extraction-results.jsonl",
      `${rows.map((row) => JSON.stringify(row)).join("\n")}\n`,
    );
  }

  cursor = data.hasMore ? data.nextCursor : undefined;
  pageIndex += 1;
} while (cursor);

Cursor handoff

Use GET /extractions/{id} when an integration needs structured JSON rows, incremental checkpoints, or more rows than a file export can return. Treat nextCursor as an opaque checkpoint and pass it back as cursor.

Page checkpoint

Store extraction_id, page_index, page_cursor, next_cursor, has_more, and result_count after each successful page.

Row shape

Persist selected fields such as row_id, x_user_id, x_username, tweet_id, and tweet_text. Do not dump raw result arrays into shared logs.

Large jobs

Stream pages to xquik-extraction-results.jsonl when you need replayable rows or results beyond the export row cap.

File handoff

Use Export Extraction when CSV, JSON, XLSX, Markdown, PDF, or TXT files are enough.

Store page checkpoints separately from row data:

{
  "extraction_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "page_index": 3,
  "page_cursor": "990100",
  "next_cursor": "990200",
  "has_more": true,
  "result_count": 1000,
  "handoff_format": "jsonl"
}

Next steps: Export Extraction to download all results as CSV, XLSX, or Markdown, or List Extractions to browse your job history.

{
  "job": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "toolType": "follower_explorer",
    "status": "completed"
  },
  "results": [],
  "hasMore": false
}

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

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

{
  "error": "not_found",
  "message": "Resource not found."
}

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

Twitter Extraction Status & Result Progress

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

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

fetch('https://xquik.com/api/v1/extractions/{id}', 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/extractions/{id}"

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

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

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

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

	fmt.Println(string(body))

}

{
  "job": {},
  "results": [
    {}
  ],
  "hasMore": true,
  "nextCursor": "<string>"
}

Overview

X API

X Write

Trends

Radar

Account

API Keys

Guest Wallets

Credits

X Accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

Twitter Extraction Status & Result Progress

Headers

Path parameters

Query parameters

Response

200 OK

401 Unauthenticated

404 Not Found

429 Rate Limited

Paginating results

Cursor handoff

Page checkpoint

Row shape

Large jobs

File handoff

​Headers

​Path parameters

​Query parameters

​Response

​200 OK

​401 Unauthenticated

​404 Not Found

​429 Rate Limited

​Paginating results

​Cursor handoff

Page checkpoint

Row shape

Large jobs

File handoff

Headers

Path parameters

Query parameters

Response

200 OK

401 Unauthenticated

404 Not Found

429 Rate Limited

Paginating results

Cursor handoff