How each product works

How to use Link-in-Bio Lookup

What Link-in-Bio Lookup takes in, which fields it returns and how credits are charged for each lookup.

Last updated 2026-10-22

What it does

Fetches a public link-in-bio page and returns its profile title, description and outbound links.

What you send

Send these fields in the JSON body of the request.

Request fields for Link-in-Bio Lookup
FieldTypeRequiredLimits
urlstringRequiredup to 2,048 characters

Request fields for Link-in-Bio Lookup

What you get back

The data object of a successful response carries these fields. Every response also lists its sources, the credits_charged and whether it was a cache_hit.

Each field is described in the API reference.

Response fields for Link-in-Bio Lookup
FieldType
platform"linktree" or "beacons" or "biolink" or "lnkbio" or "stan" or "generic"
final_urlstring
usernamestring
profile_namestring
descriptionstring
linkslist
social_iconslist
fetched_atstring

Response fields for Link-in-Bio Lookup

What it costs

3 credits per resolved page (dead or empty pages are free).

What each outcome costs
CaseCharge
Found3 credits
Nothing found0 credits
Repeat inside 7 days0 credits
Errors and invalid requests0 credits

What each outcome costs

Run it

You can try it without an account in the free tool. The free tools share a limit per visitor.

From code, send a POST request to https://YOUR_API_HOST/v1/link-in-bio-lookup with your API key.

curl -X POST https://YOUR_API_HOST/v1/link-in-bio-lookup \
  -H "Authorization: Bearer $LOOKVALID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://linktr.ee/linktree"}'

A request to Link-in-Bio Lookup

Full parameters and response fields are in the API reference. To run a list of values, use a bulk CSV job.

Good to know

  • A repeat of the same lookup within 7 days is served from your cache and costs 0 credits.
  • When the lookup finds nothing it returns found: false and costs 0 credits.
  • Invalid input and errors are never charged.
  • The API allows 200 requests per 10 seconds per key.

Still stuck? Write to hello@lookvalid.com.