GET /api/v1/x/links/resolve

Tweets

Changed on Oct 20, 2026

Returns where each t.co link leads, as X's own redirect says. Xquik reads the redirect and never visits the target site. A link t.co does not have comes back without resolvedUrl and costs nothing. A link X does not answer for in time comes back in unprocessedUrls, free. Each resolved link costs 1 credit.

get/api/v1/x/links/resolve

Request

Base URL: https://xquik.com
URL: https://xquik.com/api/v1/x/links/resolve
Auth: one of:
- API key in header x-api-key
- HTTP bearer
- none

Query parameters

urlsstring required

Example:https://t.co/Xe1nm2pkSX

1 to 100 links of the form https://t.co/Xe1nm2pkSX, separated by commas. Any other link is refused. A link sent twice counts once. A longer URL fails at the edge before Xquik reads it.

fieldsstring

Example:id,text,author.username

Fields to keep in each row, comma-separated. Use dots for nested fields, such as author.username. A list keeps the field in each item. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name answers 400 unknown_field with the valid names, before any read. The price stays the same. SDK row types then hold only the named fields. A longer URL fails at the edge before Xquik reads it.

omitstring

Example:entities,media

Fields to drop from each row, comma-separated. It takes the same names as fields. With fields, it drops from the kept fields. A longer URL fails at the edge before Xquik reads it.

Response

Resolved links in the order sent

unprocessedUrlsstring[] required

Links not read, in the order sent. X did not answer for them in time, or available credits ran out. Send them again.

Example response

{
  "links": [
    {
      "url": "https://t.co/Xe1nm2pkSX",
      "resolvedUrl": "https://go.nasa.gov/3VcvAQn"
    }
  ],
  "unprocessedUrls": []
}

Changes

Oct 20, 202645942c75fdc2 Revision changes
- warning
  added the new topup_in_progress enum value to the ///// response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the / response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the // response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the /////// response property for the response status
- warning
  added the new topup_in_progress enum value to the ////// response property for the response status
- warning
  added the new topup_in_progress enum value to the /////// response property for the response status

Operation history