Retrieve public Twitter data via search.
Provide a query string and get structured tweet or user data back. No complex OAuth flows or multi-tiered API subscriptions required.
Live demo
Try it live.
Change the parameters and run a real request against the endpoint. No account, no key.
Free to try, no account. Costs 15 credits on your own key.
Run the request to see a live response.
curl -X POST https://automatio.ai/api/v1/query \
-H "Authorization: Bearer $AUTOMATIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"tool":"twitter_search","params":{"query":"web scraping","searchType":"Top","limit":5}}'How it works
One request, one response.
- 1
Define search parameters
Send a POST request specifying your query string and your preferred searchType to filter for tweets, people, or media.
- 2
Query the index
The endpoint processes your request against the platform's public search index to find matching profiles and recent posts.
- 3
Process structured JSON
Receive a JSON response containing engagement metrics and metadata formatted for immediate integration into your application.
Capabilities
What you get.
Everything this endpoint does, without running the infrastructure yourself.
Target specific media
Use the searchType parameter to isolate only photos or videos for visual content analysis and aggregation.
Identify relevant accounts
Search for people and profiles matching specific niches or keywords to assist in influencer research.
Monitor live events
Fetch the most recent posts chronologically using the Latest filter to track breaking news or live engagement.
Advanced query support
Filter results by language, date range, or specific handles directly within the query string using native platform operators.
Analyze social engagement
Access interaction counts for tweets to measure reach and perform basic sentiment calculations.
Cost of ownership
Build it yourself, or call this.
Both are real options. Here is what each one actually costs you.
Run it yourself
- Apply for X Developer portal access
- Manage OAuth 2.0 authentication and token refreshing
- Maintain infrastructure to handle strict rate limits
- Parse complex and deeply nested JSON responses.
Call the API
- Single Bearer token authentication
- Unified credit-based billing across all tools
- Simplified JSON response format
- No tiered feature gating or monthly subscription minimums.
Integrate
Built for the language you use.
One HTTP endpoint. Copy the call in your language and go.
curl -X POST https://automatio.ai/api/v1/query \
-H "Authorization: Bearer $AUTOMATIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "tool": "twitter_search", "params": { "query": "web scraping", "limit": 10, "searchType": "web scraping" } }'In production
What people build with it.
Brand Sentiment Dashboards
Input product names or brand keywords to receive a stream of recent tweets. This data is used to visualize public opinion and respond to customer feedback in real-time.
Lead Discovery Tools
Search for users asking specific questions or discussing problems within your niche. The resulting account metadata helps identify and export potential sales opportunities.
News Aggregation Pipelines
Filter for high-engagement tweets from verified sources using the query parameter. This powers automated news feeds that prioritize credible information over spam.
Choosing parameters
Which options matter.
The table below lists what exists. These are the calls worth making deliberately.
- searchType
- query
- limit
Alternatives
When to use something else.
A page that pretends it has no alternatives reads as an advert. These are the other real options.
X Official API
Best for enterprise-scale applications requiring write access, though it involves high monthly costs and strict tier restrictions.
DIY Web Scraping
A valid choice for developers who want to manage their own headless browser clusters and IP rotation infrastructure.
Before you integrate
What it does not do.
The boundaries are as useful as the features. These are the ones worth knowing up front.
Public visibility only
The endpoint cannot retrieve DMs, private profiles, or tweets from accounts that have restricted their content visibility.
Read-only access
This tool is designed for data retrieval and cannot be used to post tweets, like content, or follow accounts.
Recent index depth
Search results typically cover recent data and may not include every post sent since the platform's inception.
Reference
15 credits per call- Endpoint
- POST https://automatio.ai/api/v1/query
- Tool ID
- twitter_search
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | Search query (e.g., "AI news", "@elonmusk", "#bitcoin") | |
| limit | number | Max results to return (default: 20, max: 40) | |
| searchType | "Top" | "Latest" | "People" | "Photos" | "Videos" | Type of search results (default: Top) |
The same endpoints are available over MCP, and the full machine-readable catalogue lives in the API documentation.
Frequently Asked Questions
Find answers to common questions about Twitter Search API
Same data source
Every Twitter endpoint.
One key, one endpoint shape. These all bill per successful call the same way.
Twitter Replies API
Retrieve structured reply threads from any public tweet. Access comment text, author metadata, and engagement metrics via JSON for sentiment analysis or...
15 creditsTwitter Timeline API
Get recent tweets from any public Twitter profile via user ID. Extract tweet text, timestamps, and engagement data without managing browser automation.
15 creditsTwitter User API
Retrieve Twitter profile metadata including follower counts, bio, and verified status via a JSON POST request. Integrate public social data into your apps.
15 creditsOther endpoints
Browse all APIs →Supercharge your workflow with AI Automation
Automatio combines the power of AI agents, web automation, and smart integrations to help you accomplish more in less time.