X / Twitter Search
Search X (Twitter) with full advanced-search syntax (operators like from:, since:, until:, min_faves: work inline in the query) and get structured tweets with text, author, engagement, and cursor pagination. Limit is a per-page maximum; native pages contain approximately 20 tweets unless requireSinglePage selects a bulk lane.
- Price
- $0.00066 / call
- Success (7 days)
- —
- Median latency
- —
- Runs (30 days)
- 8
Details
- Tier
- bridged
- Safe to retry
- No
- Data
- Scraped from public web pages
- Source terms
- —
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query using X (Twitter) advanced-search syntax. IMPORTANT: bare terms are ANDed - a tweet must contain EVERY word, so a list of loosely related keywords matches nothing; use one short phrase or OR between alternatives (e.g. 'anyapi OR getanyapi'). You can embed X advanced-search operators... |
cursor | string | No | Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of search results. |
limit | integer | No | Per-page maximum number of results to return (1-50, default 20). A provider may return a smaller native page; follow nextCursor for more. |
queryType | string | No | Result ranking: 'Latest', 'Top', 'Photos', or 'Videos' (e.g. Latest). |
Call it
curl https://api.orcarouter.ai/v1/tools/anyapi.x-search-posts/run \
-H "Authorization: Bearer $ORCAROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"input":{"limit":20,"query":"query","queryType":"Latest"}}'curl "https://api.orcarouter.ai/v1/tools/functions?ids=anyapi.x-search-posts&format=openai" \
-H "Authorization: Bearer $ORCAROUTER_API_KEY"{
"mcpServers": {
"orcarouter": {
"type": "http",
"url": "https://api.orcarouter.ai/v1/tools/mcp",
"headers": {
"Authorization": "Bearer <ORCAROUTER_API_KEY>"
}
}
}
}Questions
How much does X / Twitter Search cost?
X / Twitter Search costs $0.00066 per call: 1,000 calls cost $0.66.
What does a $10 budget buy with X / Twitter Search?
About 15151 calls at $0.00066 per call.
What inputs does X / Twitter Search need?
Required inputs: query.
How do I call X / Twitter Search?
Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.
Alternatives
| Tool | Price | Success (7 days) | Median latency | Runs (30 days) | Tier |
|---|---|---|---|---|---|
| Search X (Twitter) posts by keywordTwitter: fetch search timeline (web) | $0.0011 / call | — | — | — | bridged |
| X / Twitter Community SearchSearch X (Twitter) communities by keyword and get their id, name, topic, and member count with cursor pagination. This is how you find a community URL to pass to twitter.community or twitter.community_tweets. | $0.00121 / call | — | — | — | bridged |
