Overview
X offers two search endpoints with different time ranges and access requirements:Recent Search
Search Posts from the last 7 days. Available to all developers.
Full-Archive Search
Search the complete archive back to 2006. Available to pay-per-use and Enterprise customers.
Use cases
- Brand monitoring — Track mentions of your brand or products
- Trend analysis — Analyze conversations around topics or events
- Research — Gather data for academic or market research
- Real-time listening — Build applications that react to new Posts
Endpoints
Query operators
Build queries using operators that match on Post attributes:Keyword operators
Keyword operators
User operators
User operators
Content operators
Content operators
Filter operators
Filter operators
Full operator reference
See all available operators and their access requirements
Recent Search
Search Posts from the last 7 days. Available to all developers.Features
- Up to 100 Posts per request
- Pagination for large result sets
- All core query operators
- 512-character query length (4,096 for Enterprise)
Quickstart
Make your first recent search request
API Reference
Full endpoint documentation
Full-Archive Search
Search the complete Post archive dating back to March 2006.Full-archive search is available to pay-per-use and Enterprise customers.
Features
- Up to 500 Posts per request
- Access to complete Post history
- All query operators available
- 1,024-character query length (4,096 for Enterprise)
Quickstart
Make your first full-archive search request
API Reference
Full endpoint documentation
Getting started
Prerequisites
- An approved developer account
- A Project and App in the Developer Console
- Your App’s keys and tokens
Build a query
Learn query syntax and operators
Pagination
Navigate through large result sets
Integration guide
Key concepts and best practices
Sample code
Working code examples