Twitter extraction status & result progress

{
  "job": {
    "id": "id",
    "toolType": "follower_explorer",
    "status": "completed",
    "totalResults": 0,
    "createdAt": "2026-08-23T10:00:00Z"
  },
  "results": [],
  "hasMore": false,
  "pollAfterMs": 0,
  "waitUrl": "/api/v1/extractions/id?wait=10&limit=1&outputMode=compact"
}

{
  "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": {
    "id": "<string>",
    "toolType": "<string>",
    "status": "<string>",
    "totalResults": 123,
    "targetTweetId": "<string>",
    "targetUsername": "<string>",
    "targetUserId": "<string>",
    "targetCommunityId": "<string>",
    "searchQuery": "<string>",
    "errorMessage": "<string>",
    "createdAt": "<string>",
    "completedAt": "<string>"
  },
  "results": [
    {
      "id": "<string>",
      "xUserId": "<string>",
      "xUsername": "<string>",
      "xDisplayName": "<string>",
      "xFollowersCount": 123,
      "xVerified": true,
      "xProfileImageUrl": "<string>",
      "tweetId": "<string>",
      "tweetUrl": "<string>",
      "tweetText": "<string>",
      "tweetCreatedAt": "<string>",
      "media": [
        {}
      ],
      "likeCount": 123,
      "retweetCount": 123,
      "replyCount": 123,
      "quoteCount": 123,
      "viewCount": 123,
      "bookmarkCount": 123,
      "createdAt": "<string>",
      "enrichmentData": {}
    }
  ],
  "hasMore": true,
  "pollAfterMs": 123,
  "waitUrl": "<string>",
  "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 and maximum: 1000.

string

Pass the previous nextCursor unchanged. Do not send offset; it returns 400.

number

Wait up to 10 seconds when the job is active. Defaults to 0.

string

Use compact for core fields and tweet counts. Use full for nested enrichment. Use raw for a source copy. 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

Canonical X post URL. 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.

object[]

Attached media with outputPreset=flat. Full nested output stores it at enrichmentData.tweet.media.

number

Likes. Omitted when unavailable.

number

Reposts. Omitted when unavailable.

number

Replies. Omitted when unavailable.

number

Quotes. Omitted when unavailable.

number

Views. Omitted when unavailable.

number

Bookmarks. Omitted when unavailable.

string

ISO 8601 timestamp of when the result was created.

object

Additional profile, Tweet, media, and article metadata. Compact output omits this object. Full output keeps it nested. Flat output merges its fields into the result.

boolean

Whether more results exist beyond this page.

number

Recommended delay before another immediate check.

string

Relative polling URL. It waits 10 seconds and returns 1 compact row.

string

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

With outputMode=compact, tweet results keep tweetUrl, likeCount, retweetCount, replyCount, quoteCount, viewCount, and bookmarkCount. Compact output omits xProfileImageUrl and enrichmentData.

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": "id",
    "toolType": "follower_explorer",
    "status": "completed",
    "totalResults": 0,
    "createdAt": "2026-08-23T10:00:00Z"
  },
  "results": [],
  "hasMore": false,
  "pollAfterMs": 0,
  "waitUrl": "/api/v1/extractions/id?wait=10&limit=1&outputMode=compact"
}

{
  "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": {
    "id": "<string>",
    "toolType": "<string>",
    "status": "<string>",
    "totalResults": 123,
    "targetTweetId": "<string>",
    "targetUsername": "<string>",
    "targetUserId": "<string>",
    "targetCommunityId": "<string>",
    "searchQuery": "<string>",
    "errorMessage": "<string>",
    "createdAt": "<string>",
    "completedAt": "<string>"
  },
  "results": [
    {
      "id": "<string>",
      "xUserId": "<string>",
      "xUsername": "<string>",
      "xDisplayName": "<string>",
      "xFollowersCount": 123,
      "xVerified": true,
      "xProfileImageUrl": "<string>",
      "tweetId": "<string>",
      "tweetUrl": "<string>",
      "tweetText": "<string>",
      "tweetCreatedAt": "<string>",
      "media": [
        {}
      ],
      "likeCount": 123,
      "retweetCount": 123,
      "replyCount": 123,
      "quoteCount": 123,
      "viewCount": 123,
      "bookmarkCount": 123,
      "createdAt": "<string>",
      "enrichmentData": {}
    }
  ],
  "hasMore": true,
  "pollAfterMs": 123,
  "waitUrl": "<string>",
  "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