Lnk.Bio

Search Lnk.Bio profile links

Search inside one Lnk.Bio profile's links, up to 30 matches, with a visible cap flag and no paging.

GET/v1/lnk-bio/profiles/{handle}/links/search
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
2
handlestringrequiredpath

lnk.bio handle, case preserved, e.g. `sportsillustrated`, `Curate.in`, `S&S` or `@brastel.thai`. A percent-encoded handle is accepted in the public path.

min 2 chars · max 128 chars · pattern: ^[A-Za-z0-9._&+*@/-]+$

querystringrequiredquery

Text to search for inside one profile's links, 1 to 100 characters, e.g. `draft`.

min 1 chars · max 100 chars

Response fields
24

Endpoint-specific response payload.

datalookupStatus
string

Whether the public lnk.bio page was found.

one of: found, not_found

datahandle
string

The canonical handle looked up.

min 1 chars

dataquery
string

The search text, as sent.

min 1 chars

Matching links, at most 30; empty when nothing matched.

datalinks[]id
stringnullable

Stable link id from the platform when available.

datalinks[]title
stringnullable

Link title as displayed on the profile.

datalinks[]url
stringnullable

Destination URL; null for a block link such as a contact form.

min 1 chars

datalinks[]type
stringnullable

Platform link type when available (e.g. CLASSIC, SPOTIFY_ALBUM).

datalinks[]thumbnailUrl
stringnullable

Optional thumbnail image URL for the link.

min 1 chars

datalinks[]position
integernullable

Zero-based position in the profile's link list when known; on search, null for links not in the profile's first 48.

≥ 0

The group heading shown above this link, when any.

datalinks[]groupid
string

Group id; `u` is ungrouped.

min 1 chars

datalinks[]grouptitle
stringnullable

Heading printed before the group, when the page has one.

datalinks[]badge
stringnullable

Badge text shown on the link box, e.g. `TOP`.

datalinks[]blockType
stringnullable

Block type when the link opens a block instead of a URL, e.g. `form`.

datatruncatedAtLimit
boolean

True when 30 matches came back, the endpoint's per-search maximum.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available. On the directory, a page can be empty while this is true; follow `page.nextCursor`.

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/lnk-bio/profiles/sportsillustrated/links/search?query=draft" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Matches inside one profile.