GET https://xquik.com/api/v1/x/users/{id}/highlights
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 · Supports guest paid reads
Order and empty results
UseGET /x/users/{id}/highlights for the posts on a profile’s Highlights tab.
Rows arrive in X’s order. The examples above save that order as
highlight_position.
A user without highlights returns an empty list, not an error.has_next_page is false.
A protected account returns 403 x_account_protected. Xquik charges nothing.Which profile endpoint?
- Use
GET /api/v1/x/users/{id}/highlightsfor the Highlights tab only. - Use
GET /api/v1/x/users/{id}/tweetsfor the whole profile timeline. - Use
GET /api/v1/x/users/{id}/mediawhen every row must be a media tweet.
Path parameters
Query parameters
Tweet result filters
These optional filters apply totweets[] returned by this route. They keep the
same highlights target. Xquik filters rows after it fetches each page. Selective
filters can return fewer rows than an unfiltered page.See tweet filters for every filter. Common ones are fromUser, language, sinceDate, mediaType, minLikes, and hashtags.Choose fields
Headers
Response
200 OK
400 Invalid user ID
{ "error": "invalid_user_id", "message": "Send a user ID, @username or profile URL, such as x.com/nasa." }
The user ID is empty or invalid.403 Protected account
{ "error": "x_account_protected", "message": "Account is protected. Choose a public account." }401 Unauthenticated
Anonymous requests getWWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.
Missing or invalid API key.402 Payment required
Account keys get account options. Guest keys get guest top-up only. No checkout starts automatically. Confirm any payment action.502 X API unavailable
The read service returned an error. Retry after a short delay.429 Rate limit exceeded
You exceeded your tier rate limit. Wait for theRetry-After header before retrying.424 Dependency failed
The normalized v1 response contract can return 424 when the read service is unavailable.Related. Get user timeline · User media · User likes
Response examples
- 400
{ "error": "invalid_input", "message": "Invalid input. Check the request body." } - 401
{ "error": "unauthenticated", "message": "Authentication required." } - 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." } - 404
{ "error": "user_not_found", "message": "X user not found. Check the username." } - 424
{ "error": "x_api_unavailable", "message": "X data source temporarily unavailable. Try again later." } - 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." }