---
title: "Link-in-Bio Lookup API"
url: "https://lookvalid.com/products/link-in-bio-lookup.md"
canonical_url: "https://lookvalid.com/products/link-in-bio-lookup"
last_updated: "2026-10-22"
type: "product"
summary: "Fetches a public link-in-bio page and returns its profile title, description and outbound links."
related: ["https://lookvalid.com/pricing.md", "https://lookvalid.com/docs/api/link-in-bio-lookup.md"]
---

# Link-in-Bio Lookup API

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

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

## Facts

- Endpoint: `POST https://YOUR_API_HOST/v1/link-in-bio-lookup`
- Price: 3 credits per resolved page (dead or empty pages are free)
- Charged: Only when a lookup finds something
- Cache: repeating the same lookup within 7 days is free

## Example 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/example"}'
```

## Response

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.

| Field | Type | Description |
| --- | --- | --- |
| `platform` | "linktree" | "beacons" | "biolink" | "lnkbio" | "stan" | "generic" |  |
| `final_url` | string |  |
| `username` | string or null |  |
| `profile_name` | string or null |  |
| `description` | string or null |  |
| `links` | array of object |  |
| `social_icons` | array of object |  |
| `fetched_at` | string |  |

## Priced in credits

| Case | Charge |
| --- | --- |
| Found | 3 credits |
| Nothing found | 0 credits |
| Repeat inside 7 days | 0 credits |
| Errors and invalid requests | 0 credits |

## Questions

### How 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.

### Am 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.

### How long are results cached?

For 7 days, per account. Repeating the same lookup inside that window returns cache_hit: true and costs 0 credits.

### Which 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.

## Related products

- Social Profile Check: Public profile statistics (followers, posts, verification) for a handle or profile URL on Bluesky, TikTok, Instagram, YouTube and X.
- Social Post Lookup: Engagement counts and metadata for a public post URL on TikTok, Instagram, YouTube or Bluesky.
- Video Transcript: Transcript of a public video from its published captions: a caption file, a web page with caption tracks, or a PeerTube video.

Full request and response fields: [Link-in-Bio Lookup reference](https://lookvalid.com/docs/api/link-in-bio-lookup.md).

## Related

- [Plans, trial and credit pricing](https://lookvalid.com/pricing.md)
- [Link-in-Bio Lookup reference](https://lookvalid.com/docs/api/link-in-bio-lookup.md)