Skip to main content
GET https://xquik.com/api/v1/x/tweets/{id}/favoriters Requested result counts are upper bounds for paid authenticated calls. Remaining credits may not cover the full page or ID list. If so, Xquik returns fewer results. If zero paid results are affordable, it returns 402 insufficient_credits.
1 credit per result returned · All plans from $0.00012/credit
This route shows who liked one tweet. It returns the likers your connected X account can see. X shows likers only to the post author. Use Connect X account to add the author’s account. Callers without a connected X account get 424 account_required. Guest keys get 403 forbidden. When your connected X accounts are busy, the route returns 503. The route is GET /api/v1/x/tweets/{id}/favoriters.
X does not expose liker identities for every post. When a post reports likes without available liker identities, the endpoint returns 424 favoriters_unavailable. Do not interpret this error as zero likes. Do not interpret it as proof that a specific user did not participate.
The Node.js and Python snippets write JSON Lines liker rows plus a separate checkpoint. They do not write raw response pages. Store each mapped row and the latest next_cursor. An import, giveaway verifier, CRM sync, or agent job can then resume. It can resume from the last completed page without duplicate rows.

Direct tweet liker handoff

Use GET /api/v1/x/tweets/{id}/favoriters when a workflow needs one row per visible account. Each row is an account that liked a post. Use these rows for giveaway checks, CRM imports, audience reviews, or follow-up jobs. Store source_tweet_id, liker_id, username, display_name, follower_count, following_count, verified, verified_type, profile_image_url, and next_cursor.

Liker rows

Store users[] as the visible profile rows for accounts that liked the source post.

Stable upserts

Store users[].id as liker_id with source_tweet_id for idempotent imports and giveaway checks.

Readable labels

Store users[].username and users[].name for handles, labels, and review queues.

Profile enrichment

Store description, location, url, and profilePicture when returned for CRM and warehouse enrichment.

Audience signals

Store followers, following, verified, and verifiedType for scoring, filters, and outreach priority.

Approved contact

Use DM endpoints only after a user-approved message flow. The write response tells you whether X delivered the DM.

Next page

Store has_next_page and next_cursor. Then pass next_cursor back as cursor only when has_next_page is true.

Credit-limited pages

Use users.length, not a requested page size, for row counts. Low balances can return fewer rows.
Direct tweet liker reads cost 1 credit per user returned. Low credit balances can return fewer users than a full page. Zero affordable results return 402 insufficient_credits.

Tweet liker questions

How do I see who liked my tweet?

Connect the X account that posted the tweet. Pass the tweet’s numeric ID. The response lists visible user profiles. Continue pagination only when the response confirms another page. X documents this read intent as Get Liking Users.

Why can’t I see who liked my tweet?

X does not expose every liker set. A tweet can show a like count while its liker profiles remain hidden. 424 favoriters_unavailable does not mean zero likes. Deleted, protected, blocked, or withheld accounts may not appear. Without a connected X account, the route returns 424 account_required.

Does this show an account’s private likes?

No. This endpoint returns visible users for one source tweet. It does not return an account’s Likes tab or private like history.

How do I export tweet likers?

The Node.js and Python examples write one JSON Lines row per visible user. Store the source tweet ID beside each profile. Use next_cursor to resume an export. Use toolType=favoriters for a saved CSV, JSON, or XLSX job.

How can I track and analyze tweet likes?

Run timestamped snapshots and compare them by numeric user ID. This read endpoint does not send notifications for future likes. A like does not prove endorsement, purchase intent, or affiliation. Report only returned fields.

Path parameters

Query parameters

Choose fields

Which tweet engagement endpoint?

Tweet likers

Use GET /x/tweets/{id}/favoriters for user profiles that liked one source tweet.

Retweeters

Use GET /x/tweets/{id}/retweeters for user profiles that reposted one source tweet.

Quote tweets

Use GET /x/tweets/{id}/quotes when you need tweet rows that quote the source tweet.

Tweet replies

Use GET /x/tweets/{id}/replies when you need reply tweet rows under the source tweet.

Saved exports

Use Create extraction with toolType=favoriters for a saved job or CSV, JSON, or XLSX export.

DM handoff

Use Send DM only after your workflow has a user-approved outreach step.

User result filters

These filters apply before billing. Selective filters can return fewer rows.See user filters for every filter. Common ones are minFollowers, verifiedOnly, hasWebsite, hasEmail, bioContains, and locationContains.

Headers

Response

200 OK

401 Unauthenticated

Missing or invalid API key.

402 Payment required

Account users can subscribe or add credits. Confirm payment before continuing.

Response examples

200 example

  • 400 { "error": "invalid_input", "message": "Invalid input. Check the request body." }
  • 401 { "error": "unauthenticated", "message": "Authentication required. Provide a valid API key or bearer token." }
  • 402 { "error": "insufficient_credits", "message": "Insufficient credits. Top up or subscribe to continue." }
  • 403 { "error": "api_key_paused", "message": "This API key is paused. Resume it at dashboard.xquik.com/api-keys to use it again." }
  • 424 { "error": "favoriters_unavailable", "message": "Users who liked this post are unavailable. X shows likers only to the post author. GET /api/v1/x/tweets/1234567890/retweeters lists who retweeted it." }
  • 429 { "error": "rate_limit_exceeded", "message": "Too many requests. Try again later.", "retryAfter": 60 }
  • 502 { "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." }
  • 503 { "error": "x_api_unavailable", "message": "Xquik is busy right now. Retry shortly." }