---
title: "List Tweets"
method: GET
path: "/list-tweets"
tags: ["Lists"]
---

# List Tweets

`GET /list-tweets`

Returns a paginated feed of tweets published by members of the specified Twitter/X List. Up to 20 tweets per page. Each tweet includes text, creation date, engagement metrics, and basic author information.

## Query parameters

- `list_id` string, required
- `next_cursor` string

## Response `200`

OK

- CommonTweetsResponse
  - `next_cursor` string — Cursor for fetching the next page of results. Null or absent if no more pages.
  - `tweets` CommonTweet[] — Array of tweet objects.
    - `bookmark_count` integer — Number of times the tweet has been bookmarked.
    - `conversation_id_str` string — ID of the root tweet in the conversation thread.
    - `created_at` string — Tweet publication date in ISO 8601 format.
    - `entities` CommonTweetEntity[] — Media, links, and other embedded entities attached to the tweet.
      - `link` string — Direct URL of the entity.
      - `preview` string — Preview or thumbnail URL for the entity.
      - `type` string — Entity type (e.g. `photo`, `video`, `url`).
    - `full_text` string — Full text content of the tweet.
    - `id` string — Unique tweet ID.
    - `in_reply_to_tweet_id` string — ID of the tweet this tweet is replying to. Null if not a reply.
    - `in_reply_to_username` string — Username of the account this tweet is replying to.
    - `is_quote_status` boolean — Whether this tweet quotes another tweet.
    - `is_replies_limited` boolean — Whether replies to this tweet are restricted by the author.
    - `is_reply` boolean — Whether this tweet is a reply to another tweet.
    - `lang` string — Detected language code of the tweet (e.g. `en`, `es`).
    - `likes_count` integer — Number of likes on the tweet.
    - `made_with_ai` boolean — Whether the tweet was made with AI.
    - `paid_partnership` boolean — Whether the tweet is a paid partnership.
    - `quote_count` integer — Number of quote tweets.
    - `quoted_status` CommonTweet — recursive
    - `reply_count` integer — Number of replies to the tweet.
    - `retweet_count` integer — Number of retweets.
    - `retweeted_status` CommonTweet — recursive
    - `user` CommonUser
      - `bio_urls` string[] — URLs found in the user's bio.
      - `can_dm` boolean — Whether the account accepts direct messages.
      - `created_at` string — Account creation date in ISO 8601 format.
      - `description` string — Profile bio text.
      - `display_name` string — User's display name.
      - `favourites_count` integer — Total number of tweets this user has liked.
      - `followers_count` integer — Number of accounts following this user.
      - `followings_count` integer — Number of accounts this user follows.
      - `id` string — Unique Twitter/X user ID.
      - `location` string — Location string from the user's profile.
      - `media_count` integer — Total number of media items posted by this user.
      - `pinned_tweet_ids` string[] — IDs of the user's pinned tweets.
      - `possibly_sensitive` boolean — Whether the account is flagged as possibly containing sensitive content.
      - `profile_background_image_url` string — URL of the user's profile background image.
      - `profile_image_url` string — URL of the user's avatar image.
      - `protected` boolean — Whether the account's tweets are protected (private).
      - `tweets_count` integer — Total number of tweets posted by this user.
      - `username` string — Current Twitter/X handle (without @).
      - `verified` boolean — Whether the account has a verified badge.
    - `view_count` integer — Number of views (impressions).

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error

---

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