Limited Time — Lifetime Access for just $99. Lock in before prices rise.

UScraper
Social Media$50Free
Twitter Data Scraper for CSV Export logo

Twitter Data Scraper for CSV Export

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.

Output

CSV

Columns

18

Input

Any X URL

Scrolls

8 batches

API key

Not required

At a glance

Scrape Twitter data from profiles, search pages, and timelines

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

Use cases for Twitter to CSV exports

Social teams

Campaign tracking

Favorable to scraping

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

Favorable to scraping

Collect a bounded set of visible tweets with timestamps and profile metadata for coding, annotation, or qualitative analysis.

Agencies

Competitor monitoring

Favorable to scraping

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

Configure the X scraper workflow

1

Download and import

Download the hosted JSON template and import it into UScraper.

2

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.

3

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.

4

Run the scroll collector

UScraper loads the page, waits, injects the collector script, scrolls through visible batches, and builds hidden rows from tweet cards.

5

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

CSV columns produced by the template

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_statusprofile_handleauthor_namehandletimestamptweet_texttweet_urlreplies_countreposts_countlikes_countviews_countmedia_urls
ok@XX@X2026-06-12T14:15:20.000ZProduct update thread with launch notes and a media card.https://x.com/X/status/1800000000000000000423102.8K140Khttps://pbs.twimg.com/media/example.jpg
ok@examplebrandExample Brand@examplebrand2026-06-11T09:05:00.000ZCustomer question thread about pricing and rollout.https://x.com/examplebrand/status/18000000000000000018271649.7K
blocked_or_login_required
twitter-scraper.csv
CSV - UTF-8 - Create

Column

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.

Headers included - one row per visible tweet card or diagnostic state

Frequently asked questions

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

Practical limits and maintenance notes

Operational guardrails for X/Twitter exports

Rate limits

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.

Layout drift

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.

Policy

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.

Get Started

Download and use this template instantly

$50Free

What's Included

  • Template JSON file ready to import
  • Pre-configured scraping nodes
  • Works with UScraper desktop app

Open-source templates

UScraper templates are open source. Improve this workflow or contribute a new one to help the community grow.

Contribute on GitHub

Browse more templates in the library

All Templates
FAQ

Frequently asked questions

Here are some of our most common questions. Can't find what you're looking for?

View All FAQs

Stop writing scripts. Start scraping visually.

Download 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]