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
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.
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
UseGET /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.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. Usenext_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 areminFollowers, 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.Related. Retweeters · Quote tweets · Tweet replies
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." }