Skip to main content
GET https://xquik.com/api/v1/x/links/resolve
1 credit per resolved link · All plans from $0.00012/credit
Resolve links returns the URL each t.co link leads to. Send 1 to 100 links in 1 call. The endpoint is GET /api/v1/x/links/resolve.
Use GET /x/links/resolve when you hold t.co links and need their targets. X shortens every link in a post to a t.co link. Xquik reads where each link points and never opens the target page.
Collect the t.co links from tweet text, bios, or your own logs. Send up to 100 in 1 call, separated by commas. links comes back in the order sent, with each link once. A link t.co does not have comes back without resolvedUrl. It costs nothing. Each resolved link costs 1 credit. A link X does not answer for in time comes back in unprocessedUrls. It costs nothing. Send it again in your next call. resolvedUrl is the address the link’s author set. Xquik does not check it. Check a target before you open it. Tweets already carry their links’ targets in entities.urls[].expanded_url. Read them with Get tweet when you hold the tweet ID.

Query parameters

Choose fields

Headers

Response

200 OK

400 Invalid input

{ "error": "invalid_input", "message": "Send urls as 1 to 100 links of the form https://t.co/Xe1nm2pkSX, separated by commas." } urls is missing, holds over 100 links, or holds a link in another form. Send each link as https://t.co/ and its code.

401 Unauthenticated

Missing or invalid API key. Check the x-api-key header value.

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.

503 Service busy

X answered none of the links in time, or Xquik is busy. Wait for the Retry-After header, then send the same links again. The request costs nothing.

429 Rate limit exceeded

You exceeded your tier rate limit. Wait for the Retry-After header before retrying.

424 Dependency failed

The normalized v1 response contract can return 424 when the read service is unavailable.
Call GET /x/links/resolve with the link in urls. The response holds the target in links[0].resolvedUrl.Send 1 to 100 links, separated by commas. Repeated links count once.Only https://t.co/ followed by the link’s code. Other sites, http:// links, and links without https:// return 400 invalid_input.Each resolved link costs 1 credit. A link t.co does not have costs nothing. A link X does not answer for costs nothing. A refused or failed request costs nothing.The call still returns the links that resolved. The unanswered links come back in unprocessedUrls. Send them again.

Does Xquik visit the target page?

No. Xquik reads where the t.co link points and stops there.

Does this replace X’s official API?

No. This page documents Xquik, an independent third-party service. It does not document X’s official API.
Next steps. Get tweet reads a tweet with its links’ targets. Search Tweets finds tweets that share a link.

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