Extractions
Twitter scraper export API & CSV downloads
Export tweet, follower, reply, profile, timeline, community, or list results in 7 formats, with documented CSV, XLSX, JSON, and PDF limits. See costs.
- 200
- 400
- 401
- 404
- 429
GET
Twitter scraper export API & CSV downloads
Free - 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.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.
Store the extraction ID and server filename with the local path.Analyst XLSX
Use
format=xlsx for analyst review and account-management workbooks when
humans need filters or formulas.Report formats
Use
format=md, md-document, pdf, or txt for human-readable reports.
PDF is capped at 10,000 rows.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.
string
Search exported result text.
string
Include results on or after this date.
string
Include results before this date.
Export columns
File format changes serialization only. The selected columns depend on the extraction tool type. Default exports include 29 columns;article_extractor
exports 10 article-focused columns.
Default result columns
All extraction tools exceptarticle_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 article-focused column set.
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
- 200 OK
- 400 Invalid format
- 401 Unauthenticated
- 404 Not found
- 429 Rate limited
Returns a file download. The response includes a PDF
Results are capped 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.
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.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.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.Next steps. Get Extraction to access results via the API with pagination, or List Extractions to find other extraction jobs to export.
- 200
- 400
- 401
- 404
- 429
Twitter scraper export API & CSV downloads