Filtered stream

GET /2/tweets/search/stream

Bearer token

Streams Tweets matching the stream's active rule set.

Query parameters

expansions array[string]

A comma separated list of fields to expand.
tweet.fields array[string]

A comma separated list of Tweet fields to display.
user.fields array[string]

A comma separated list of User fields to display.
media.fields array[string]

A comma separated list of Media fields to display.
place.fields array[string]

A comma separated list of Place fields to display.
poll.fields array[string]

A comma separated list of Poll fields to display.
backfill_minutes integer(int32)

The number of minutes of backfill requested

Minimum value is 0, maximum value is 5.

Responses

200

The request was successful. Successful responses will return a stream of individual JSON Tweet payloads.
One of:
object-1 object object-2 object
The values returned with a successful streamed tweet. Includes the user provided rules that the tweet matched.

Hide attributes Show attributes

data object Required

Hide data attributes Show data attributes object

id string Required

Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

created_at string(date-time)

Creation time of the Tweet.

text string Required

The content of the Tweet.

author_id string

Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

in_reply_to_user_id string

Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

conversation_id string

Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

reply_settings string

Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following.

Format should match the following pattern: ^[A-Za-z]{1,12}$. Values are everyone, mentionedUsers, following, or other.

attachments object

Specifies the type of attachments (if any) present in this Tweet.

Hide attachments attributes Show attachments attributes object

media_keys array[string]

The Media Key identifier for this attachment.

At least 1 element. Format of each should match the following pattern: ^([0-9]+)_([0-9]+)$.

poll_ids array[string]

Unique identifier of this poll.

At least 1 element. Format of each should match the following pattern: ^[0-9]{1,19}$.

referenced_tweets array[object]

A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.

At least 1 element.

Hide referenced_tweets attributes Show referenced_tweets attributes array[object]

type string Required

Values are retweeted, quoted, or replied_to.

id string Required

Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

context_annotations array[object]

Annotation inferred from the tweet text.

At least 1 element.

Hide context_annotations attributes Show context_annotations attributes array[object]

domain object Required

Represents the data for the context annotation domain.

Hide domain attributes Show domain attributes object

id string Required

The unique id for a context annotation domain.

Format should match the following pattern: ^[0-9]{1,19}$.

name string

Name of the context annotation domain.

description string

Description of the context annotation domain.

entity object Required

Represents the data for the context annotation entity.

Hide entity attributes Show entity attributes object

id string Required

The unique id for a context annotation entity.

Format should match the following pattern: ^[0-9]{1,19}$.

name string

Name of the context annotation entity.

description string

Description of the context annotation entity.

withheld object

Indicates withholding details for withheld content.

Hide withheld attributes Show withheld attributes object

copyright boolean Required

Indicates if the content is being withheld for on the basis of copyright infringement.

country_codes array[string] Required

A two-letter ISO 3166-1 alpha-2 country code

At least 1 element. Format of each should match the following pattern: ^[A-Z]{2}$.

scope string

Indicates whether the content being withheld is the tweet or a user.

Values are tweet or user.

geo object

The location tagged on the Tweet, if the user provided one.

Hide geo attributes Show geo attributes object

coordinates object

A GeoJson Point geometry object.

Hide coordinates attributes Show coordinates attributes object

type string Required

Value is Point.

coordinates array[number] Required

A GeoJson Position in the format [longitude,latitude].

At least 2 but not more than 2 elements.

place_id string

The identifier for this place

entities object

Hide entities attributes Show entities attributes object

urls array[object]

Represent the portion of text recognized as a URL.

At least 1 element.

Hide urls attributes Show urls attributes array[object]

start integer Required

Index (zero-based) at which position this entity starts. The index is inclusive.

Minimum value is 0.

end integer Required

Index (zero-based) at which position this entity ends. The index is exclusive.

Minimum value is 0.

url string(uri) Required

A validly formatted URL.

expanded_url string(uri)

A validly formatted URL.

display_url string

The URL as displayed in the Twitter client.

unwound_url string(uri)

Fully resolved url

status integer

HTTP Status Code.

Minimum value is 100, maximum value is 599.

title string

Title of the page the URL points to.

description string

Description of the URL landing page.

images array[object]

Represent the information for the URL image

At least 1 element.

Hide images attributes Show images attributes array[object]

url string(uri)

A validly formatted URL.

height integer

The height of the media in pixels

