Social teams
Campaign tracking
Export posts around a launch, hashtag, or brand query, then sort by author, engagement, media use, and source URL for reporting.
Limited Time — Lifetime Access for just $99. Lock in before prices rise.
This Twitter data scraper exports visible X/Twitter timeline, profile, hashtag, or search-page posts into a structured CSV. Import the workflow into the UScraper local desktop app, replace the starting URL, and collect author, handle, timestamp, tweet text, tweet URL, engagement counts, views, bookmarks, media URLs, and profile metadata without wiring the X API.
CSV
18
Any X URL
8 batches
Not required
At a glance
Use this template when you need a spreadsheet-first Twitter data extractor for
approved X pages. The default Navigate block opens https://x.com/X,
but you can replace it with a profile timeline, hashtag page, search result, or
advanced-search URL that loads in your browser session. That makes the workflow
useful for social listening, campaign review, creator research, public-interest
monitoring, and small AI annotation datasets.
The automation is intentionally transparent: set the viewport, navigate, wait for the page, pause for content, inject a collector script, scroll through visible batches, wait for hidden tweet rows, and export the data. If X shows a login wall, CAPTCHA, rate-limit message, or blocked guest state, the workflow records a diagnostic row so you can see why the run did not return normal tweet rows.
Tweets to CSV
Export Twitter tweets with source URLs, timestamps, text, visible media, and engagement labels in a format your team can filter, dedupe, and audit.
Infinite-scroll aware
The collector loops through multiple scroll batches and de-duplicates cards as X virtualizes the timeline.
Local desktop workflow
URLs, browser state, and the CSV stay in your desktop workflow unless you add your own sync, upload, or sharing step.
Flexible starting URLs
Use profiles, search pages, hashtags, or advanced-search URLs that you are permitted to access and review.
Who this helps
Social teams
Campaign tracking
Export posts around a launch, hashtag, or brand query, then sort by author, engagement, media use, and source URL for reporting.
Researchers
Public conversation review
Collect a bounded set of visible tweets with timestamps and profile metadata for coding, annotation, or qualitative analysis.
Agencies
Competitor monitoring
Compare public X activity without maintaining a custom scraper API integration or sending client research through a cloud actor.
For related social workflows, pair this page with the Twitter X Comments Scraper, Twitter Hashtag Scraper, and Reddit Search Scraper. Browse the UScraper template library when a tweet export leads to broader source collection.
How to use
Replace the starting URL
In Navigate, replace https://x.com/X with an approved profile,
hashtag, search, or advanced-search URL that loads in your browser session.
Confirm the export path
Structured Export writes twitter-scraper.csv with headers and
create mode. Change the save folder before client or topic-specific runs.
Run the scroll collector
UScraper loads the page, waits, injects the collector script, scrolls through visible batches, and builds hidden rows from tweet cards.
Open and verify the CSV
Spot-check row counts, source URLs, blank diagnostic fields, and engagement labels before using the file in reporting or analysis.
Output preview
The export mirrors the workflow definition and keeps one row per visible tweet
card. Diagnostic rows use page_status and
blocked_reason to explain login, CAPTCHA, or no-visible-tweet
states.
| page_status | profile_handle | author_name | handle | timestamp | tweet_text | tweet_url | replies_count | reposts_count | likes_count | views_count | media_urls |
|---|---|---|---|---|---|---|---|---|---|---|---|
| ok | @X | X | @X | 2026-06-12T14:15:20.000Z | Product update thread with launch notes and a media card. | https://x.com/X/status/1800000000000000000 | 42 | 310 | 2.8K | 140K | https://pbs.twimg.com/media/example.jpg |
| ok | @examplebrand | Example Brand | @examplebrand | 2026-06-11T09:05:00.000Z | Customer question thread about pricing and rollout. | https://x.com/examplebrand/status/1800000000000000001 | 8 | 27 | 164 | 9.7K | |
| blocked_or_login_required |
twitter-scraper.csvColumn
page_status
ok, blocked_or_login_required, or no_visible_tweets.
Column
blocked_reason
Page text captured when the scraper cannot see normal tweet cards.
Column
profile_name
Visible profile name from the loaded page when available.
Column
profile_handle
Profile handle detected from the current page.
Column
profile_followers
Visible follower label from profile pages.
Column
profile_following
Visible following label from profile pages.
Column
author_name
Display name on the tweet card.
Column
handle
Tweet author handle.
Column
timestamp
Datetime from the tweet time element.
Column
tweet_text
Visible tweet text normalized into one cell.
Column
tweet_url
Canonical status URL when exposed.
Column
replies_count
Visible reply count parsed from labels.
Column
reposts_count
Visible repost or retweet count.
Column
likes_count
Visible like count.
Column
views_count
Visible view count when X exposes it.
Column
bookmarks_count_or_label
Bookmark count or label when visible.
Column
media_urls
Visible media URLs joined with separators.
Column
captured_page_url
The X URL opened for the run.
X/Twitter content can be public, but automated collection may be limited by platform terms, robots directives, access controls, privacy law, copyright, and local regulations. Do not bypass login gates, CAPTCHAs, or technical restrictions, and get legal review before using exported data commercially.
Before you run
Operational guardrails for X/Twitter exports
Avoid aggressive repeated runs
X can slow, hide, challenge, or block automated sessions. Keep batches modest, avoid parallel loops, and pause when verification, unusual redirects, or incomplete timelines appear.
Tweet markup and labels can change
Empty exports, missing counts, or blank media fields usually mean the page did not load, X changed its markup, or the browser session did not expose enough tweet cards in time.
Use the right access path
For sanctioned production integrations, compare the official X API and its policies. Use this scraper only where it fits your legal, privacy, and platform-compliance review.
Download the free template, install the desktop app from UScraper download, and run a short validation batch before you export Twitter tweets at larger scale.
Download and use this template instantly
UScraper templates are open source. Improve this workflow or contribute a new one to help the community grow.
Contribute on GitHubBrowse more templates in the library
All TemplatesHere are some of our most common questions. Can't find what you're looking for?
View All FAQsDownload UScraper and build your first web scraper in under 10 minutes. No subscriptions, no code, no limits.
Available on Windows 10+ and macOS 12+ · Need help? [email protected]