Docs
List followers
List followers
Accounts that follow (subscribe to) a list.
GET
/lists/followersParameters
listIdquery · string · requiredNumeric list ID, the number in the list URL (x.com/i/lists/<listId>).
countquery · integer · optional · default 20Number of followers to ask X for. Sent to X as is; X treats it as a hint and decides how many it returns (follower and following pages often hold 50 to 70 users for count=20). A value that is not a number falls back to 20.
cursorquery · string · optionalBottom cursor from the previous page. Leave it out for the first page. See Pagination.
Paginated: pass the bottom cursor of one page as cursor to get the next. Each page is one billed call. See Pagination.
Example request
curl 'https://api.twittrapi.com/lists/followers?listId=84839422' \
--header 'X-API-KEY: YOUR_API_KEY'import httpx
# No SDK method for this endpoint yet, so this is a plain HTTP call.
resp = httpx.get(
"https://api.twittrapi.com/lists/followers",
headers={"X-API-KEY": "YOUR_API_KEY"},
params={
"listId": "84839422",
},
timeout=60,
)
data = resp.json()import { TwittrAPI } from "twittrapi";
const client = new TwittrAPI({ apiKey: process.env.TWITTRAPI_API_KEY });
// No wrapper method for this endpoint yet; client.get() sends the same authenticated GET.
const data = await client.get({
path: "/lists/followers",
query: {
listId: "84839422",
},
});curl 'https://twitter-aio.p.rapidapi.com/lists/followers?listId=84839422' \
--header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY' \
--header 'x-rapidapi-host: twitter-aio.p.rapidapi.com'Base URL https://api.twittrapi.com, key in the X-API-KEY header. Python and Node.js use the official SDKs.
Response
Raw JSON of X's ListSubscribers query.
Simple format (?format=simple or X-Response-Format: simple): Collection of User objects: {data: [User], nextCursor, previousCursor, hasNextPage}. Schema.
{
"data": {
"list": {
"subscribers_timeline": {
"timeline": {
"instructions": [
{
"type": "TimelineClearCache"
},
{
"direction": "Top",
"type": "TimelineTerminateTimeline"
},
{
"entries": [
{
"content": {
"__typename": "TimelineTimelineItem",
"clientEventInfo": {
"component": "SubscribersSgs",
"element": "user"
},
"entryType": "TimelineTimelineItem",
"itemContent": {
"__typename": "TimelineUser",
"itemType": "TimelineUser",
"userDisplayType": "User",
"user_results": {
"result": {
"__typename": "User",
"affiliates_highlighted_label": {},
"avatar": {
"image_url": "https://pbs.twimg.com/profile_images/1000000000000000000/example_normal.jpg"
},
"core": {
"created_at": "Sat Oct 03 03:56:43 +0000 2026",
"name": "Example User 1",
"screen_name": "example_user_1"
},
"dm_permissions": {
"can_dm": true
},
"follow_request_sent": false,
"has_graduated_access": false,
"id": "VXNlcjoxMDAwMDAwMDAwMDAwMDAwMDAx",
"is_blue_verified": false,
"legacy": {
"default_profile": true,
"default_profile_image": false,
"description": "",
"entities": {
"description": {}
},
"fast_followers_count": 0,
"favourites_count": 1,
"follow_request_sent": false,
"followers_count": 0,
"friends_count": 38,
"has_custom_timelines": false,
"is_translator": false,
"listed_count": 0,
"media_count": 1,
"needs_phone_verification": false,
"normal_followers_count": 0,
"notifications": false,
"possibly_sensitive": false,
"profile_banner_url": "",
"profile_interstitial_type": "",
"statuses_count": 6,
"time_zone": "",
"translator_type": "none",
"url": "",
"utc_offset": 0,
"want_retweets": false,
"withheld_description": "",
"withheld_scope": ""
},
"location": {
"location": ""
},
"media_permissions": {
"can_media_tag": false
},
"parody_commentary_fan_label": "None",
"privacy": {
"protected": true
},
"profile_bio": {
"description": ""
},
"profile_image_shape": "Circle",
"relationship_perspectives": {
"blocked_by": false,
"blocking": false,
"followed_by": false,
"following": false,
"muting": false
},
"rest_id": "1000000000000000001",
"super_follow_eligible": false,
"super_followed_by": false,
"super_following": false,
"tipjar_settings": {},
"verification": {
"verified": false
}
}
}
}
},
"entryId": "user-1000000000000000001",
"sortIndex": "2109016363606474750"
},
{
"content": {
"__typename": "TimelineTimelineItem",
"clientEventInfo": {
"component": "SubscribersSgs",
"element": "user"
},
"entryType": "TimelineTimelineItem",
"itemContent": {
"__typename": "TimelineUser",
"itemType": "TimelineUser",
"userDisplayType": "User",
"user_results": {
"result": {
"__typename": "User",
"affiliates_highlighted_label": {},
"avatar": {
"image_url": "https://pbs.twimg.com/profile_images/1000000000000000000/example_normal.jpg"
},
"core": {
"created_at": "Tue Sep 29 10:32:31 +0000 2026",
"name": "Example User 2",
"screen_name": "example_user_2"
},
"dm_permissions": {
"can_dm": false
},
"follow_request_sent": false,
"has_graduated_access": false,
"id": "VXNlcjoxMDAwMDAwMDAwMDAwMDAwMDAy",
"is_blue_verified": false,
"legacy": {
"default_profile": true,
"default_profile_image": true,
"description": "",
"entities": {
"description": {}
},
"fast_followers_count": 0,
"favourites_count": 0,
"follow_request_sent": false,
"followers_count": 0,
"friends_count": 29,
"has_custom_timelines": false,
"is_translator": false,
"listed_count": 0,
"media_count": 0,
"needs_phone_verification": false,
"normal_followers_count": 0,
"notifications": false,
"possibly_sensitive": false,
"profile_banner_url": "",
"profile_interstitial_type": "",
"statuses_count": 0,
"time_zone": "",
"translator_type": "none",
"url": "",
"utc_offset": 0,
"want_retweets": false,
"withheld_description": "",
"withheld_scope": ""
},
"location": {
"location": ""
},
"media_permissions": {
"can_media_tag": true
},
"parody_commentary_fan_label": "None",
"privacy": {
"protected": false
},
"profile_bio": {
"description": ""
},
"profile_image_shape": "Circle",
"relationship_perspectives": {
"blocked_by": false,
"blocking": false,
"followed_by": false,
"following": false,
"muting": false
},
"rest_id": "1000000000000000002",
"super_follow_eligible": false,
"super_followed_by": false,
"super_following": false,
"tipjar_settings": {},
"verification": {
"verified": false
}
}
}
}
},
"entryId": "user-1000000000000000002",
"sortIndex": "2109016363606474749"
},
{
"content": {
"__typename": "TimelineTimelineCursor",
"cursorType": "Bottom",
"entryType": "TimelineTimelineCursor",
"value": "1000000000000000000|2109016363606474730"
},
"entryId": "cursor-bottom-2109016363606474732",
"sortIndex": "2109016363606474732"
},
{
"content": {
"__typename": "TimelineTimelineCursor",
"cursorType": "Top",
"entryType": "TimelineTimelineCursor",
"value": "-1|2109016363606474753"
},
"entryId": "cursor-top-2109016363606474753",
"sortIndex": "2109016363606474753"
}
],
"type": "TimelineAddEntries"
}
]
}
}
}
}
}{
"data": [
{
"id": "1000000000000000001",
"username": "example_user_1",
"name": "Example User 1",
"description": "",
"location": "",
"url": null,
"createdAt": "2026-10-03T03:56:43Z",
"avatarUrl": "https://pbs.twimg.com/profile_images/1000000000000000000/example.jpg",
"bannerUrl": null,
"verified": false,
"verifiedType": null,
"protected": true,
"counts": {
"followers": 0,
"following": 38,
"tweets": 6,
"likes": 1,
"media": 1,
"listed": 0
},
"pinnedTweetIds": [],
"isAutomated": false
},
{
"id": "1000000000000000002",
"username": "example_user_2",
"name": "Example User 2",
"description": "",
"location": "",
"url": null,
"createdAt": "2026-09-29T10:32:31Z",
"avatarUrl": "https://pbs.twimg.com/profile_images/1000000000000000000/example.jpg",
"bannerUrl": null,
"verified": false,
"verifiedType": null,
"protected": false,
"counts": {
"followers": 0,
"following": 29,
"tweets": 0,
"likes": 0,
"media": 0,
"listed": 0
},
"pinnedTweetIds": [],
"isAutomated": false
}
],
"nextCursor": "1000000000000000000|2109016363606474730",
"previousCursor": null,
"hasNextPage": true
}In the raw format, field names and nesting come from X and can change without notice. See Response format; the simple format keeps a fixed schema.
Errors
- 400listId is missing or not numeric.
Errors every endpoint can return (401, 402, 403, 404, 408, 409, 429, 5xx), and which of them are charged, are on the Errors page. Calls that fail with 400, 408, 409 or a 5xx error are refunded.