Minimum value is 0.

width integer

The width of the media in pixels

Minimum value is 0.

hashtags array[object]

Represent the portion of text recognized as a Hashtag, and its start and end position within the text.

At least 1 element.

Hide hashtags attributes Show hashtags attributes array[object]

start integer Required

Index (zero-based) at which position this entity starts. The index is inclusive.

Minimum value is 0.

end integer Required

Index (zero-based) at which position this entity ends. The index is exclusive.

Minimum value is 0.

tag string Required

The text of the Hashtag

mentions array[object]

Represent the portion of text recognized as a User mention, and its start and end position within the text.

At least 1 element.

Hide mentions attributes Show mentions attributes array[object]

start integer Required

Index (zero-based) at which position this entity starts. The index is inclusive.

Minimum value is 0.

end integer Required

Index (zero-based) at which position this entity ends. The index is exclusive.

Minimum value is 0.

username string Required

The Twitter handle (screen name) of this user.

Format should match the following pattern: ^[A-Za-z0-9_]{1,15}$.

id string Required

Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

cashtags array[object]

Represent the portion of text recognized as a Cashtag, and its start and end position within the text.

At least 1 element.

Hide cashtags attributes Show cashtags attributes array[object]

start integer Required

Index (zero-based) at which position this entity starts. The index is inclusive.

Minimum value is 0.

end integer Required

Index (zero-based) at which position this entity ends. The index is exclusive.

Minimum value is 0.

tag string Required

public_metrics object

Engagement metrics for the Tweet at the time of the request.

Hide public_metrics attributes Show public_metrics attributes object

retweet_count integer Required

Number of times this Tweet has been Retweeted.

reply_count integer Required

Number of times this Tweet has been replied to.

like_count integer Required

Number of times this Tweet has been liked.

quote_count integer

Number of times this Tweet has been quoted.

possibly_sensitive boolean

Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.

lang string

Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.

source string

The name of the app the user Tweeted from.

non_public_metrics object

Nonpublic engagement metrics for the Tweet at the time of the request.

Hide non_public_metrics attribute Show non_public_metrics attribute object

impression_count integer(int32)

Number of times this Tweet has been viewed.

promoted_metrics object

Promoted nonpublic engagement metrics for the Tweet at the time of the request.

Hide promoted_metrics attributes Show promoted_metrics attributes object

impression_count integer(int32)

Number of times this Tweet has been viewed.

like_count integer(int32)

Number of times this Tweet has been liked.

reply_count integer(int32)

Number of times this Tweet has been replied to.

retweet_count integer(int32)

Number of times this Tweet has been Retweeted.

organic_metrics object

Organic nonpublic engagement metrics for the Tweet at the time of the request.

Hide organic_metrics attributes Show organic_metrics attributes object

impression_count integer Required

Number of times this Tweet has been viewed.

retweet_count integer Required

Number of times this Tweet has been Retweeted.

reply_count integer Required

Number of times this Tweet has been replied to.

like_count integer Required

Number of times this Tweet has been liked.

matching_rules array[object] Required

The list of rules which matched the tweet

Hide matching_rules attributes Show matching_rules attributes array[object]

id string Required

Unique identifier of this rule.

Format should match the following pattern: ^[0-9]{1,19}$.

tag string

The user-supplied tag assigned to the rule which matched

includes object

Hide includes attributes Show includes attributes object

users array[object]

The Twitter User object

At least 1 element.

Hide users attributes Show users attributes array[object]

id string Required

Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

created_at string(date-time)

Creation time of this user.

name string Required

The friendly name of this user, as shown on their profile.

username string Required

The Twitter handle (screen name) of this user.

Format should match the following pattern: ^[A-Za-z0-9_]{1,15}$.

protected boolean

