X Search
Run advanced X search queries and normalize the top matching public posts.
What it does
Searching X programmatically requires the expensive Premium API tier. This connector runs advanced X search queries and returns normalized results — matched post count, top author, and latest post timestamp.
Inputs
| Parameter | Format | Example | Required |
|---|---|---|---|
query | string | SEO tools launch 2026 | Yes |
limit | number | 10 | No |
Outputs
| Field | Type | Description |
|---|---|---|
matchedPosts | number | Number of posts matching the search query |
topAuthor | string | The author with the highest engagement in results |
topPostAt | string | Timestamp of the most relevant or recent matching post |
Example output
Input
query: "SEO tools launch 2026" limit: 5
Output
# X Search Results - Query: SEO tools launch 2026 - Matched Posts: 5 - Top Author: @searchengland - Top Post: 2026-03-07T10:30:00Z
What it means
Five posts matched the query. The most engaged author was @searchengland, active as of March 7, 2026.
Last tested: 2026-03-10
How to install
Via CLI
Via web
- Visit the connector catalog and find X Search.
- Click Install connector and acknowledge any training requirements.
- Complete authorization if prompted.
- Use the connector from Chat or the CLI.
Auth and permissions
| OAuth required | No |
| Managed auth | Included, no API key needed |
| Bring your own key (BYOK) | Not supported in v1 |
| Audit logged | Every request is logged with input, result, cost, and timestamps |
| Training acknowledgment | Not required |
Admins can restrict this connector via blacklist or whitelist in the admin panel.
Limits and edge cases
- •Default limit is 10 results; maximum is 50.
- •Search results are limited to public posts — protected accounts are excluded.
- •Complex boolean queries may not be fully supported by the current search stack.
Common use cases
Monitor brand mentions on X in real time
Search for your brand name and track who is talking about you.
Research trending topics before writing content
Search X for a keyword and see who is leading the conversation.
Frequently asked questions
What search syntax is supported?
Basic keyword search and common operators. Complex boolean logic may be limited.
How far back does the search go?
Depends on the current search window. Typically the most recent 7–30 days of public posts.
Related connectors
X Post Read
Read and summarize a public X or Twitter post with a compact Markdown result.
X Post Replies Read
Read public replies for a referenced X post.
X Article Read
Read public X article pages with normalized title, author, and excerpt output.