# Liinks

> Liinks is a link-in-bio and micro-site platform for creators and businesses. Users build a public profile page — links, text, media embeds, social icons, forms, FAQs, testimonials, a resume, and other blocks, organized into pages — hosted at liinks.co/username or on their own custom domain. The Liinks Public API lets users, and AI agents acting on their behalf, programmatically create and manage profiles, blocks, and styles.

Key facts:

- A profile is the entire public site (header, socials, pages, theme). Every profile has a Home page; more pages render as tabs.
- There is no free plan. Anyone can build and preview a profile for free indefinitely; a subscription makes it live. Subscriptions start with a 14-day free trial that can be cancelled without charge.
- Plans: **Starter** — $5/month or $48/year, one profile, all core features. **Pro** — $12/month or $120/year per pack of 5 profiles (up to 100), for agencies and teams managing multiple profiles from one account.
- Features include: full theme customization (colors, fonts, borders), audio/video/media embeds, folders, multi-page navigation, mailing list and form blocks, rich text, file downloads, scheduled links, Instagram post sync, unlimited dynamic QR codes, page view and per-link click analytics, Facebook pixel and Google Analytics integrations, custom domains, and a public REST API.

## Product

- [Homepage](https://www.liinks.co/): What Liinks is, examples, reviews, and FAQ.
- [Features](https://www.liinks.co/i/features): Full feature list.
- [Pricing](https://www.liinks.co/plans): Starter and Pro plans with current prices.
- [Templates](https://www.liinks.co/templates): Ready-made profile templates to start from.
- [Customer examples](https://www.liinks.co/customers): Real profiles by category — creators, musicians, photographers, brands, coaches, and more.
- [Reviews](https://www.liinks.co/reviews): Customer reviews.

## Comparisons

- [Liinks vs alternatives](https://www.liinks.co/compare): Feature-by-feature comparison hub.
- [Liinks vs Linktree](https://www.liinks.co/compare/linktree)
- [Liinks vs Beacons](https://www.liinks.co/compare/beacons)
- [Liinks vs Stan Store](https://www.liinks.co/compare/stan-store)
- [Liinks vs Later](https://www.liinks.co/compare/later)
- [Liinks vs Shorby](https://www.liinks.co/compare/shorby)

## Free tools

No sign-up required: [all tools](https://www.liinks.co/tools) — including a [QR code generator](https://www.liinks.co/qr-codes), [digital business card generator](https://www.liinks.co/digital-business-card), [bio generator](https://www.liinks.co/bio-generator), [media kit generator](https://www.liinks.co/media-kit-generator), [email signature generator](https://www.liinks.co/email-signature-generator), [Open Graph debugger](https://www.liinks.co/open-graph-debugger), [UTM link builder](https://www.liinks.co/utm-builder), [favicon generator](https://www.liinks.co/favicon-generator), and [engagement rate calculator](https://www.liinks.co/engagement-rate-calculator).

## API

The Public API is a versioned REST API at `https://www.liinks.co/api/v1`, authenticated by Bearer API keys. Validation is strict, errors are structured, and the OpenAPI 3.1 specification is the canonical contract — read it before generating clients. The API is currently in beta: endpoints, field shapes, and validation rules may change with notice.

- [OpenAPI specification](https://www.liinks.co/api/openapi.json): Machine-readable contract for every endpoint, generated from server schemas. Always current. Start here.
- [Interactive docs](https://www.liinks.co/api/docs): Browsable reference rendered from the OpenAPI spec.
- [API root](https://www.liinks.co/api/v1): Discovery payload listing the spec and docs URLs.

### Authentication

All `/api/v1/*` endpoints require `Authorization: Bearer liinks_live_<token>`. Tokens are created under Account → API Keys in the Liinks dashboard. A paid Liinks plan is required; accounts without one receive `402 plan_required`. Creating new managed profiles (`POST /profiles`) additionally requires a plan that supports managing multiple profiles.

Per-key rate limits: 120 requests/minute global, 30 writes/minute. On limit, expect `429 rate_limited` with `error.details.retryAfterSeconds`.

### Resources

- **Profiles** — a Liinks page. `GET/POST /api/v1/profiles`, `GET/PATCH/DELETE /api/v1/profiles/{id}`. Creating a new profile requires a multi-profile plan.
- **Styles** — theme (colors, fonts, background, button styling). `GET/PATCH /api/v1/profiles/{id}/styles`.
- **Blocks** — building blocks of a profile (`link`, `text`, `divider`, `folder`, `media`). `GET/POST /api/v1/profiles/{id}/blocks`, `GET/PATCH/DELETE /api/v1/profiles/{id}/blocks/{blockId}`, `POST /api/v1/profiles/{id}/blocks/reorder` (must include all block IDs on the page).

Block payloads are a discriminated union on `type`. Use `PATCH` to hide, move between pages, or move into folders — there are no dedicated `/hide`, `/move` verbs.

### Errors

Every error returns `{ "error": { "code", "message", "details?" } }`. Common codes: `validation_error` (400, includes a Zod `issues` tree agents can read to self-correct), `unauthorized` (401), `plan_required` (402), `forbidden` (403), `not_found` (404), `conflict` (409), `rate_limited` (429). Unknown input fields are rejected.

## Contact

Product questions, API feedback, or bug reports: hello@liinks.co.

## Optional

- [Help center](https://www.liinks.co/help): Product documentation for human users of Liinks.
- [robots.txt](https://www.liinks.co/robots.txt), [sitemap.xml](https://www.liinks.co/sitemap.xml).