Indicates if this user has chosen to protect their Tweets (in other words, if this user's Tweets are private).

verified boolean

Indicate if this user is a verified Twitter User.

withheld object

Indicates withholding details for withheld content.

Hide withheld attributes Show withheld attributes object

country_codes array[string] Required

A two-letter ISO 3166-1 alpha-2 country code

At least 1 element. Format of each should match the following pattern: ^[A-Z]{2}$.

scope string

Indicates that the content being withheld is a user.

Value is user.

profile_image_url string(uri)

The URL to the profile image for this user.

location string

The location specified in the user's profile, if the user provided one. As this is a freeform value, it may not indicate a valid location, but it may be fuzzily evaluated when performing searches with location queries.

url string

The URL specified in the user's profile.

description string

The text of this user's profile description (also known as bio), if the user provided one.

entities object

A list of metadata found in the user's profile description.

Hide entities attributes Show entities attributes object

url object

Expanded details for the URL specified in the user's profile, with start and end indices.

Hide url attribute Show url attribute object

urls array[object]

Represent the portion of text recognized as a URL.

At least 1 element.

Hide urls attributes Show urls attributes array[object]

start integer Required

Index (zero-based) at which position this entity starts. The index is inclusive.

Minimum value is 0.

end integer Required

Index (zero-based) at which position this entity ends. The index is exclusive.

Minimum value is 0.

url string(uri) Required

A validly formatted URL.

expanded_url string(uri)

A validly formatted URL.

display_url string

The URL as displayed in the Twitter client.

unwound_url string(uri)

Fully resolved url

status integer

HTTP Status Code.

Minimum value is 100, maximum value is 599.

title string

Title of the page the URL points to.

description string

Description of the URL landing page.

images array[object]

Represent the information for the URL image

At least 1 element.

Hide images attributes Show images attributes array[object]

url string(uri)

A validly formatted URL.

height integer

The height of the media in pixels

Minimum value is 0.

width integer

The width of the media in pixels

Minimum value is 0.

description object

Hide description attributes Show description attributes object

urls array[object]

Represent the portion of text recognized as a URL.

At least 1 element.

Hide urls attributes Show urls attributes array[object]

start integer Required

Index (zero-based) at which position this entity starts. The index is inclusive.

Minimum value is 0.

end integer Required

Index (zero-based) at which position this entity ends. The index is exclusive.

Minimum value is 0.

url string(uri) Required

A validly formatted URL.

expanded_url string(uri)

A validly formatted URL.

display_url string

The URL as displayed in the Twitter client.

unwound_url string(uri)

Fully resolved url

status integer

HTTP Status Code.

Minimum value is 100, maximum value is 599.

title string

Title of the page the URL points to.

description string

Description of the URL landing page.

images array[object]

Represent the information for the URL image

At least 1 element.

Hide images attributes Show images attributes array[object]

url string(uri)

A validly formatted URL.

height integer

The height of the media in pixels

Minimum value is 0.

width integer

The width of the media in pixels

Minimum value is 0.

hashtags array[object]

Represent the portion of text recognized as a Hashtag, and its start and end position within the text.

At least 1 element.

Hide hashtags attributes Show hashtags attributes array[object]

start integer Required

Index (zero-based) at which position this entity starts. The index is inclusive.

Minimum value is 0.

end integer Required

Index (zero-based) at which position this entity ends. The index is exclusive.

Minimum value is 0.

tag string Required

The text of the Hashtag

mentions array[object]

Represent the portion of text recognized as a User mention, and its start and end position within the text.

At least 1 element.

Hide mentions attributes Show mentions attributes array[object]

start integer Required

Index (zero-based) at which position this entity starts. The index is inclusive.

Minimum value is 0.

end integer Required

Index (zero-based) at which position this entity ends. The index is exclusive.

Minimum value is 0.

username string Required

The Twitter handle (screen name) of this user.

Format should match the following pattern: ^[A-Za-z0-9_]{1,15}$.

id string Required

Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

cashtags array[object]

Represent the portion of text recognized as a Cashtag, and its start and end position within the text.

At least 1 element.

Hide cashtags attributes Show cashtags attributes array[object]

start integer Required

Index (zero-based) at which position this entity starts. The index is inclusive.

Minimum value is 0.

end integer Required

Index (zero-based) at which position this entity ends. The index is exclusive.

Minimum value is 0.

tag string Required

pinned_tweet_id string

Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

public_metrics object

A list of metrics for this user

Hide public_metrics attributes Show public_metrics attributes object

tweet_count integer Required

The number of Tweets (including Retweets) posted by this user.

followers_count integer Required

Number of users who are following this user.

following_count integer Required

Number of users this user is following.

listed_count integer Required

The number of lists that include this user.

tweets array[object]

At least 1 element.

Hide tweets attributes Show tweets attributes array[object]

id string Required

Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

created_at string(date-time)

Creation time of the Tweet.

text string Required

The content of the Tweet.

author_id string

Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

in_reply_to_user_id string

Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

conversation_id string

Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

reply_settings string

Shows who can reply a Tweet. Fields returned are everyone, mentioned_users, and following.

Format should match the following pattern: ^[A-Za-z]{1,12}$. Values are everyone, mentionedUsers, following, or other.

referenced_tweets array[object]

A list of Tweets this Tweet refers to. For example, if the parent Tweet is a Retweet, a Quoted Tweet or a Reply, it will include the related Tweet referenced to by its parent.

At least 1 element.

Hide referenced_tweets attributes Show referenced_tweets attributes array[object]

type string Required

Values are retweeted, quoted, or replied_to.

id string Required

Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

attachments object

Specifies the type of attachments (if any) present in this Tweet.

Hide attachments attributes Show attachments attributes object

media_keys array[string]

The Media Key identifier for this attachment.

At least 1 element. Format of each should match the following pattern: ^([0-9]+)_([0-9]+)$.

poll_ids array[string]

Unique identifier of this poll.

At least 1 element. Format of each should match the following pattern: ^[0-9]{1,19}$.

context_annotations array[object]

Annotation inferred from the tweet text.

At least 1 element.

Hide context_annotations attributes Show context_annotations attributes array[object]

domain object Required

Represents the data for the context annotation domain.

Hide domain attributes Show domain attributes object

id string Required

The unique id for a context annotation domain.

Format should match the following pattern: ^[0-9]{1,19}$.

name string

Name of the context annotation domain.

description string

Description of the context annotation domain.

entity object Required

Represents the data for the context annotation entity.

Hide entity attributes Show entity attributes object

id string Required

The unique id for a context annotation entity.

Format should match the following pattern: ^[0-9]{1,19}$.

name string

Name of the context annotation entity.

description string

Description of the context annotation entity.

withheld object

Indicates withholding details for withheld content.

Hide withheld attributes Show withheld attributes object

copyright boolean Required

Indicates if the content is being withheld for on the basis of copyright infringement.

country_codes array[string] Required

A two-letter ISO 3166-1 alpha-2 country code

At least 1 element. Format of each should match the following pattern: ^[A-Z]{2}$.

scope string

Indicates whether the content being withheld is the tweet or a user.

Values are tweet or user.

geo object

The location tagged on the Tweet, if the user provided one.

Hide geo attributes Show geo attributes object

coordinates object

A GeoJson Point geometry object.

Hide coordinates attributes Show coordinates attributes object

type string Required

Value is Point.

coordinates array[number] Required

A GeoJson Position in the format [longitude,latitude].

At least 2 but not more than 2 elements.

place_id string

The identifier for this place

entities object

Hide entities attributes Show entities attributes object

urls array[object]

Represent the portion of text recognized as a URL.

At least 1 element.

Hide urls attributes Show urls attributes array[object]

start integer Required

Index (zero-based) at which position this entity starts. The index is inclusive.

Minimum value is 0.

end integer Required

Index (zero-based) at which position this entity ends. The index is exclusive.

Minimum value is 0.

url string(uri) Required

A validly formatted URL.

expanded_url string(uri)

A validly formatted URL.

display_url string

The URL as displayed in the Twitter client.

unwound_url string(uri)

Fully resolved url

status integer

HTTP Status Code.

Minimum value is 100, maximum value is 599.

title string

Title of the page the URL points to.

description string

Description of the URL landing page.

images array[object]

Represent the information for the URL image

At least 1 element.

Hide images attributes Show images attributes array[object]

url string(uri)

A validly formatted URL.

height integer

The height of the media in pixels

Minimum value is 0.

width integer

The width of the media in pixels

Minimum value is 0.

hashtags array[object]

Represent the portion of text recognized as a Hashtag, and its start and end position within the text.

At least 1 element.

Hide hashtags attributes Show hashtags attributes array[object]

start integer Required

Index (zero-based) at which position this entity starts. The index is inclusive.

Minimum value is 0.

end integer Required

Index (zero-based) at which position this entity ends. The index is exclusive.

Minimum value is 0.

tag string Required

The text of the Hashtag

mentions array[object]

Represent the portion of text recognized as a User mention, and its start and end position within the text.

At least 1 element.

Hide mentions attributes Show mentions attributes array[object]

start integer Required

Index (zero-based) at which position this entity starts. The index is inclusive.

Minimum value is 0.

end integer Required

Index (zero-based) at which position this entity ends. The index is exclusive.

Minimum value is 0.

username string Required

The Twitter handle (screen name) of this user.

Format should match the following pattern: ^[A-Za-z0-9_]{1,15}$.

id string Required

Unique identifier of this User. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.

Format should match the following pattern: ^[0-9]{1,19}$.

cashtags array[object]

Represent the portion of text recognized as a Cashtag, and its start and end position within the text.

At least 1 element.

Hide cashtags attributes Show cashtags attributes array[object]

start integer Required

Index (zero-based) at which position this entity starts. The index is inclusive.

Minimum value is 0.

end integer Required

Index (zero-based) at which position this entity ends. The index is exclusive.

Minimum value is 0.

tag string Required

public_metrics object

Engagement metrics for the Tweet at the time of the request.

Hide public_metrics attributes Show public_metrics attributes object

retweet_count integer Required

Number of times this Tweet has been Retweeted.

reply_count integer Required

Number of times this Tweet has been replied to.

like_count integer Required

Number of times this Tweet has been liked.

quote_count integer

Number of times this Tweet has been quoted.

possibly_sensitive boolean

Indicates if this Tweet contains URLs marked as sensitive, for example content suitable for mature audiences.

lang string

Language of the Tweet, if detected by Twitter. Returned as a BCP47 language tag.

source string

The name of the app the user Tweeted from.

non_public_metrics object

Nonpublic engagement metrics for the Tweet at the time of the request.

Hide non_public_metrics attribute Show non_public_metrics attribute object

impression_count integer(int32)

Number of times this Tweet has been viewed.

promoted_metrics object

Promoted nonpublic engagement metrics for the Tweet at the time of the request.

Hide promoted_metrics attributes Show promoted_metrics attributes object

impression_count integer(int32)

Number of times this Tweet has been viewed.

like_count integer(int32)

Number of times this Tweet has been liked.

reply_count integer(int32)

Number of times this Tweet has been replied to.

retweet_count integer(int32)

Number of times this Tweet has been Retweeted.

organic_metrics object

Organic nonpublic engagement metrics for the Tweet at the time of the request.

Hide organic_metrics attributes Show organic_metrics attributes object

impression_count integer Required

Number of times this Tweet has been viewed.

retweet_count integer Required

Number of times this Tweet has been Retweeted.

reply_count integer Required

Number of times this Tweet has been replied to.

like_count integer Required

Number of times this Tweet has been liked.

places array[object]

At least 1 element.

Hide places attributes Show places attributes array[object]

id string Required

The identifier for this place

name string

The human readable name of this place.

country_code string

A two-letter ISO 3166-1 alpha-2 country code

Format should match the following pattern: ^[A-Z]{2}$.

place_type string

Values are poi, neighborhood, city, admin, country, or unknown.

full_name string Required

The full name of this place.

country string

The full name of the county in which this place exists.

contained_within array[string]

The identifier for this place

At least 1 element.

geo object

Hide geo attributes Show geo attributes object

type string Required

Value is Feature.

bbox array[number(double)] Required

At least 4 but not more than 4 elements. Minimum value of each is -180, maximum value of each is 180.

geometry object

A GeoJson Point geometry object.

Hide geometry attributes Show geometry attributes object

type string Required

Value is Point.

coordinates array[number] Required

A GeoJson Position in the format [longitude,latitude].

At least 2 but not more than 2 elements.

properties object Required

media array[object]

At least 1 element.

Hide media attributes Show media attributes array[object]

type string Required

media_key string

The Media Key identifier for this attachment.

Format should match the following pattern: ^([0-9]+)_([0-9]+)$.

height integer

The height of the media in pixels

Minimum value is 0.

width integer

The width of the media in pixels

Minimum value is 0.

polls array[object]

Represent a Poll attached to a Tweet

At least 1 element.

Hide polls attributes Show polls attributes array[object]

id string Required

Unique identifier of this poll.

Format should match the following pattern: ^[0-9]{1,19}$.

options array[object] Required

Describes a choice in a Poll object.

At least 2 but not more than 4 elements.

Hide options attributes Show options attributes array[object]

position integer Required

Position of this choice in the poll.

label string Required

The text of a poll choice.

Minimum length is 1, maximum length is 25.

votes integer Required

Number of users who voted for this choice.

voting_status string

Values are open or closed.

end_datetime string(date-time)

duration_minutes integer
A tweet or error that can be returned by the streaming tweet API

Hide attribute Show attribute

errors array[object] Required

An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).

