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

# List Tweets Feed

`GET /list-tweets`

Returns tweets from a specific Twitter/X list. You provide the list ID, and the endpoint returns tweets published by accounts included in that list. Each result contains tweet text, creation date, engagement metrics, and basic author information. If more results are available, you can use next\_cursor to load the next page.

Use cases:

Analytics platforms tracking curated groups of accounts (for example, “top founders” or “crypto analysts” lists); marketing teams monitoring competitor or influencer lists; research tools collecting tweets from thematic lists; community dashboards displaying content from selected user groups; developers building list-based feeds with pagination support.

## Query parameters

- `list_id` string, required
- `cursor` string

## Response `200`

OK

- CommonTweetsResponse
  - `next_cursor` string
  - `tweets` CommonTweet[]
    - `bookmark_count` integer
    - `conversation_id_str` string
    - `created_at` string
    - `entities` CommonTweetEntity[]
      - `link` string
      - `preview` string
      - `type` string
    - `full_text` string
    - `id` string
    - `in_reply_to_tweet_id` string
    - `in_reply_to_username` string
    - `is_quote_status` boolean
    - `is_replies_limited` boolean
    - `is_reply` boolean
    - `lang` string
    - `likes_count` integer
    - `quote_count` integer
    - `quoted_status` CommonTweet — recursive
    - `reply_count` integer
    - `retweet_count` integer
    - `retweeted_status` CommonTweet — recursive
    - `user` CommonUser
      - `bio_urls` string[]
      - `can_dm` boolean
      - `created_at` string
      - `description` string
      - `display_name` string
      - `favourites_count` integer
      - `followers_count` integer
      - `followings_count` integer
      - `id` string
      - `location` string
      - `media_count` integer
      - `pinned_tweet_ids` string[]
      - `possibly_sensitive` boolean
      - `profile_background_image_url` string
      - `profile_image_url` string
      - `protected` boolean
      - `tweets_count` integer
      - `username` string
      - `verified` boolean
    - `view_count` integer

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

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