Skip to main content
GET
Twitter scraper export API & CSV downloads
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 that 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. Xquik caps PDF at 10,000 rows.
For exports above 100,000 rows, use Extraction Workflow to write JSON Lines from paginated GET /extractions/{id} results.

Headers

string
required
Your API key. Session cookie authentication is also supported.

Path parameters

string
required
Extraction job ID returned from Create Extraction or List Extractions.

Query parameters

string
required
Export file format. One of: csv, json, md, md-document, pdf, txt, xlsx.

Export filters

integer
Minimum follower count.
integer
Maximum follower count.
integer
Minimum following count.
integer
Maximum following count.
integer
Minimum post count.
integer
Maximum post count.
integer
Minimum like count.
integer
Minimum reply count.
integer
Minimum repost count.
integer
Minimum view count.
boolean
Require a non-empty description.
boolean
Require a non-empty location.
boolean
Require media.
boolean
Match verified status.
string
Match a language code.
Search exported result text.
string
Include results on or after this date.
string
Include results on or before this date, inclusive.

Export columns

The extraction tool type decides the columns. Default exports include 29 columns. article_extractor exports 10 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, and Cover Picture.

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, and Article Body.

Article extractor columns

article_extractor uses a shorter column set for articles.

Article identity

Article Title, Cover Image, and Article Body.

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 stop at 100,000 rows (10,000 for PDF). For extractions with more results, the export includes the first 100,000 rows ordered by result ID.
Next steps. Get Extraction to page through results with the API, or List Extractions to find other extraction jobs to export.