List Endpoints

Fetch tweets, members, and subscribers of X lists. Lists are curated collections of accounts maintained by users on X.

GET/v2/lists/:listId/tweetsFetch recent tweets from an X list timeline.

Parameter	Type	Required	Default	Description
listId	string	required	—	The numeric list ID
count	integer	optional	20	Number of tweets to return
sort	string	optional	latest	Sort: latest, popular, engagement
cursor	string	optional	—	Pagination cursor

BASH

curl https://xcrop.io/api/v2/lists/1580587975121616897/tweets?count=20 \
  -H "Authorization: Bearer $XCROP_API_KEY"

ResponseJSON

{
  "data": [
    {
      "id": "2029850112345678901",
      "text": "New DeFi protocol just launched on Arbitrum...",
      "author": {
        "id": "55123",
        "username": "defi_researcher",
        "name": "DeFi Researcher"
      },
      "metrics": {
        "likes": 842, "retweets": 201,
        "replies": 64, "views": 320000, "bookmarks": 95
      },
      "is_reply": false, "is_quote": false, "is_retweet": false,
      "created_at": "Thu Mar 05 14:30:00 +0000 2026"
    }
  ],
  "meta": {
    "total": 20,
    "has_next_page": true,
    "next_cursor": "DAABCgABHCvSgFq___4...",
    "listId": "1580587975121616897",
    "latency_ms": 2650
  }
}

✦

List IDs can be found in the URL when viewing a list on X, e.g., x.com/i/lists/1580587975121616897.

GET/v2/lists/:listId/membersGet all members of an X list.

Parameter	Type	Required	Default	Description
listId	string	required	—	The numeric list ID
count	integer	optional	20	Number of members to return
sort	string	optional	default	Sort: default, followers, name
cursor	string	optional	—	Pagination cursor

BASH

curl https://xcrop.io/api/v2/lists/1580587975121616897/members?count=20 \
  -H "Authorization: Bearer $XCROP_API_KEY"

GET/v2/lists/:listId/subscribersGet users who subscribed to (follow) an X list.

Parameter	Type	Required	Default	Description
listId	string	required	—	The numeric list ID
count	integer	optional	20	Number of subscribers to return
sort	string	optional	default	Sort: default, followers, name
cursor	string	optional	—	Pagination cursor

BASH

curl https://xcrop.io/api/v2/lists/1580587975121616897/subscribers?count=20 \
  -H "Authorization: Bearer $XCROP_API_KEY"

More in REST API

Full documentation with search: xcrop.io/docs