X Twitter Search Scraper

Search public X/Twitter results by keyword, hashtag, advanced operator, or search tab and export normalized records for monitoring, lead research, market intelligence, and AI-agent workflows.

What it does

This actor searches the public X/Twitter search surface through a provider-backed API. It does not require user cookies, browser sessions, login credentials, or an X developer account.

Use it to collect:

• Tweets from the Top or Latest search tabs
• Hashtag results such as #buildinpublic
• Advanced X search operators such as from:openai min_faves:100
• People/profile results for account discovery
• Photos and Media search results

Input

The most important fields are:

• queries - one or more search queries, hashtags, usernames, or advanced operators
• searchType - Top, Latest, People, Photos, or Media
• maxResults - maximum records to save across all queries
• maxPagesPerQuery - pagination depth per query
• startCursor - optional cursor from RUN_SUMMARY.nextCursors for continuation
• includeRaw - include provider payloads for debugging field drift

Example:

{
  "queries": ["ai agents", "#buildinpublic", "from:openai min_faves:100"],
  "searchType": "Latest",
  "maxResults": 100,
  "maxPagesPerQuery": 10,
  "dedupeResults": true
}

Output

Each dataset item is normalized into a stable schema:

• recordType
• searchQuery
• searchType
• tweetId
• tweetUrl
• text
• createdAt
• authorUsername
• authorName
• authorId
• authorUrl
• authorVerified
• authorFollowers
• replyCount
• retweetCount
• quoteCount
• likeCount
• viewCount
• hashtags
• mentions
• urls
• mediaUrls
• listName
• listUrl
• provider
• providerPage
• scrapedAt

The actor also writes:

• OUTPUT - concise machine-readable summary
• RUN_SUMMARY - detailed run telemetry, warnings, status codes, and next cursors

Public data only

This actor is designed for public X/Twitter search results. It does not unlock private accounts, hidden posts, deleted posts, DMs, private follower graphs, or login-only data.

Pricing

The actor uses pay-per-event pricing:

• Actor start: $0.00005
• X/Twitter search result saved: $0.003

Reliability

The actor uses provider retries, status-code telemetry, clean empty-result handling, dedupe, cursor persistence, and graceful terminal summaries. Missing provider credentials or upstream failures are written to OUTPUT and RUN_SUMMARY instead of crashing without context.

Common use cases

• Brand monitoring on X/Twitter
• Trend and hashtag discovery
• Competitor tracking
• Creator and influencer research
• Social listening pipelines
• AI-agent research tools
• Sales and recruiting signal discovery

Tips

• Use Latest for fresh monitoring.
• Use Top for higher-signal results.
• Use People when you need accounts rather than tweets.
• Use narrower queries and X search operators for cleaner datasets.
• Use startCursor only for continuing one query/search type from a previous run.