v1

latestOpenAPI 3.1.02026-07-26180242448.0 KB

Lists

Get list tweets

Get tweets from a specific Twitter list. Returns comprehensive tweet data from the list's timeline including all metadata, media attachments, and engagement metrics. Supports pagination for lists with many tweets.

get/v1/twitter/lists/{list_id}/tweets

Path parameters

list_idstring required

Example:1580582120482430976

The unique numeric ID of the list.

Query parameters

cursorstring

Pagination cursor for fetching the next page of results.

Response

Successfully retrieved list tweets.

next_cursorstring nullable

Cursor for fetching the next page. Null if no more results.

Example response

{
  "data": [
    {
      "id": "1234567890123456789",
      "text": "Hello, world! This is a tweet.",
      "created_at": "Wed Oct 10 20:19:24 +0000 2018",
      "lang": "en",
      "user_id": "44196397",
      "username": "elonmusk",
      "user_name": "Elon Musk",
      "hashtags": [
        {
          "text": "AI"
        }
      ],
      "place": {
        "full_name": "San Francisco, CA",
        "name": "San Francisco",
        "country": "United States",
        "country_code": "US"
      },
      "source": "Twitter Web App"
    }
  ]
}