t.co link resolver API for X (Twitter) short links

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

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

GET

links

resolve

t.co link resolver API for X (Twitter) short links

curl --request GET \
  --url https://xquik.com/api/v1/x/links/resolve

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/links/resolve"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "links": [
    {
      "url": "<string>",
      "resolvedUrl": "<string>"
    }
  ],
  "unprocessedUrls": [
    "<string>"
  ]
}

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.

curl -G https://xquik.com/api/v1/x/links/resolve \
  --data-urlencode "urls=https://t.co/Xe1nm2pkSX,https://t.co/QQGjcE6KKq" \
  -H "x-api-key: xq_your_api_key_here" | jq

const params = new URLSearchParams({
  urls: ["https://t.co/Xe1nm2pkSX", "https://t.co/QQGjcE6KKq"].join(","),
});
const response = await fetch(`https://xquik.com/api/v1/x/links/resolve?${params}`, {
  headers: { "x-api-key": "xq_your_api_key_here" },
});
const { links, unprocessedUrls } = await response.json();
const targets = Object.fromEntries(links.map((link) => [link.url, link.resolvedUrl ?? null]));

process.stdout.write(`${JSON.stringify({ targets, unprocessedUrls })}\n`);

import json
import requests

response = requests.get(
    "https://xquik.com/api/v1/x/links/resolve",
    params={"urls": "https://t.co/Xe1nm2pkSX,https://t.co/QQGjcE6KKq"},
    headers={"x-api-key": "xq_your_api_key_here"},
)
body = response.json()
targets = {link["url"]: link.get("resolvedUrl") for link in body["links"]}
print(json.dumps({"targets": targets, "unprocessed_urls": body["unprocessedUrls"]}))

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.

Resolve links in bulk

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

string

required

1 to 100 links of the form https://t.co/Xe1nm2pkSX, separated by commas. Any other link returns 400 invalid_input.

Headers

string

Full account key. Sessions and OAuth also work.

string

Bearer xq_your_guest_key_here for paid_reads.

Response

200 OK

object[]

Resolved links in the order sent. Link object fields.

string

The t.co link, as https://t.co/<code>.

string

Target URL, as the link’s author set it. Absent for a link t.co does not have.

string[]

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

{
  "links": [
    {
      "url": "https://t.co/Xe1nm2pkSX",
      "resolvedUrl": "https://go.nasa.gov/3VcvAQn"
    },
    {
      "url": "https://t.co/QQGjcE6KKq",
      "resolvedUrl": "https://twitter.com/NASA/status/2102882545427714266/photo/1"
    }
  ],
  "unprocessedUrls": []
}

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

{ "error": "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

{ "error": "x_api_unavailable" }

The read service returned an error. Retry after a short delay.

503 Service busy

{ "error": "x_api_unavailable" }

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

{ "error": "rate_limit_exceeded", "retryAfter": 60 }

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

424 Dependency failed

{ "error": "x_api_unavailable" }

The normalized v1 response contract can return 424 when the read service is unavailable.

t.co link resolver API questions

How do I resolve a t.co link with an API?

Call GET /x/links/resolve with the link in urls. The response holds the target in links[0].resolvedUrl.

How many t.co links can I resolve in 1 call?

Send 1 to 100 links, separated by commas. Repeated links count once.

Which link forms does the endpoint accept?

Only https://t.co/ followed by the link’s code. Other sites, http:// links, and links without https:// return 400 invalid_input.

How much does resolving a t.co link cost?

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.

What happens when X does not answer for a link?

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, or Search Tweets finds tweets that share a link.

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

{
  "error": "invalid_input",
  "message": "Invalid input. Check the request body."
}

{
  "error": "unauthenticated",
  "message": "Authentication required."
}

{
  "error": "insufficient_credits",
  "message": "Insufficient credits. Top up or subscribe to continue."
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "rate_limit_exceeded",
  "message": "Too many requests. Try again later.",
  "retryAfter": 60
}

{
  "error": "x_api_unavailable",
  "message": "X data source temporarily unavailable. Try again later."
}

{
  "error": "x_api_unavailable",
  "message": "Xquik is busy right now. Retry shortly."
}

t.co link resolver API for X (Twitter) short links

curl --request GET \
  --url https://xquik.com/api/v1/x/links/resolve

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://xquik.com/api/v1/x/links/resolve"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "links": [
    {
      "url": "<string>",
      "resolvedUrl": "<string>"
    }
  ],
  "unprocessedUrls": [
    "<string>"
  ]
}

Overview

X API

X write

Trends

Radar

Account

API keys

Guest wallets

Credits

X accounts

Monitors

Events

Webhooks

Draws

Extractions

Compose

Drafts

Styles

Support

t.co link resolver API for X (Twitter) short links

Resolve links in bulk

Query parameters

Headers

Response

200 OK

400 Invalid input

401 Unauthenticated

402 Payment required

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

t.co link resolver API questions

How do I resolve a t.co link with an API?

How many t.co links can I resolve in 1 call?

Which link forms does the endpoint accept?

How much does resolving a t.co link cost?

What happens when X does not answer for a link?

Does Xquik visit the target page?

Does this replace X’s official API?

​Resolve links in bulk

​Query parameters

​Headers

​Response

​200 OK

​400 Invalid input

​401 Unauthenticated

​402 Payment required

​502 X API unavailable

​503 Service busy

​429 Rate limit exceeded

​424 Dependency failed

​t.co link resolver API questions

​How do I resolve a t.co link with an API?

​How many t.co links can I resolve in 1 call?

​Which link forms does the endpoint accept?

​How much does resolving a t.co link cost?

​What happens when X does not answer for a link?

​Does Xquik visit the target page?

​Does this replace X’s official API?

Resolve links in bulk

Query parameters

Headers

Response

200 OK

400 Invalid input

401 Unauthenticated

402 Payment required

502 X API unavailable

503 Service busy

429 Rate limit exceeded

424 Dependency failed

t.co link resolver API questions

How do I resolve a t.co link with an API?

How many t.co links can I resolve in 1 call?

Which link forms does the endpoint accept?

How much does resolving a t.co link cost?

What happens when X does not answer for a link?

Does Xquik visit the target page?

Does this replace X’s official API?