Hide errors attributes Show errors attributes array[object]

type string Required

title string Required

detail string

status integer
default

The request has failed.
Hide response attributes Show response attributes object
- code integer(int32) Required
- message string Required

GET /2/tweets/search/stream

curl \
 -X GET https://api.twitter.com/2/tweets/search/stream \
 -H "Authorization: Bearer $ACCESS_TOKEN"

Response examples (200)

{
  "data": {
    "id": "1346889436626259968",
    "created_at": "Wed Jan 06 18:40:40 +0000 2021",
    "text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i",
    "author_id": "2244994945"
  },
  "matching_rules": [
    {
      "id": "120897978112909812",
      "tag": "string"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "created_at": "2013-12-14T04:35:55Z",
        "name": "Twitter Dev",
        "username": "TwitterDev",
        "protected": false
      }
    ],
    "tweets": [
      {
        "id": "1346889436626259968",
        "created_at": "Wed Jan 06 18:40:40 +0000 2021",
        "text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i",
        "author_id": "2244994945"
      }
    ],
    "places": [
      {
        "id": "f7eb2fa2fea288b1",
        "name": "Lakewood",
        "country_code": "US",
        "place_type": "city",
        "full_name": "Lakewood, CO",
        "country": "United States",
        "contained_within": [
          "f7eb2fa2fea288b1"
        ],
        "geo": {
          "type": "Feature",
          "bbox": [
            -105.193475,
            39.60973,
            -105.053164,
            39.761974
          ],
          "geometry": {
            "type": "Point",
            "coordinates": [
              "-105.18816086351444",
              "40.247749999999996"
            ]
          },
          "properties": {}
        }
      }
    ],
    "media": [
      {
        "type": "string",
        "media_key": "string",
        "height": 42,
        "width": 42
      }
    ],
    "polls": [
      {
        "id": "1365059861688410112",
        "options": [
          {
            "position": 42,
            "label": "string",
            "votes": 42
          }
        ],
        "voting_status": "open",
        "end_datetime": "2023-05-04T09:42:00+00:00",
        "duration_minutes": 42
      }
    ]
  }
}

