v

latestOpenAPI 3.1.02026-08-09127104507.8 KB
Tweets

List visible users who liked a tweet

Returns liker profiles that X makes visible for the post. X can withhold liker identities even when the post reports likes. In that case this endpoint returns 424 favoriters_unavailable instead of a misleading empty success.

get/api/v1/x/tweets/{id}/favoriters

Path parameters

idstring required

Tweet ID to get favoriters

Query parameters

cursorstring

Pagination cursor for favoriters

pageSizeinteger

Maximum user profiles requested from this page (20-200, default 200). Source, filters, or credits can return fewer profiles. Automatic coverage can prefetch across independent views. Response shape, page size, and per-returned-profile billing stay unchanged. Keep requesting next_cursor while has_next_page is true. Deprecated limit and count aliases remain accepted.

minFollowersinteger

Minimum follower count. Filtering happens before billing.

maxFollowersinteger

Maximum follower count. Missing counts pass this maximum.

minFollowinginteger

Minimum following count.

maxFollowinginteger

Maximum following count.

minStatusesinteger

Minimum post count. minPosts is also accepted.

maxStatusesinteger

Maximum post count. maxPosts is also accepted.

minAccountAgeDaysinteger

Minimum account age in whole days.

verifiedOnlyboolean

Only return verified profiles.

verifiedTypestring

Match the verification type exactly, ignoring case.

hasWebsiteboolean

Only return profiles with a website.

hasLocationboolean

Only return profiles with a location.

bioContainsstring

Match any comma-separated or line-separated bio term, ignoring case.

locationContainsstring

Match a location substring, ignoring case.

usernameContainsstring

Match a username substring, ignoring case.

Response

Visible users who liked the tweet

has_next_pageboolean required
next_cursorstring required

Example response

{
  "users": [
    {
      "id": "9876543210",
      "username": "elonmusk",
      "name": "Elon Musk"
    }
  ],
  "has_next_page": true,
  "next_cursor": "DAACCgACGRElMJcAAA"
}