# curtei

> curtei (https://curtei.com) é um encurtador de links brasileiro e gratuito, com QR Code, métricas de clique, páginas de links para a bio, domínio próprio, webhooks e uma API REST pública. Site e suporte em português do Brasil.

- Preço: grátis. Não há plano pago nem cota mensal de links; só um teto antiabuso de 1.000 links por hora e 5.000 por dia por conta.
- Sem cadastro: dá para encurtar em https://curtei.com (com verificação anti-robô). O link anônimo vale 30 dias e não tem métricas.
- Com conta grátis: links sem validade, métricas de clique (país, estado, cidade, dispositivo, origem), QR Code com cores e logo, senha, validade, limite de cliques, roteamento por visitante, teste A/B, campanhas, conversões, domínio próprio, webhooks e até 5 páginas de links (/@usuario).
- Links curtos ficam em https://l.curtei.com/<código>. Código personalizado só em domínio próprio.
- API REST pública: https://api.curtei.com/v1 (JSON, HTTPS, chave de API no cabeçalho Authorization).
- Privacidade: IP truncado antes de salvar, redirecionamento sem cookies, LGPD e GDPR. Destinos passam pelo Google Web Risk.

## Como integrar pela API

1. Crie uma conta grátis em https://curtei.com/cadastro e confirme o e-mail.
2. Em https://curtei.com/painel/integracoes, crie uma chave de API com os escopos necessários. O token (`<id>|wsk_live_...`) aparece uma vez só.
3. Envie `Authorization: Bearer <token>` e `Idempotency-Key: <uuid>` em todo POST.

```bash
curl -X POST https://api.curtei.com/v1/links \
  -H "Authorization: Bearer $CURTEI_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"url": "https://minhaloja.com.br/promo"}'
```

Resposta 201: `{"id": "...", "short_url": "...", "slug": "...", "url": "...", "status": "active", "qr_code_url": "...", "total_clicks": 0, "created_at": "..."}`.

Erros: `{"error": {"code", "message", "details", "request_id"}}`. Trate 429 lendo `Retry-After`. Listas paginam por cursor (`next_cursor`).

## Documentação da API

- [Referência completa em um arquivo](https://curtei.com/llms-full.txt): toda a API pública em Markdown
- [Visão geral](https://curtei.com/docs/api.md): Crie links curtos, QR Codes e leia métricas de clique pela API REST do curtei. Chave de API, respostas em JSON e exemplos em cURL, JavaScript, PHP e Python.
- [Autenticação](https://curtei.com/docs/api/autenticacao.md): Como criar uma chave de API no curtei, escolher escopos, restringir por IP e enviar o token no cabeçalho Authorization.
- [Erros e limites](https://curtei.com/docs/api/erros.md): Formato de erro da API do curtei, códigos HTTP, rate limit, teto de criação, Idempotency-Key e paginação por cursor.
- [Links](https://curtei.com/docs/api/links.md): POST /v1/links no curtei: parâmetros, exemplos em cURL, JavaScript, PHP e Python, resposta e erros. Também listar, editar e apagar links.
- [Links em lote](https://curtei.com/docs/api/links-em-lote.md): POST /v1/links/bulk: até 1.000 links por chamada com resultado por item, ou até 50.000 em segundo plano.
- [Roteamento e A/B](https://curtei.com/docs/api/roteamento.md): Mande cada visitante para um destino conforme país, estado, cidade, sistema, dispositivo ou idioma, e divida o tráfego entre variantes A/B.
- [QR Code](https://curtei.com/docs/api/qr-code.md): Baixe o QR Code de um link curto em PNG ou SVG, com cores, legenda e logo no centro.
- [Métricas](https://curtei.com/docs/api/metricas.md): Leia cliques por link ou da conta inteira: resumo, série temporal, distribuição por país, cidade, dispositivo e origem, cliques individuais e exportação CSV.
- [Conversões](https://curtei.com/docs/api/conversoes.md): Ligue track_conversions no link e registre vendas e cadastros por postback servidor a servidor ou pixel, com receita por moeda.
- [Webhooks](https://curtei.com/docs/api/webhooks.md): Receba eventos de clique, expiração, bloqueio e conversão no seu servidor, assinados com HMAC-SHA256, com reenvio automático.
- [Domínios](https://curtei.com/docs/api/dominios.md): Cadastre um domínio próprio (go.suamarca.com.br) para links curtos com a sua marca e código personalizado.
- [Páginas de links](https://curtei.com/docs/api/paginas-de-links.md): 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.
- [Campanhas](https://curtei.com/docs/api/campanhas.md): Agrupe links em campanhas e veja as métricas somadas: cliques, cidades, canais e conversões da campanha inteira.

## Ferramentas grátis

- [Encurtar link sem cadastro](https://curtei.com/)
- [Gerador de QR Code](https://curtei.com/gerador-qr-code)
- [Gerador de QR Code](https://curtei.com/gerador-qr-code): QR Code de link, texto, Wi-Fi ou WhatsApp, com logo e cores, em PNG ou SVG.
- [Gerador de link de WhatsApp](https://curtei.com/gerador-link-whatsapp): Número e mensagem pronta em um link wa.me, já encurtado.
- [Desencurtar e verificar link](https://curtei.com/desencurtar): Veja para onde um link curto leva antes de clicar.
- [Encurtar link do WhatsApp](https://curtei.com/encurtar-link-whatsapp)
- [Encurtar link do Instagram](https://curtei.com/encurtar-link-instagram)
- [Encurtar link do YouTube](https://curtei.com/encurtar-link-youtube)
- [Encurtar link do Google Drive](https://curtei.com/encurtar-link-google-drive)
- [Encurtar link do TikTok](https://curtei.com/encurtar-link-tiktok)

## Optional

- [Central de ajuda](https://curtei.com/ajuda)
- [Como saber quantas pessoas clicaram no seu link](https://curtei.com/guias/como-saber-quantas-pessoas-clicaram-no-link)
- [O que é UTM e como montar sem errar](https://curtei.com/guias/o-que-e-utm)
- [Como encurtar um link (no celular e no computador)](https://curtei.com/guias/como-encurtar-link)
- [Como colocar vários links na bio do Instagram](https://curtei.com/guias/como-colocar-varios-links-na-bio-do-instagram)
- [Como saber se um link curto é seguro antes de abrir](https://curtei.com/guias/como-saber-se-um-link-e-seguro)
- [Como encurtar links pela API em PHP, Node e Python](https://curtei.com/guias/encurtar-links-pela-api)
- [Política de privacidade](https://curtei.com/privacidade)