Twitter's search endpoints
Please note:
We launched a new version of the standard Search Tweets endpoint as part of Twitter API v2: Early Access. If you are currently using the standard v1.1 search Tweets endpoint, you can use our migration materials to start working with the newer endpoint.
Twitter API's historical search endpoints
Over the past decade, the Twitter API has made available a variety of different tiers of endpoints that enable developers to search for historical Tweets or historical Tweet counts. This page will describe each tier or version to help you figure out which endpoint is right for your use case.
Standard v1.1
This search API searches against a sampling of recent Tweets published in the past 7 days. Part of the v1.1 set of APIs.
Premium v1.1
Free and scalable paid access to either the last 30 days of Tweets or access to Tweets from as early as 2006. Built on the reliability and full-fidelity of our enterprise data APIs, these endpoints provide the opportunity to upgrade your access as your app and business grow.
Enterprise
Enterprise-level access to either the last 30 days of Tweets or access to Tweets from as early as 2006. Provides full-fidelity data, direct account management support, and dedicated technical support to help with integration strategy.
Twitter API v2
Twitter's latest offering includes a replacement endpoint for the standard 7 days search. Twitter API v2 includes many new features, such as the ability to retrieve new data fields like advanced metrics and Tweet annotations, provides more flexibility on which fields return with each payload, and much more.
Feature summary
| Category | Product name | Supported history | Query capability | Counts endpoint | Data fidelity |
|---|---|---|---|---|---|
| Standard | Standard Search API |
7 days | Standard operators | Not available | Incomplete |
| Premium | Search Tweets: 30-day endpoint |
30 days | Premium operators | Available | Full |
| Premium | Search Tweets: Full-archive endpoint | The entire archive | Premium operators |
Available | Full |
| Enterprise | 30-day Search API |
30 days | Enterprise operators |
Included | Full |
| Enterprise | Full-archive Search API |
The entire archive | Enterprise operators |
Included | Full |
| Twitter API v2 | Recent search | 7 days | Twitter API v2 operators | Not available yet | Full |
