Link-in-Bio Lookup
Fetches a public link-in-bio page and returns its profile title, description and outbound links.
- 3 credits per resolved page (dead or empty pages are free)
- Charged only when it finds something
- Cached 7 days
3 credits per resolved page (dead or empty pages are free)
Charged only when it finds something. A repeat inside 7 days is free.
Every LookValid product draws on one shared balance. See pricing.
From key to answer in three steps
One key, one POST to /v1/link-in-bio-lookup and a JSON answer back. The same three steps work in any language that can send HTTPS.
- 01
Create a key
Sign up and copy a key from the dashboard. The same key works for every LookValid product and for the MCP server.
Terminal export LOOKVALID_API_KEY="lv_live_..." - 02
Send the request
POST a JSON body to /v1/link-in-bio-lookup. 3 credits per resolved page (dead or empty pages are free).
request.sh 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"}' - 03
Read the answer
A real run of this lookup on 2026-10-18. The data object has 8 named fields.
response.json { "product": "link-in-bio-lookup", "found": true, "data": { "platform": "linktree", "final_url": "https://linktr.ee/linktree", "username": "linktree", "profile_name": "Linktree", "description": null, "links": [ { "title": "Linktree's Linktree", "url": "https://linktr.ee/linktr.ee" } ], ...
A structured answer, not a page of text
The data object has 8 named fields. Every response also lists the sources behind the result, the credits charged and whether it was served from your cache.
Fields returned in data by Link-in-Bio Lookup Field Type platform "linktree" | "beacons" | "biolink" | "lnkbio" | "stan" | "generic" final_url string username string or null profile_name string or null description string or null And 3 more fields in the API reference.
Named fields. Every field is listed in the API reference.
- Your requestone API key
- Your cache7 daysRepeat: 0 credits
- Data sourcefirst lookupFound: 3 credits
- ResultJSON
A repeat lookup is free. Results are cached per account for 7 days. Ask the same question again inside that window and the response comes back with
cache_hit: trueand no charge.Terminal # Sent with every request, for every product Authorization: Bearer $LOOKVALID_API_KEYOne key for your code and your agents. Send your API key as a Bearer token. The same key and the same credit balance cover every other LookValid product. AI agents can call it as a tool on the MCP server at
https://YOUR_API_HOST/v1/mcp.
8
named fields in every answer
7
days a repeat lookup is free
14
lookups on the same key and balance
Latest from the changelog
All changesPriced in credits
Every LookValid product draws on one shared balance. Link-in-Bio Lookup uses 3 credits per resolved page (dead or empty pages are free).
Cost
3credits
Per resolved page (dead or empty pages are free)
- Found3 credits
- Nothing found0 credits
- Repeat inside 7 days0 credits
- Errors and invalid requests0 credits
Questions about Link-in-Bio Lookup
01How much does Link-in-Bio Lookup cost?
3 credits per resolved page (dead or empty pages are free). Credits come out of the one balance shared by every LookValid product.
02Am I charged when nothing is found?
No. When the lookup runs and finds nothing, it returns found: false and costs 0 credits. An error costs nothing either.
03How long are results cached?
For 7 days, per account. Repeating the same lookup inside that window returns cache_hit: true and costs 0 credits.
04Which API key do I use?
The same key as every other product. Send it as a Bearer token in the Authorization header. Email hello@lookvalid.com and we set up your account and send the key.