# Páginas de links

> Crie e edite pela API a página /@usuario do curtei, com os seus links organizados em grupos, para a bio do Instagram e do TikTok.

Fonte: https://curtei.com/docs/api/paginas-de-links

Endpoint: `POST https://api.curtei.com/v1/link-pages`
Escopo: `pages:manage`

Cada conta pode ter até 5 páginas, com até 100 itens cada, publicadas em `https://curtei.com/@<handle>`.

```json
{
  "handle": "casaipe",
  "name": "Casa Ipê",
  "bio": "Decoração artesanal feita à mão",
  "socials": [
    {
      "network": "instagram",
      "url": "https://instagram.com/casaipe"
    }
  ],
  "published": true,
  "items": [
    {
      "title": "Black Friday · até 50% off",
      "url": "https://casaipe.com.br/bf",
      "featured": true,
      "badge": "Só até domingo"
    },
    {
      "title": "Loja online",
      "link_id": "<uuid de um link da conta>",
      "group": "Comprar",
      "icon": "shopping-bag"
    },
    {
      "title": "Fale no WhatsApp",
      "url": "https://wa.me/5511999999999",
      "group": "Atendimento",
      "icon": "message-circle"
    }
  ]
}
```

- `handle`: 3 a 30 caracteres (`a-z`, `0-9`, `.`, `-`, `_`). Em uso → `409 handle_taken`.
- `items` é salvo inteiro: a ordem do array é a ordem na página. Itens seguidos com o mesmo `group` aparecem juntos.
- Cada item aponta para `link_id` (um link da conta; o clique entra nas métricas) ou para `url` direta.
- Rotas: `GET /link-pages`, `GET`/`PATCH`/`DELETE /link-pages/{id}`. Leitura pública, sem token: `GET /public/pages/{handle}`.