Pular para o conteúdo
POST AI agent ready /v1/short-url/create

API URL Shortener - Crie links curtos com rastreamento de cliques

Envie um URL e receba um link encurtado com um slug gerado automaticamente ou personalizado. Links curtos redirecionam via 302 e rastreiam contagens de cliques. Slugs personalizados suportam letras, números, hifens e sublinhados. Se um slug já tiver sido utilizado, a API retornará um erro para que você possa tentar novamente com outro.

Parameters

stringrequired

The target URL to shorten. Must be a valid http or https URL.

string

An optional custom slug for the short URL. Letters, numbers, hyphens, and underscores only.

Code examples

curl -X POST https://api.botoi.com/v1/short-url/create \
  -H "Content-Type: application/json" \
  -d '{"url":"https://docs.botoi.com/getting-started","custom_slug":"getting-started"}'

When to use this API

Gere links curtos rastreáveis ​​para campanhas de marketing

Crie um link curto com slug personalizado para cada campanha (por exemplo, /launch-2026). Use o endpoint de estatísticas para rastrear cliques e medir o envolvimento sem ferramentas analíticas externas.

Crie um recurso de encurtador de link em seu produto SaaS

Permita que seus usuários criem links curtos de marca em seu aplicativo. A API lida com geração de slug, detecção de colisão e rastreamento de redirecionamento para que você não precise construir essa infraestrutura.

Frequently asked questions

Os links curtos expiram?
Links curtos criados por meio da API não possuem expiração integrada. Eles persistem no armazenamento até serem removidos manualmente ou até que o armazenamento subjacente seja limpo.
O que acontece se meu slug personalizado já estiver em uso?
A API retorna um erro SLUG_TAKEN. Você pode tentar novamente com um slug diferente ou omitir o campo custom_slug para obter um slug de 6 caracteres gerado automaticamente.
Quais caracteres são permitidos em slugs personalizados?
Letras (A-Z, a-z), números (0-9), hífens (-) e sublinhados (_). Quaisquer outros caracteres causam um erro INVALID_SLUG.
As contagens de cliques são rastreadas automaticamente?
Sim. Cada vez que alguém visita o URL curto, o contador de cliques aumenta. Use o endpoint GET /v1/short-url/{slug}/stats para recuperar a contagem atual.
Que tipo de redirecionamento o URL curto usa?
O URL curto retorna um redirecionamento 302 (temporário). Isso significa que os mecanismos de pesquisa não transferirão o valor do link para o URL de destino e você poderá alterar o destino posteriormente, se necessário.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs