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.
/resolve-url Utilities https://api.fetchlayer.dev/link-in-bio/resolve-url Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
url string required Any address to parse.
format string optional json or markdown. Markdown returns a rendered summary instead of the structured record. (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"
}