Products for researchers

Find the right solution for your research

Our product offerings for academic researchers range from free publicly available data to enterprise level access. Check out out the details below and find the solution that fits your research needs.

Standard API

Our standard API endpoints are free and publicly available to all approved researchers. All you have to do is apply for an account.

Premium API

With a month-to-month paid subscription, our premium API endpoints provide access to filter the entire public history of Tweets through boolean queries.

Enterprise API

Our enterprise API is best for well-funded academic research labs or advanced research projects. This API has similar features as our premium API, but also supports increased levels of access and additional reliability tools and filtering capabilities. To learn more, contact our Enterprise Sales Team.

  • Standard
  • Premium
  • Enterprise

Standard API

statuses/filter

Description:
A stream of Tweets delivered in real-time as they are created based on simple filtering of keywords, user handles, or geo locations

Common use cases:

  • Topical analysis
  • Event detection
  • Analysis of events in real-time

Product details:
The statuses/filter endpoint has a volume cap of 1% of the total firehose and if the stream’s velocity or throughput exceeds that limit, the stream will begin to drop Tweets. The stream is not a 1% sample; consumption is simply capped at 1%. It delivers complete data based on your filter below that 1% volume threshold.

Documentation:

Technical Guides
API Reference

search/tweets

Description:
Filtered access to the last seven days of public Tweets through boolean queries

Product details:
Data is delivered in a request-response model with pagination. The endpoint supports both temporal and relevance based sorting. Data returned from the endpoint is sampled, focused on relevance rather than completeness. It is not full-fidelity and was originally developed to support Twitter’s consumer search experience with a focus on quality of results for a consumer rather than completeness of data for research purposes. While it is not sampled, it does exclude Tweets based on various filters to downrank Tweets that may be spam or abusive and will generally bias toward excluding Tweets that may be false positives. Data collected from this endpoint is likely to be biased in different ways based on its lack of completeness and the applied filters.

Common use cases:

  • “Discovery” and data exploration
  • Retrieving example Tweets

Documentation:

Technical Guides
API Reference

statuses/user_timeline

Description:
Public Tweets from a given user

Product details:
Data is delivered in a request-response model with pagination. The endpoint is limited to the last 3200 Tweets from a user. 

Common use cases:

  • Topics involving things like public figures, politicians
  • Develop additional context around a Tweet identified through other means

Documentation:

Technical Guide
API Reference

statuses
/mentions_timeline

Description:
Public Tweets mentioning a given user

Product details:
Data is delivered in a request-response model with pagination. The endpoint is limited to the last 800 Tweets mentioning a user.

Common use cases:

  • Topics involving things like public figures, conversations
  • Develop additional context around a Tweet identified through other means

Documentation:

Technical Guide
API Reference

statuses/sample

Description:
A statistically random 1% sample of all Tweets created on the Twitter platform delivered in real-time as they are created

Product details:
All connections to this endpoint will receive the equivalent 1% Tweets/sample. When tracking or identifying trends or events with statuses/sample you can encounter a lot of false signal and it is not well suited for precisely pinpointing when a trend or event emerged.

Common use cases:

  • Longitudinal analysis of macro trends
  • Longitudinal topical analys
  • Data processing and pipelines
  • Projects related to scale
  • Projects only requiring a sampled dataset

Documentation:

Technical Guide
API Reference

“Follow graph”

/followers/ids

/followers/list

/friends/ids

/friends/list

/friendships/lookup

/friendships/no_retweets/ids

 

Description:
Return information about the relationship between people on the platform.

Product details:
Includes endpoints that provide a list of the people that a given Twitter account follows, aka "friends", and the people following that account, aka “followers”. 

Common use cases:

  • Understanding networks, communities and movements
  • Understanding the relationship between subjects
  • Understanding the spread of information

Documentation:

Product Overview
API Reference

Premium API

Full-archive Search

Description:
Filtered access to the entire public history of Tweets through boolean queries

Product details:
Data is delivered in a request-response model with pagination. The API supports a more advanced query language than the search/tweets endpoint. The API also provides counts of query matches to understand the shape and volume of the data matching a query.

Common use cases:

  • Historical topic analysis
  • Historical event analysis
  • Longitudinal studies

Documentation:

30-day Search

Description:
Filtered access to the last 30 days of the public history of Tweets through boolean queries

Product details:
Data is delivered in a request-response model with pagination. The API supports a more advanced query language than the search/tweets endpoint. The API also provides counts of query matches to understand the shape and volume of the data matching a query. 

Common use cases:

  • Recent topic analysis
  • Recent event analysis

Documentation:

Technical Guide
API Reference
Pricing

Enterprise API

PowerTrack

Description:
A highly-reliable, full-fidelity, filtered stream of Tweets delivered in real-time as they are created based on a set of boolean rules.

Product details:
PowerTrack is the enterprise alternative to the standard statuses/filter endpoint with a significantly enhanced filter language and reliability features to avoid data loss.

Common use cases:

  • Topical analysis
  • Event detection
Full-archive Search

Description:
Filtered access to the entire public history of Tweets through boolean queries

Product details:
The enterprise version of the Full-Archive Search API is equivalent to the premium version but supports increased scale and access levels.

Common use cases:

  • Historical topic analysis
  • Historical event analysis
  • Longitudinal studies
30-day Search

Description:
Filtered access to the last 30 days of the public history of Tweets through boolean queries

Product details:
The enterprise version of the 30-Day Search API is equivalent to the premium version but supports increased scale and access levels.

Common use cases:

  • Recent topic analysis
  • Recent event analysis
Historical PowerTrack

Description:
Job-based processing of the entire history of Tweets for file download based on boolean filters.

Product details: 
Intended for well-funded enterprises and institutions only, and purchased as an annual subscription, account holders may run multiple jobs by API each month. Data is only available in JSON format (not CSV/TSV) and requires download of a large number of data files in parallel.

Common use cases:

  • Historical topic analysis
  • Historical event analysis
  • Longitudinal studies
Decahose

Description:
A statistically random 10% sample of all Tweets created on the Twitter platform delivered in real-time as they are created

Product details:
The Decahose is the enterprise equivalent of the statuses/sample endpoint.

Common use cases:

  • Trend and event detection
  • Data processing and pipelines
  • Projects related to scale
  • Projects only requiring a sampled dataset

Explore our experimental APIs

If you’re interested in testing and providing feedback on our experimental APIs, check out Twitter Developer Labs.