Products for researchers

Find the right data for your study


From free and open access to enterprise-level solutions for large-scale projects, we have you covered.

Three levels of access in our v1.1 Twitter API

Standard

These endpoints are free and publicly available to anyone with an approved Twitter developer account. They can be used to study real-time and recent conversations, explore and discover topics, observe trends over time, and analyze follower or friend networks on Twitter.

Premium

With a month-to-month paid subscription, these endpoints provide access to filter the entire public history of Tweets through boolean queries. This is best suited for a research study or lab that requires more depth, breadth, and precise filtering in their datasets.

Enterprise

These endpoints have similar features to the premium API, with additional reliability tools and filtering capabilities. This is best suited for academic institutions, organizations and research labs that require specialized access and more support. 

Get early access to the next generation of the Twitter API

Our first live v2 API endpoints can be used for free at the new Basic level with an approved developer account. Start exploring the new functionality that will be the foundation of future releases, including our plans to release elevated access tailored for academic researchers. We’re building in the open, so we can learn from along the way.

  • Standard API
  • Early Access v2 API
  • Premium APIs
  • Enterprise APIs

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

Details

This endpoint delivers complete data based on your filter, returning all Tweets below a volume cap of 1% of the total firehose. This stream is not a 1% sample; data consumption is simply capped at 1%. This makes it uniquely suitable for identifying the emergence of specific topics or events, provided you are connected to this stream when it occurs. Once the stream’s velocity or throughput exceeds its data limit, it will begin to drop Tweets.

Common use cases

  • Topical analysis
  • Event detection
  • Real-time event analysis

Documentation

search/tweets

Description

Search the last 7 days of public Tweets with filters applied through boolean queries

Details

This endpoint delivers data in a request-response model with pagination, and supports sorting both by time or relevance. Data from this endpoint focuses on relevance rather than completeness and is not full-fidelity. While this data is not sampled, it may exclude Tweets that are down-ranked as likely spam or abuse. As a result, there might be bias in your data from posts that have been removed, or that are not captured based on the keywords queried.

Common use cases

  • Topic discovery
  • Data exploration
  • Retrieving example Tweets

Documentation

statuses/user_timeline

Description

Public Tweets from a given user

Details

This endpoint delivers data in a request-response model with pagination. The endpoint is limited to the last 3200 Tweets from a user.

Common use cases

  • Research focused on public figures, e.g. politicians
  • Understanding the spread of information
  • Retrieving example Tweets

Documentation:

statuses/mentions_timeline

Description

Public Tweets mentioning a given user

Details

This endpoint delivers data in a request-response model with pagination. The endpoint is limited to the last 800 Tweets mentioning a user.

Common use cases

  • Research focused on public figures, conversations
  • Retrieving example Tweets

Documentation

statuses/sample

Description

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

Details

All connections to this endpoint will deliver a randomized 1% sample of Tweets. As this captures a sample of all conversations happening on Twitter, this is best suited for analyses that will amass a statistically significant amount of randomized data over time. As this is a sample, it is possible to encounter false signals without statistical significance, so this is not recommended for precisely pinpointing when trends or events emerge. 

Common use cases

  • Longitudinal analysis of macro trends
  • Longitudinal topical analysis
  • Approaches to data processing and pipelines
  • Topics related to scale of data
  • Projects only requiring a sampled dataset

Documentation

Follow graph:

/followers/ids
/followers/list
/friends/ids
/friends/list
/friendships/lookup
/friendships/no_retweets/ids

Description

This endpoint delivers information about the relationship between people on the platform.

Details

Follow graph endpoints return a list of people that a given Twitter account follows (“friends” endpoints), or people that follow a Twitter account (“followers” endpoints).

Common use cases

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

Documentation

Early Access v2 API

Filtered stream

Description

Filter the complete stream of real-time public Tweets.

Details

This endpoint delivers complete data in real-time based on your filters. This makes it uniquely suitable for identifying the emergence of specific topics or events, provided you are connected to this stream when it occurs.

This is not a sample of data, but once the stream’s velocity or throughput exceeds your access level’s data limit, it will begin to drop Tweets. Currently, this endpoint is available at the Basic access level and the volume is capped at 1%. 

It’s similar to the v1.1 statuses/filter endpoint, with more powerful filtering capabilities, conversation_id, Tweet annotations, and poll details.

Common use cases

  • Topical analysis
  • Event detection
  • Real-time event analysis

Documentation

Sampled stream

Description

A ~1% sample of all new Tweets as they are published in real-time.

