Extractions

Get extraction results

Returns status and up to 1,000 results. A bounded wait reduces polling. Follow nextCursor when hasMore is true.

get/api/v1/extractions/{id}

Path parameters

idstring required

Resource ID returned by the matching create or list endpoint.

Query parameters

limitinteger

Maximum results per page (1-1000, default 1000).

cursorstring

Previous nextCursor. Offset pagination is not supported.

waitinteger

Wait up to this many seconds when the job is active.

outputMode'compact' | 'full' | 'raw'

Use compact for core fields and tweet counts, full for nested enrichment, or raw for a source copy.

outputPreset'nested' | 'flat'

Keep enrichment nested or merge it into each result.

fieldStyle'source' | 'camelCase' | 'snake_case'

Preserve source keys or convert result field names.

includeRawboolean

Use outputMode=raw instead.

Response

Extraction job with results

hasMoreboolean required

pollAfterMsinteger required

waitUrlstring required

nextCursorstring

Example response

{
  "job": {
    "id": "id",
    "toolType": "follower_explorer",
    "status": "completed",
    "totalResults": 0,
    "createdAt": "2026-08-23T10:00:00Z"
  },
  "results": [],
  "waitUrl": "/api/v1/extractions/id?wait=10",
  "nextCursor": "abc123"
}

Changes

Changed in 7 of the 19 revisions of this API.212337

Aug 28, 2026f23b15f4dac23See the full diff
- ●
  added the new deadline_reached enum value to the job/completionReason response property for the response status 200
  response-property-enum-value-added
- ●
  added the new pagination_safety_limit enum value to the job/completionReason response property for the response status 200
  response-property-enum-value-added
- ●
  added the new partial_failure enum value to the job/completionReason response property for the response status 200
  response-property-enum-value-added
Aug 25, 202621827353271b22See the full diff
- ○
  added the new optional query request parameter wait
  new-optional-request-parameter
- ○
  added the optional property results/items/bookmarkCount to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/enrichmentData to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/likeCount to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/quoteCount to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/replyCount to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/retweetCount to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/tweetCreatedAt to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/tweetId to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/tweetText to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/tweetUrl to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/viewCount to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/xDisplayName to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/xFollowersCount to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/xProfileImageUrl to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/xUsername to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property results/items/xVerified to the response with the 200 status
  response-optional-property-added
- ○
  added the required property pollAfterMs to the response with the 200 status
  response-required-property-added
- ○
  added the required property results/items/createdAt to the response with the 200 status
  response-required-property-added
- ○
  added the required property results/items/id to the response with the 200 status
  response-required-property-added
- ○
  added the required property results/items/xUserId to the response with the 200 status
  response-required-property-added
- ○
  added the required property waitUrl to the response with the 200 status
  response-required-property-added
Aug 24, 2026d6cb34aefa9f1See the full diff
- ▲
  for the query request parameter limit, default value was changed from 10 to 1000
  request-parameter-default-value-changed
Aug 23, 2026dc5ab8bc994e110See the full diff
- ▲
  for the query request parameter limit, default value was changed from 100 to 10
  request-parameter-default-value-changed
- ○
  added the optional property job/completedAt to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property job/completionReason to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property job/effectiveResultsLimit to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property job/errorMessage to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property job/resultsLimit to the response with the 200 status
  response-optional-property-added
- ○
  added the required property job/createdAt to the response with the 200 status
  response-required-property-added
- ○
  added the required property job/id to the response with the 200 status
  response-required-property-added
- ○
  added the required property job/status to the response with the 200 status
  response-required-property-added
- ○
  added the required property job/toolType to the response with the 200 status
  response-required-property-added
- ○
  added the required property job/totalResults to the response with the 200 status
  response-required-property-added
Aug 12, 20265d4938bb7de390See the full diff
- ●
  added the new closed enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new closed enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new closed enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400
  response-property-enum-value-added
- ●
  added the new closed enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new closed enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404
  response-property-enum-value-added
- ●
  added the new closed enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default
  response-property-enum-value-added
- ●
  added the new closed enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new closed enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new closed enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new closed enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default
  response-property-enum-value-added
- ●
  added the new expired enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new expired enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new expired enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400
  response-property-enum-value-added
- ●
  added the new expired enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new expired enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404
  response-property-enum-value-added
- ●
  added the new expired enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default
  response-property-enum-value-added
- ●
  added the new expired enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new expired enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new expired enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new expired enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new invalid_complete_replies_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new invalid_coverage_request enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new invalid_output_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new invalid_reply_options enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new login_service_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new missing_url enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new too_many_tweets enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default
  response-property-enum-value-added
Aug 12, 20264da209b29df830See the full diff
- ●
  added the new coverage_cursor_gone enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new coverage_cursor_gone enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new coverage_cursor_unavailable enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the allOf[Error]/error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the allOf[Error]/error/oneOf[subschema #2: StructuredError]/code response property for the response status 429
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 400
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status 404
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #1: LegacyErrorCode]/ response property for the response status default
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 400
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 401
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status 404
  response-property-enum-value-added
- ●
  added the new invalid_coverage_cursor enum value to the error/oneOf[subschema #2: StructuredError]/code response property for the response status default
  response-property-enum-value-added
Aug 9, 2026c367e6e8f8455See the full diff
- ○
  added the new optional query request parameter fieldStyle
  new-optional-request-parameter
- ○
  added the new optional query request parameter includeRaw
  new-optional-request-parameter
- ○
  added the new optional query request parameter outputMode
  new-optional-request-parameter
- ○
  added the new optional query request parameter outputPreset
  new-optional-request-parameter
- ○
  added the non-success response with the status 400
  response-non-success-status-added

Full history