Skip to content
scrapeatlas.Dashboard

Link in bio

Lnk.Bio API

Retrieve a public Lnk.Bio page's identity, social icons and published links in one request.

1 endpointx-api-key

Fetch the handle, account ID, social and contact icons, display name, bio, profile picture and every visible link from a public lnk.bio page. No Lnk.Bio login is required.

API availability: Available

Base URL · local workerhttp://localhost:3030Public API: https://api.scrapeatlas.com.
Authenticationx-api-keyCustomer key from your account. See Authentication.

Endpoints

GET/v1/linkbio

Get a Lnk.Bio page

Accepts one HTTPS lnk.bio page URL. Tracking parameters and fragments are removed; duplicate parameters and cache_max_age are rejected.

Reference

Quick start

Create an API key on your account page, then call the public API. Values below are placeholders.

Terminal
curl "https://api.scrapeatlas.com/v1/linkbio?url=https%3A%2F%2Flnk.bio%2Fexample" \
  -H "x-api-key: YOUR_API_KEY"

Coverage & limits

  • One page per request; four concurrent requests per worker. Additional requests receive 503 busy.
  • 15-second deadline; at most three upstream requests including redirects, with one retry for a network failure or HTTP 5xx.
  • Maximum 4 MiB decoded HTML; at most 1,000 link records and 100 social icons, with explicit link_limit / social_link_limit partial coverage.
  • The page embedded in the public HTML is returned; password-protected link destinations are never unlocked.
  • Outbound links are returned as data; destination pages, contact downloads and embedded media are never fetched.
  • Blocked or reserved usernames and missing pages return not_found. Marketing pages that are not a profile return unsupported_page.
  • Fresh retrieval on every request.
Error codes
9
HTTPfailure.codeMeaning
400invalid_requestInvalid URL, missing URL, duplicates, or unsupported parameters.
401unauthorizedMissing or invalid service API key.
404not_foundThe page is missing, reserved, or blocked by Lnk.Bio.
429upstream_rate_limitedLnk.Bio rate limited the request; no automatic retry.
502upstream_challengedThe upstream rejected or challenged the request.
502unsupported_pageThe page is not a profile page or its structure changed.
502response_too_large unsafe_redirect request_limit upstream_errorRetrieval could not safely complete.
503busyAll worker slots are in use.
504timeoutThe request exceeded its deadline.