Details

All connections to this endpoint will deliver a randomized 1% sample of new, public Tweets. As this captures a sample of all conversations happening on Twitter, this is best suited for analyses that will amass a statistically significant amount of randomized data over time. As this is a sample, it is not recommended for precisely pinpointing when trends or events emerge.

It’s similar to the v1.1 statuses/sample endpoint, with additional metadata including conversation_id, Tweet annotations, and poll details.

Common use cases

  • Longitudinal analysis of macro trends
  • Longitudinal topical analysis
  • Topics related to scale of data
  • Projects only requiring a sampled dataset

Documentation

Recent search

Description

Search the last 7 days of public Tweets and receive full-fidelity responses.

Details

This endpoint delivers data in a request-response model with pagination, and supports sorting by time.

Compared to the v1.1 search/tweets endpoint, this now returns the full public conversation that matches your query. This eliminates some of the biases introduced by the v1.1 version’s relevance and quality-focused sampling to serve consumer use cases. With the v2 endpoint, you can build a complete, unsampled dataset. It includes new Tweet object details, powerful filtering capabilities, conversation_id, and Tweet annotations.

Common use cases:

  • Topic discovery
  • Data exploration
  • Retrieving example Tweets

Documentation:

Tweet lookup

Description

Look up Tweets by ID.

Details

This endpoint is best used to receive up-to-date details on a Tweet, to verify that a Tweet is available, or to update your stored details following a compliance event.

Common use cases

Documentation

User lookup

Description

Look up users by name or ID.

Details

This endpoint is best used to receive up-to-date details on a user, to verify that a user exists, or to update your stored details following a compliance event.

Common use cases

  • Hydrating User objects using User IDs

Documentation

Premium APIs

Full-archive search

Description

Search the entire public history of Tweets with filters applied through boolean queries

Details

This endpoint delivers data in a request-response model with pagination. It also supports a more advanced query language (boolean) compared to the Standard API search/tweets endpoint, which can help yield more precise filtered results. This endpoint also includes query match counts, helping you understand the volume of data matching your query.

Common use cases

  • Historical topic analysis
  • Historical event analysis
  • Longitudinal studies

Documentation

30-day Search

Description

Search the last 30 days of public Tweets with filters applied through boolean queries

Details

This endpoint delivers data in a request-response model with pagination. It also supports a more advanced query language (boolean) compared to the Standard API search/tweets endpoint, which can help yield more relevant results. This endpoint also includes query match counts, helping you understand the volume of data matching your query.

Common use cases

  • Recent topic analysis
  • Recent event analysis

Documentation:

Enterprise APIs

Full-archive search

Description

Search the entire public history of Tweets with filters applied through boolean queries

Details

The enterprise version of the Full-archive Search endpoint is equivalent to the premium version, supported by increased scale and data access levels.

Common use cases

  • Historical topic analysis
  • Historical event analysis
  • Longitudinal studies

Documentation

30-day Search

Description

Search the last 30 days of public Tweets with filters applied through boolean queries

Details

The enterprise version of the 30-day Search endpoint is equivalent to the premium version, supported by increased scale and data access levels.

Common use cases

  • Recent topic analysis
  • Recent event analysis

Documentation

PowerTrack

Description

Return a complete, filtered stream of Tweets in real-time (as they are created) based on a set of boolean rules that query for keywords, user handles, or geo locations

Details

This endpoint is the enterprise alternative to the Standard API statuses/filter endpoint, supporting enhanced filter language (boolean) and reliability features that prevent data loss.

Common use cases

  • Topic analysis
  • Event detection
  • Real-time event analysis

Documentation

Historical PowerTrack

Description

This is a job-based file download of the entire history of Tweets based on an established set of boolean filters. This is customized for very specific research needs.

Details

This endpoint is intended for funded organizations, institutions, and labs seeking an annual subscription in order to run multiple jobs by API each month. This data is only available in JSON format (not CSV/TSV), and requires the ability to download a large number of data files in parallel.

Common use cases

  • Historical topic analysis
  • Historical event detection and 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

Details

All filter query connections to this endpoint will deliver a randomized 10% sample of Tweets that match the query. This is best suited for analyses that will amass a statistically significant amount of randomized data over time. This endpoint is the higher data sample equivalent of the statuses/sample endpoint in our Standard API. 

Common use cases

  • Trend and event detection
  • Approaches to data processing and pipelines
  • Topics related to scale of data
  • Projects only requiring a sampled dataset

Documentation:

Learn more about Twitter data for academic researchers