x_search
Search recent public X/Twitter posts using search operators like from:, lang:, or since: to filter by author, language, or date. Returns normalized tweet data including author, content, and engagement counts.
Instructions
Search recent public tweets on X/Twitter matching a query.
Args:
query: X search query (supports X search operators, e.g. from:user,
lang:en, since:2026-01-01).
max_count: max tweets to return (default from config, hard-capped).
Returns normalised items: {id, author, content, like_count, comment_count, publish_time, url, extra:{retweet_count, view_count, lang}}. Requires twscrape installed + X accounts added & logged in.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| max_count | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||