Parse a link-page address (free)

Turns any address into structured input for the other routes without fetching anything: which service it belongs to, whether it names one creator’s page or the service’s own site, the handle it carries, the canonical page address, and whether it can be read at all. The right first step for a list of pasted addresses — it separates the readable pages from the recognised-but-unreadable ones before a single page fetch is spent. Makes no request at all, so it answers in milliseconds and costs no credit. Billing: free.

POST /resolve-url Utilities

https://api.fetchlayer.dev/link-in-bio/resolve-url

OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

url string required

Any address to parse.

format string optional

json or markdown, lowercase; any other value is a 400. Over MCP, markdown returns the result rendered as text; the REST API accepts it and returns JSON. (default: json)

timeoutMs integer optional

Time limit for the request, in milliseconds (max 600000).

Response Fields

resolve-url

Parse a link-page address (free)

resultType string

Always "resolve-url".

url string

The address that was parsed.

host string

Its host.

kind string

profile (one creator’s page), provider-home (the service’s own site) or unknown.

provider string

Short, stable id for the service, or null.

providerName string

The service’s public name, or null.

supported boolean

Whether /profile and /links can read this address. Check it before spending a page fetch.

handle string

The handle the address carries, or null.

profileUrl string

The canonical page address, when a handle was recognised.

Request

curl -X POST "https://api.fetchlayer.dev/link-in-bio/resolve-url" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://linktr.ee/nike"}'

Response

{
  "resultType": "resolve-url",
  "url": "https://linktr.ee/nike",
  "host": "linktr.ee",
  "kind": "profile",
  "provider": "linktree",
  "providerName": "Linktree",
  "supported": true,
  "handle": "nike",
  "profileUrl": "https://linktr.ee/nike"
}

{
  "error": "Invalid API key"
}

Product overviewLink in Bio API: what it returns, pricing and use cases