X (Twitter) Search Scraper

Search X (Twitter) for tweets by keyword, hashtag, phrase, or username — in real time, at scale, with no login required.

Whether you're tracking a brand mention, watching a trending topic, or researching a competitor's audience, this scraper pulls matching tweets straight into a clean, structured dataset ready for analysis.

---

What it does

Give it one or more search terms — a keyword, a #hashtag, a phrase, or an advanced query like from:username — and it returns matching tweets with full text, engagement numbers, media, and author details. No X account, login, or cookies needed to run it.

Key features

• Real-time search — results reflect what's on X right now, not a cached snapshot.
• Sort by Latest, Top, or Media — choose the most recent tweets, the most engaging ones, or tweets that include photos/video.
• Language filter — restrict results to a single language (e.g. English, Spanish, Japanese) using a simple 2-letter code.
• Deep pagination — collect anywhere from a handful of tweets up to tens of thousands per search.
• Automatic large-result handling — for very popular or broad queries, the scraper automatically pulls in additional historical results beyond what a single search normally surfaces, so you don't have to split queries yourself.
• Multiple search terms per run — queue up several searches at once and get all the results in a single dataset.

Input parameters

Parameter	Type	Description
searchTerms	array of strings	One or more search queries, e.g. "apple vision pro", "#AI", "from:elonmusk". Supports X's advanced search operators.
sort	string	Result order: Latest, Top, or Media. Default: Latest.
maxTweets	integer	Maximum tweets to collect per search term. Default: 100.
tweetLanguage	string	Optional 2-letter language code (e.g. en, es, ja) to filter results.
maxItems	integer	Optional overall cap on total tweets across all search terms combined.

Supported search operators

Use these directly inside any search term:

• from:username — tweets from a specific account
• since:2026-01-01 until:2026-06-01 — a date range
• #hashtag — hashtag search
• "exact phrase" — exact match
• -filter:replies — exclude replies

Output fields

Each result is a tweet object with:

Field	Description
id / url	Tweet ID and direct link
text	Full tweet text
createdAt	Publish timestamp
likeCount, retweetCount, replyCount, quoteCount	Engagement metrics
viewCount	View count
isRetweet / isReply / isQuote	Tweet type flags
hashtags, mentions, urls	Extracted entities
media	Image and video URLs attached to the tweet
quotedTweet	Full nested tweet object, when the tweet quotes another
author	Username, display name, follower count, verification status, bio, profile picture, and more

Example input

{
  "searchTerms": ["apple vision pro", "#AI"],
  "sort": "Latest",
  "maxTweets": 500,
  "tweetLanguage": "en"
}

Example output

{
  "type": "tweet",
  "id": "1987654321098765432",
  "url": "https://x.com/username/status/1987654321098765432",
  "text": "Just tried the new update and it's incredible...",
  "createdAt": "2026-07-01T12:00:00.000Z",
  "likeCount": 245,
  "retweetCount": 38,
  "replyCount": 12,
  "viewCount": 18204,
  "hashtags": ["AI"],
  "author": {
    "userName": "username",
    "name": "Display Name",
    "followers": 12500,
    "verified": true
  }
}

Cost and pricing

This actor uses the Pay Per Result model — you're only charged for each tweet returned, with no separate compute cost to worry about. There's a free tier included on every Apify plan, so you can try it before committing to a larger run.

Use cases

• Brand monitoring — track every mention of your brand, product, or campaign hashtag as it happens.
• Trend analysis — pull large volumes of tweets on a topic to measure sentiment, volume, and momentum over time.
• Competitor research — see what people are saying about competitors, or pull a competitor's own tweets with from:username.
• Market and audience research — analyze engagement patterns and audience reactions around any keyword or hashtag.
• Content discovery — find high-performing posts on a topic by sorting for Top results.

FAQ

Do I need a Twitter/X account? No — no login, cookies, or account setup required.

Can I search by hashtag or user? Yes — use #hashtag or from:username as a search term.

Which languages are supported? Any tweet language; use the language filter to narrow results to a single 2-letter ISO code (e.g. en, es, ja).

How many results can I get per search? Anywhere from a few tweets up to tens of thousands, depending on how popular the query is — set maxTweets to control the cap.

What formats can I export? JSON, CSV, Excel, HTML table, or pull results directly via the Apify API.