Lnk.Bio Link Search API
Search inside one public Lnk.Bio profile's links and get the matching link boxes as JSON.
GET /v1/lnk-bio/profiles/{handle}/links/search1 credit Failed requests are free
About this endpoint
GET /v1/lnk-bio/profiles/{handle}/links/search?query=draft searches the text of one profile's links. query is required and is 1 to 100 characters.
On found, data.links holds at most 30 matching links, each with the same fields as the links route: id, title, url, type, thumbnailUrl, position, group, badge and blockType. data.query is the search text you sent, data.truncatedAtLimit is true when the 30-match cap was hit, and data.page is { hasMore: false, nextCursor: null } because search has no paging. position is null for links not in the profile's first 48; a match on that first page carries its zero-based position. A query with no match is still a found profile with an empty data.links list.
A missing profile returns HTTP 200 with lookupStatus: "not_found" and an empty list. This searches only the links of the profile in the path. It is not a search across profiles; use the directory route to walk public profiles.
Lnk.Bio Link Search API FAQ
Does search page through results?
No. Search returns at most 30 matches in one response and always sets data.page.hasMore to false. Use the links route with a cursor if you need every link on the profile.
What happens when nothing matches?
You get HTTP 200 with data.lookupStatus found, data.query as sent, and an empty data.links list. The profile still exists; only the search had no match.
Can I search across all Lnk.Bio profiles?
No. Search is scoped to one profile's links. To find public profiles, walk GET /v1/lnk-bio/profiles and its cursor.
How long can the query be?
query is required and is 1 to 100 characters. A missing or empty query is refused with HTTP 400.
How many credits does a search cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.