xAPIs.dev
API Reference · v2
Free Tools{ }OpenAPI YAMLGet API key
API Reference / List / Get list followers

Get list followers

GET/twitter/list/followers18 credits

Retrieve the followers of a Twitter List. Cursor-paginated. The sample response below is captured from the live API. List endpoints paginate with `has_next_page` and `next_cursor`.

Authentication required
Send your key in the x-api-key header. Requests without a valid key return 401.

Query parameters

list_id
stringrequired
The numeric ID of the list.
cursor
stringoptional
Pagination cursor for the next page.

Response fields

followersarray
Array of follower user objects.
has_next_pageboolean
Whether another page of results is available.
next_cursorstring
Cursor for the next page; null or empty when exhausted.
statusstring
Request status: "success" or "error".
msgstring
Status message from the upstream.
Request
curl https://v2.xapis.dev/twitter/list/followers \
  -G --data-urlencode "list_id=2073422513296822490" \
  -H "x-api-key: $XAPIS_KEY"
Response200 OK
application/json
{
  "followers": [
    {
      "id": "1473073308250013699",
      "name": "iruka",
      "userName": "Cd9oL",
      "location": "日本",
      "url": "",
      "description": "基本的低浮上です",
      "protected": false,
      "isVerified": false,
      "isBlueVerified": false,
      "verifiedType": null,
      "followers": 2,
      "following": 82,
      "favouritesCount": 227,
      "statusesCount": 46,
      "mediaCount": 3,
      "createdAt": "2021-12-20T23:30:33.000000Z",
      "coverPicture": "https://pbs.twimg.com/profile_banners/1473073308250013699/1640996095",
      "profilePicture": "https://pbs.twimg.com/profile_images/1492471847010455554/rHI9rba3_normal.jpg",
      "canDm": true,
      "isAutomated": false,
      "automatedBy": null
    }
  ],
  "has_next_page": true,
  "next_cursor": "1869871090765717395|2074779410036162538",
  "status": "success",
  "msg": "success"
}
base url · https://v2.xapis.dev
Ready to call Get list followers?