Overview

The Link in Bio API allows you to create and manage personalized landing pages with multiple links.

Base URL

/api/link-in-bio (Authenticated) /api/public/link-in-bio (Public)

Authentication

Authenticated routes require a Bearer token in the Authorization header.

Endpoints

Page Management

List Pages

GET /api/link-in-bio Returns a list of Link in Bio pages for the company.

Create Page

POST /api/link-in-bio Create a new page.

{
  "slug": "my-page",
  "title": "My Awesome Page"
}

Get Page

GET /api/link-in-bio/:slug Get details of a specific page.

Update Page

PUT /api/link-in-bio/:slug Update page settings.

{
  "title": "New Title",
  "theme": "dark"
}

Delete Page

DELETE /api/link-in-bio/:slug Delete a page.

Check Slug Availability

POST /api/link-in-bio/:slug/check-slug Check if a slug is available.

{
  "slug": "new-slug"
}

Link Management

List Links

GET /api/link-in-bio/:slug/links Get all links for a page.

Create Link

POST /api/link-in-bio/:slug/links Add a new link.

{
  "title": "My Website",
  "url": "https://example.com",
  "position": 0
}

Update Link

PUT /api/link-in-bio/:slug/links/:id Update a link.

Delete Link

DELETE /api/link-in-bio/:slug/links/:id Remove a link.

Reorder Links

POST /api/link-in-bio/:slug/links/reorder Reorder links.

[
  { "id": "link-1", "position": 0 },
  { "id": "link-2", "position": 1 }
]

Analytics

Get Page Analytics

GET /api/link-in-bio/:slug/analytics Get aggregated analytics for a page. Query Params: startDate, endDate

Public Routes

Render Page

GET /l/:slug Returns the public page content.

• If Accept: text/html: Returns HTML with SEO tags.
• If Accept: application/json: Returns JSON data.

Track Click

POST /l/:slug/click/:linkId Records a click and redirects to the target URL.