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.
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.
| Field | Type | Required | Limits |
|---|---|---|---|
| url | string | Required | up 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.
| Field | Type |
|---|---|
| platform | "linktree" or "beacons" or "biolink" or "lnkbio" or "stan" or "generic" |
| final_url | string |
| username | string |
| profile_name | string |
| description | string |
| links | list |
| social_icons | list |
| fetched_at | string |
Response fields for Link-in-Bio Lookup
What it costs
3 credits per resolved page (dead or empty pages are free).
| Case | Charge |
|---|---|
| Found | 3 credits |
| Nothing found | 0 credits |
| Repeat inside 7 days | 0 credits |
| Errors and invalid requests | 0 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: falseand costs 0 credits. - Invalid input and errors are never charged.
- The API allows 200 requests per 10 seconds per key.
Related
Still stuck? Write to hello@lookvalid.com.