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

Was this document helpful?

Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.