Skip to main content
GET https://xquik.com/api/v1/extractions/{id}/export
Free. This endpoint does not consume credits.

File handoff

Treat the response body as file bytes. Save it first. Then pass the local path to the CRM import, warehouse load, queue, or agent. Do not print downloaded export bytes to shared logs.
The response Content-Disposition header contains the server filename. Store it when you need an audit trail. The trail connects the downloaded file to the extraction job.

Format handoff map

CRM CSV

Use format=csv for CRM imports, spreadsheet checks, and follower or reply upserts. Name reply jobs xquik-replies.csv and follower jobs xquik-followers.csv.

App JSON

Use format=json for app ingestion, queue replay, or structured storage. Each row keeps the nested enrichmentData of its result, with media and entities. Store the extraction ID and server filename with the local path.

Analyst XLSX

Use format=xlsx for analyst review and account-management workbooks when people need filters or formulas.

Report formats

Use format=md, md-document, pdf, or txt for human-readable reports. A PDF above 10,000 rows comes as a ZIP of PDF parts.
To process rows as they arrive, use Extraction Workflow. With it, write JSON Lines from paginated GET /extractions/{id} results.

Headers

Path parameters

Query parameters

Export filters

Export columns

The extraction tool type decides the columns. Default exports include 33 columns. article_extractor exports 11 article columns. JSON rows also keep each result’s nested enrichmentData, as Get Extraction returns it.

Default result columns

All extraction tools except article_extractor use the default result column set. Some enrichment columns may be empty when the result does not include that data.

User identity

User ID, Username, Display Name, Verified, and Profile Image.

Audience metrics

Followers, Following, Posts, Media Count, and Favorites.

Profile context

Description, Location, Email, Phones, Links, and Cover Picture. Email holds the first email the profile publishes. Phones & Links hold every number & link it publishes, joined by a comma & a space.

Tweet content

Tweet ID, Tweet URL, Tweet Text, and Tweet Created At. Tweet URL falls back to the status URL when the username is unavailable.

Tweet engagement

Likes, Reposts, Replies, Quotes, Views, and Bookmarks.

Tweet metadata

Language, Source, and Conversation ID.

Article metadata

Article Title, Article Preview, Article Body, and Article Contents JSON.

Article extractor columns

article_extractor uses a shorter column set for articles.

Article identity

Article Title, Cover Image, Article Body, and Article Contents JSON.

Author identity

Author, Username, and Verified.

Author reach

Followers.

Article engagement

Views, Likes, and Quotes.

Response

Returns a file download. The response includes a Content-Disposition header with the filename.

CSV

format=csv returns text/csv; charset=utf-8 with filenames like extraction-reply_extractor-*.csv.

JSON

format=json returns application/json; charset=utf-8 with filenames like extraction-reply_extractor-*.json. Each row adds the result’s nested enrichmentData to its columns.

Markdown

format=md returns text/markdown; charset=utf-8 with filenames like extraction-reply_extractor-*.md.

Markdown document

format=md-document returns text/markdown; charset=utf-8 with filenames like extraction-reply_extractor-*.md.

PDF

format=pdf returns application/pdf with filenames like extraction-reply_extractor-*.pdf.

TXT

format=txt returns text/plain; charset=utf-8 with filenames like extraction-reply_extractor-*.txt.

XLSX

format=xlsx returns application/vnd.openxmlformats-officedocument.spreadsheetml.sheet with filenames like extraction-reply_extractor-*.xlsx.
Exports include every row, ordered by result ID. A PDF above 10,000 rows comes as a ZIP of PDF parts.
Next steps.

Response examples

  • 200 <string>
  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 401 { "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." }
  • 403 { "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." }
  • 404 { "error": "not_found", "message": "Resource not found." }
  • 429 { "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }