TWtwitterapi

Get User Subscriptions

Changed on

Get the creators a user subscribes to (the accounts they pay to support with X Creator Subscriptions, shown on the "Subscriptions" tab of their profile). This is not the list of people who subscribe to the user.

  • Pass the numeric user ID (userId). To get the ID from a username, call Get User Info first.
  • Up to 20 creators per page. Use next_cursor for the next page; has_next_page is false on the last page.
  • Most accounts don't subscribe to anyone, so an empty users list with status: "success" is normal.
  • If the user doesn't exist or is suspended, the response is status: "error" with msg: "user not found".
  • Price: 15 credits per creator returned, with a minimum of 15 credits per request.
  • Empty results (the user subscribes to nobody) and "user not found" responses are charged the 15-credit minimum.
  • If our upstream is temporarily unavailable, the request returns HTTP 502 and is not charged; retry later.
  • For protected accounts, results reflect what the account shows publicly.
get/twitter/user/subscriptions

Request

  • Base URL
    https://api.twitterapi.io
  • URL
    https://api.twitterapi.io/twitter/user/subscriptions
  • Auth
    API key in header X-API-Key

Query parameters

userIdstring required

Numeric user ID, e.g. 11768582. Usernames are not accepted.

cursorstring

Cursor from the previous response's next_cursor. Omit or leave empty for the first page.

Response

Creators the user subscribes to

has_next_pageboolean

true if another page exists; false on the last page

next_cursorstring nullable

Cursor for the next page (null on the last page)

status'success' | 'error'

success, or error when the user doesn't exist

msgstring

Error message, e.g. "user not found"

Changes