Skip to main content
GET https://xquik.com/api/v1/x/users/{id}/insights
1 credit per report, whatever it reads · A user X doesn’t know is freeAll plans from $0.00012/credit · Supports guest paid reads

A profile’s engagement at a glance

Use GET /x/users/{id}/insights to size up an account before you work with it. Name the user by user ID, username, or profile URL. The report reads the profile’s counts and its 20 most recent posts. Set limit to read more. It still costs 1 credit. A read stops at your count or the account’s oldest post. It also stops after about 40 seconds. A read of more than 800 posts can miss a few. sample.read says how many posts it read. sample.posts says how many of them the averages used. Reposts and the pinned post stay out. So the averages describe the account’s own recent posts. Engagements are likes, replies, reposts, and quotes. A rate is null when nothing divides it. One case is a profile without posts of its own. A protected account’s posts are private. Its report has counts and account age, postsPrivate: true, and a message that says so. It costs the same 1 credit.

Path parameters

Query parameters

Headers

Response

200 OK

400 Invalid input

{ "error": "invalid_user_id" } Send a user ID, a username, or a profile URL.

404 User not found

A user X doesn’t know is free.

401 Unauthenticated

Anonymous requests get WWW-Authenticate: Bearer and a guest wallet checkout action. This is not a Payment challenge.

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.

Response examples

200 example

  • 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." }