Unshorten / resolve a URL API

Follow a short or tracking URL through its redirects to the final destination, returning the full chain. Answers 'where does this short link go', 'unshorten this URL', 'resolve this redirect', 'what's the real link'.

Price$0.01per request

MethodPOST

Route/v1/web/url-unshorten

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache600s public

weburlunshortenredirectlinkexpand

API URLhttps://x402.hexl.dev/v1/web/url-unshorten

Integration docs

Example request

{
  "url": "https://bit.ly/example"
}

Example response

{
  "inputUrl": "https://bit.ly/example",
  "finalUrl": "https://example.com/page",
  "hops": 1,
  "chain": [
    "https://bit.ly/example",
    "https://example.com/page"
  ],
  "truncated": false
}

Input schema

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "examples": [
        "https://bit.ly/example"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "inputUrl",
    "finalUrl",
    "hops"
  ],
  "properties": {
    "inputUrl": {
      "type": "string"
    },
    "finalUrl": {
      "type": "string"
    },
    "hops": {
      "type": "number"
    },
    "chain": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "truncated": {
      "type": "boolean"
    }
  }
}