{
  "errors": [
    {
      "type": "string",
      "title": "string",
      "detail": "string",
      "status": 42
    }
  ]
}

Response examples (200)

{
  "data": {
    "id": "1346889436626259968",
    "text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i",
    "author_id": "2244994945",
    "created_at": "Wed Jan 06 18:40:40 +0000 2021"
  },
  "matching_rules": [
    {
      "id": "120897978112909812",
      "tag": "string"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "name": "Twitter Dev",
        "username": "TwitterDev",
        "protected": false,
        "created_at": "2013-12-14T04:35:55Z"
      }
    ],
    "tweets": [
      {
        "id": "1346889436626259968",
        "text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i",
        "author_id": "2244994945",
        "created_at": "Wed Jan 06 18:40:40 +0000 2021"
      }
    ],
    "places": [
      {
        "id": "f7eb2fa2fea288b1",
        "name": "Lakewood",
        "country_code": "US",
        "place_type": "city",
        "full_name": "Lakewood, CO",
        "country": "United States",
        "contained_within": [
          "f7eb2fa2fea288b1"
        ],
        "geo": {
          "type": "Feature",
          "bbox": [
            -105.193475,
            39.60973,
            -105.053164,
            39.761974
          ],
          "geometry": {
            "type": "Point",
            "coordinates": [
              "-105.18816086351444",
              "40.247749999999996"
            ]
          },
          "properties": {}
        }
      }
    ],
    "media": [
      {
        "type": "string",
        "media_key": "string",
        "height": 42,
        "width": 42
      }
    ],
    "polls": [
      {
        "id": "1365059861688410112",
        "options": [
          {
            "position": 42,
            "label": "string",
            "votes": 42
          }
        ],
        "voting_status": "open",
        "end_datetime": "2025-05-04T09:42:00Z",
        "duration_minutes": 42
      }
    ]
  }
}

{
  "errors": [
    {
      "type": "string",
      "title": "string",
      "detail": "string",
      "status": 42
    }
  ]
}

Response examples (default)

{
  "code": 42,
  "message": "string"
}

Response examples (default)

{
  "code": 42,
  "message": "string"
}