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