Academic research

Product track details

See Academic Research product track details like which v2 endpoints are included, or see what's available with the v1.1 enterprise APIs.

  • Academic Research
  • Enterprise APIs

Academic Research product track

Full-archive search

Search the complete history of public Tweets based on your filters

Details

This endpoint lets you search the full history of public Tweets, and delivers complete data based on your filters in a request-response model with pagination. It also supports a more advanced query language (boolean) to help yield more precise filtered results. This endpoint is ideal for understanding longitudinal trends and analyzing historical topics or events of interest.


Common use cases

  • Historical topic or event analysis
  • Longitudinal studies


Enhancements on the Academic Research product track

  • Available for free as a core component of the Academic Research product track
  • Additional advanced operators (e.g. geo, bio filtering)
  • Increased character limit on query rules to 1024 characterse


Compared to Historical PowerTrack API and Full-Archive Search on Premium v1.1 API

  • Access the same full history of public Twitter data
  • New query operators that support conversation_ids and Tweet annotations
  • New expansion parameter allows you to pull user, media, place, and poll metadata, with the ability to specify the fields you receive in your response
  • Supports pagination tokens to help you obtain all of the results for your request if they are too large to fit in a single response


Documentation

Recent search

Search the last 7 days of public Tweets based on your filters

Details

This endpoint lets you search the last 7 days of public Tweets, and delivers complete data based on your filters in a request-response model with pagination, and supports sorting by time. This endpoint is suited for analyzing recent, specific topics or events of interest.


Common use cases

  • Topic discovery
  • Data exploration
  • Retrieve example Tweets


Enhancements on the Academic Research product track

  • Returns complete, full-fidelity results, removing some of the biases introduced by the v1.1 version’s relevance and quality-focused sampling to serve consumer use cases
  • Additional, advanced operators (e.g. geo, bio filtering)
  • Increased character limit on search query rules (1024 characters)


Compared to v1.1 search/Tweets endpoint

  • New query operators that support conversation_ids and Tweet annotations
  • New expansion parameter allows you to pull user, media, place, and poll metadata, with the ability to specify the fields you receive in your response
  • Returns complete, full-fidelity results, removing some of the biases introduced by the v1.1 version’s relevance and quality-focused sampling to serve consumer use cases
  • Supports pagination tokens to help you obtain all of the results for your request if they are too large to fit in a single response


Documentation

Filtered stream

Stream public Tweets in real-time based on your filters

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%. \


Common use cases

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


Enhancements on the Academic Research product track

  • Additional advanced operators (e.g. geo, bio filtering)
  • Increased character limit on query rules to 1024 characters
  • Increased rule cap supports up to 1,000 concurrent rules


Compared to v1.1 statuses/filter endpoint 


Documentation

Sampled stream

Sample ~1% of all new Tweets in real-time

Details

All connections to this endpoint will deliver a randomized 1% sample of new, public Tweets. Since this endpoint captures a sample of all conversations happening on Twitter, it is well suited for analyses that 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. All connections deliver the same deterministic random sample.


Common use cases

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


Compared to v1.1 statuses/sample endpoint    

  • New expansion parameter allows you to pull user, media, place, and poll metadata, with the ability to specify the fields you receive in your response


Documentation

Tweet lookup

Look up Tweets by ID

Details

This endpoint provides up-to-date details on a Tweet, to hydrate an ID from another source, to verify that a Tweet is available, or to update your stored details following a compliance event.


Common use cases

  • Research replication and validation
  • Hydrate Tweet objects from other datasets


Compared to v1.1 statuses/lookup endpoint

  • New expansion parameter allows you to pull user, media, place, and poll metadata, with the ability to specify the fields you receive in your response


Documentation

User lookup

Look up users by name or ID

Details

This endpoint provides up-to-date details on a user, to hydrate an ID from another source, to verify that a user exists, or to update your stored details following a compliance event.Common use cases.


Common use cases

  • Research replication and validation
  • Hydrate user objects from other datasets


Documentation

Follows lookup endpoints

See the relationships between people on the platform

Details

Follow endpoints refer to a group of endpoints that enable you to retrieve an account’s followers and who they follow. Follows lookup is commonly used in research to understand relationship networks on Twitter. While less relevant for research uses, these endpoints also let people manage their follow relationships through a developer app.


Common use cases

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


Compared to v1.1 follow graph endpoints

  • New expansion parameter allows you to pull user, media, place, and poll metadata, with the ability to specify the fields you receive in your response
  • Supports pagination tokens to help you obtain all of the results for your request if they are too large to fit in a single response


Documentation

User Tweet timeline &
User mention timeline

Look up Tweets written by or mentioning a specific userhandle

Details

These endpoints request Tweets composed by, or any Tweets that mention, a specific entity on Twitter. They deliver complete data based on your specified @user. This can assist with analysis of a public figure or organization, or peoples’ interactions with that person or organization. Note that individual surveillance with this data is a restricted use case, and this is strictly enforced.


Common use cases

  • Understand sentiment, topics, and media shared by a prominent public figure or organization
  • Understand peoples’ overall sentiment, topics, and how they engage when they mention a prominent public figure or organization
  • In conjunction with other endpoints, understand the connection of networks and information across people on Twitter


Compared to v1.1 statuses/user_timeline and /mentions_timeline endpoints

  • New query operators that support conversation_ids and Tweet annotations
  • New expansion parameter allows you to pull user, media, place, and poll metadata, with the ability to specify the fields you receive in your response
  • Supports pagination tokens to help you obtain all of the results for your request if they are too large to fit in a single response
  • Supports start_time and end_time parameters in your requests to bound results to a specified time period


Documentation

Hide replies

Allows people hide replies to a Tweet

Details

This endpoint lets user-authorized apps hide replies to their Tweets. Twitter’s research showed that this feature helped people limit the impact of abusive, distracting, or misleading replies to their posts. This can be helpful for applied research projects that support a healthier experience on Twitter.


Common use cases

  • Building an app with features to help people feel more safe and comfortable having conversations on Twitter
  • Used in combination with search endpoints to assess the impact of hiding replies in a conversation


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

Ready to get started?

Apply for access to the Academic Research product track on the Twitter API, or check out tools tailored for researchers, including documentation, guides, and code samples.