---
title: "Linkbio Page API"
method: GET
path: "/v1/linkbio/page"
tags: ["Linkbio"]
---

# Linkbio Page API

`GET /v1/linkbio/page`

## Request

- Base URL: `https://api.captapi.com`
- URL: `https://api.captapi.com/v1/linkbio/page`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

lnk.bio → id, socials{}, titled links[], website/email/whatsapp, other[].

Paste an lnk.bio URL and get the public page as clean JSON. Identity: id (lnk.bio numeric string, e.g. "-1344625"), handle/username, url, avatar. displayName/name are emitted only when lnk.bio publishes a real display name — @handle OG titles are not synthesised (null/omitted). socials{} is derived from data-network icon rows and username CTAs (facebook/twitter/instagram/tiktok/youtube/snapchat/triller/website/whatsapp/…) other[] holds typed social networks we could not map to a known key so nothing disappears. Top-level website / email / whatsapp when published. links[] includes content buttons (pb-linkbox) plus primary social icons with titles from icon labels (Facebook, Instagram, Triller, …) — not null. lnk.bio does not expose follower counts or a verified badge. Flat 1 credit. Pass cache=true or cacheMaxAge (1d/3d/7d/14d/30d).

Docs: https://captapi.com/apis/linkbio-page

## Query parameters

- `url` string, required
- `cache` boolean
- `cacheMaxAge` '1d' | '3d' | '7d' | '14d' | '30d'

## Response `200`

Success. The data object for this endpoint.

- object
  - `success` unknown, required
  - `data` object, required
    - `platform` string: Platform identifier for this response (matches the endpoint's platform).
    - `id` string: lnk.bio numeric profile id as a string (e.g. "-1344625"). From data-uid / avatar path.
    - `url` string: On the page: https://lnk.bio/{username}. On a link row: outbound destination.
    - `username` string: Account username / handle.
    - `handle` string: lnk.bio path slug. Canonical alongside username.
    - `avatar` string: Avatar / profile picture URL. Canonical across profile endpoints.
    - `website` string: Official website URL when published (hero TYPE_BUTTON / official-website CTA or SOCIAL_WEB). Null when unset.
    - `linkCount` integer: Content buttons + primary social icon rows (family deep-link dupes excluded).
    - `socials` object
      - `facebook` string: Facebook URL.
      - `twitter` string: Twitter URL.
      - `instagram` string: Instagram URL.
      - `triller` string: Triller URL.
      - `tiktok` string: Tiktok URL.
      - `youtube` string: Youtube URL.
      - `snapchat` string: Snapchat URL.
      - `website` string: Official website URL when published (hero TYPE_BUTTON / official-website CTA or SOCIAL_WEB). Null when unset.
    - `links` object[]
      - `url` string: On the page: https://lnk.bio/{username}. On a link row: outbound destination.
      - `title` string: Title of this links item.
      - `id` string: Id of this links item.
      - `type` string: Content type of the item.
    - `other` unknown[]: Typed social networks that did not map into socials{} [{url, title?, type?}]. Empty when every icon mapped.
      - unknown

## Other responses

- `400`: Bad request: wrong platform URL, unknown endpoint, or an invalid parameter value. Not billed.
- `401`: Missing, invalid or revoked API key. Not billed.
- `402`: Not enough credits for this request. Not billed.
- `404`: The resource does not exist or is not public. Not billed.
- `422`: A required parameter is missing or has the wrong type. Not billed.
- `429`: Rate limit reached. Wait for Retry-After seconds. Not billed.
- `502`: The platform could not be reached or returned nothing usable. Retryable, not billed. 503 and 504 use the same envelope.

---

[API](https://skmtc.dev/captapi/apis/captapi-api.md) · [All operations](https://skmtc.dev/captapi/apis/captapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/captapi/apis/captapi-api/revisions/c9b9ac5ff1bd?raw)