---
title: "Get Tweets in a Twitter Thread"
method: GET
path: "/twitter/thread/{thread_id}"
tags: ["Data API"]
---

# Get Tweets in a Twitter Thread

`GET /twitter/thread/{thread_id}`

Returns an array of tweets associated with a thread and a next_cursor value used to 
retrieve more pages (if the thread contains more than 30 posts).

## Path parameters

- `thread_id` string, required

## Query parameters

- `cursor` string

## Response `200`

Request succeeded

- TweetsResponse
  - `next_cursor` string, required — Cursor value used to obtain the subsequent page. To be passed to the same endpoint as 'cursor' query parameter. Value may contain spaces and other special characters and therefore must be url-encoded to avoid any errors
  - `tweets` Tweet[], required
    - `tweet_created_at` string, required — The UTC datetime when the tweet was created
    - `id_str` string, required — The string representation of the unique identifier for this Tweet. Implementations should use this rather than the large integer in id.
    - `text` string, nullable — Deprecated. Always `null`
    - `full_text` string, required — 100 tips I learned growing an iOS app to ~$5M in sales in 3 yrs, going through YC 1.5 times, and co-founding @Superwall 👇
    - `source` string, required — Utility used to post the Tweet, as an HTML-formatted string. Tweets from the Twitter website have a source value of web.
    - `truncated` boolean, required — Indicates whether the value of the text parameter was truncated, for example, as a result of a retweet exceeding the original Tweet text length limit of 140 characters. Since Twitter now rejects long Tweets vs truncating them, the large majority of Tweets will have this set to false.
    - `in_reply_to_status_id_str` string, nullable — If the represented Tweet is a reply, this field will contain the string representation of the original Tweet's ID.
    - `in_reply_to_user_id_str` string, nullable — If the represented Tweet is a reply, this field will contain the string representation of the original Tweet's author ID. This will not necessarily always be the user directly mentioned in the Tweet.
    - `in_reply_to_screen_name` string, nullable — If the represented Tweet is a reply, this field will contain the screen name of the original Tweet's author.
    - `user` User, required — Twitter user account information
      - `id_str` string, required — The string representation of the unique identifier for this User. Implementations should use this rather than the large, possibly un-consumable integer in id.
      - `name` string, required — The name of the user, as they've defined it. Not necessarily a person's name. Typically capped at 50 characters, but subject to change.
      - `screen_name` string, required — The screen name, handle, or alias that this user identifies themselves with. screen_names are unique but subject to change. Use id_str as a user identifier whenever possible. Typically a maximum of 15 characters long, but some historical accounts may exist with longer names.
      - `location` string, required — The user-defined location for this account's profile. Not necessarily a location, nor machine-parseable. This field will occasionally be fuzzily interpreted by the Search service.
      - `url` string, nullable — A URL provided by the user in association with their profile.
      - `description` string, required — The user-defined UTF-8 string describing their account.
      - `protected` boolean, required — When true, indicates that this user has chosen to protect their Tweets.
      - `verified` boolean, required — When true, indicates that the user has a verified account with a blue checkmark.
      - `followers_count` integer, required — The number of followers this account currently has. Under certain conditions of duress, this field will temporarily indicate "0".
      - `friends_count` integer, required — The number of users this account is following (AKA their "followings"). Under certain conditions of duress, this field will temporarily indicate "0".
      - `listed_count` integer, required — The number of public lists that this user is a member of.
      - `favourites_count` integer, required — The number of Tweets this user has liked in the account's lifetime. British spelling used in the field name for historical reasons.
      - `statuses_count` integer, required — The number of Tweets (including retweets) issued by the user.
      - `created_at` string, required — The UTC datetime that the user account was created on Twitter.
      - `profile_banner_url` string, required — The HTTPS-based URL pointing to the standard web representation of the user's uploaded profile banner. By adding a final path element of the URL, it is possible to obtain different image sizes optimized for specific displays.
      - `profile_image_url_https` string, required — A HTTPS-based URL pointing to the user's profile image.
      - `can_dm` boolean, required — Indicates whether the authenticated user can send a direct message to this user.
    - `lang` string, required — Nullable. When present, indicates a BCP 47 language identifier corresponding to the machine-detected language of the Tweet text, or und if no language could be detected.
    - `quoted_status_id_str` string, nullable — This field only surfaces when the Tweet is a quote Tweet. This is the string representation Tweet ID of the quoted Tweet.
    - `is_quote_status` boolean, required — Indicates whether this is a Quoted Tweet.
    - `is_pinned` boolean, required — Indicates if the tweet is pinned to the user's profile.
    - `quote_count` integer, required — Nullable. Indicates approximately how many times this Tweet has been quoted by Twitter users.
    - `reply_count` integer, required — Number of times this Tweet has been replied to.
    - `retweet_count` integer, required — Number of times this Tweet has been retweeted.
    - `favorite_count` integer, required — Nullable. Indicates approximately how many times this Tweet has been liked by Twitter users.
    - `views_count` integer, required — Number of views this tweet has received.
    - `bookmark_count` integer, required — Number of times this tweet has been bookmarked.
    - `quoted_status` Tweet — recursive
    - `retweeted_status` Tweet — recursive
    - `entities` TweetEntities, required — Entities which have been parsed out of the text of the Tweet
      - `urls` UrlEntity[], required
        - `url` string — Wrapped URL, corresponding to the value embedded directly into the raw Tweet text.
        - `expanded_url` string — Expanded version of display_url.
        - `display_url` string — URL pasted/typed into Tweet.
        - `indices` integer[] — An array of integers representing offsets within the Tweet text where the URL begins and ends.
      - `user_mentions` UserMentionEntity[], required
        - `id_str` string — ID of the mentioned user, as a string.
        - `name` string — Display name of the referenced user.
        - `screen_name` string — Screen name of the referenced user.
        - `indices` integer[] — An array of integers representing offsets within the Tweet text where the user mention begins and ends.
      - `hashtags` HashtagEntity[], required
        - `text` string — Name of the hashtag, minus the leading '#' character.
        - `indices` integer[] — An array of integers representing offsets within the Tweet text where the hashtag begins and ends.
      - `symbols` SymbolEntity[], required
        - `text` string — Name of the cashtag, minus the leading '$' character.
        - `indices` integer[] — An array of integers representing offsets within the Tweet text where the symbol begins and ends.
      - `media` MediaEntity[]
        - `id_str` string — ID of the media expressed as a string.
        - `media_url_https` string — HTTPS URL pointing directly to the uploaded media file.
        - `url` string — Wrapped URL for the media link.
        - `display_url` string — URL of the media to display to clients.
        - `expanded_url` string — Expanded version of display_url.
        - `type` 'photo' | 'video' | 'animated_gif' — Type of uploaded media.
        - `indices` integer[] — An array of integers representing offsets within the Tweet text where the media begins and ends.
      - `poll` PollEntity — Represents a poll attached to a Tweet
        - `end_datetime` string, date-time, required — The UTC datetime when the poll will end
        - `duration_minutes` integer, required — The duration of the poll in minutes
        - `counts_are_final` boolean, required — Indicates whether the voting period has ended and the results are final
        - `choices` PollChoice[], required — An array of poll choices
          - `label` string, required — The text of the poll choice
          - `count` integer, required — The number of votes for this choice

## Other responses

- `402` — Payment required - not enough credits to perform this request. You should purchase additional credits
- `422` — Validation failed (e.g. thread_id is not provided or in invalid format)
- `500` — API internal error, typically means that SocialData API failed to obtain the requested information. Retry may succeed

---

[API](https://skmtc.net/socialdata-api/apis/socialdata-api-reference.md) · [All operations](https://skmtc.net/socialdata-api/apis/socialdata-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/socialdata-api/socialdata-api-reference/versions/a898522f71ac/schema)