REST API para criar e gerenciar short links

Crie, edite e exclua short links via REST API. Use JSON responses, API keys, documentação OpenAPI / Swagger e webhook notifications para integração rápida com products, services e automation workflows.

Abrir documentação da API Criar conta
# Create a short link $ curl -X POST https://lix.li/api/1.0/links -H "X-Api-Key: lix_live_XXXX" -H "Content-Type: application/json" -d '{"url": "https://example.com/very/long/page", "alias": "demo", "tags" : ["sale", "promo"]}'
# Response { "id": "9053352", "alias": "demo", "short_url": "https://lix.li/demo", "url": "https://example.com/very/long/page", "title": null, "group": null, "created_datetime": "2023-05-23T22:56:57+03:00", "tags": ["sale", "promo"] }

Por que developers escolhem a API da Lix.li

Integração rápida, documentação clara e uma API criada para workflows reais e automação.

REST API

REST conventions limpas, HTTP methods claros e predictable response codes. Integração sem patterns não padronizados nem complexidade desnecessária.

JSON Responses

JSON responses estruturadas para todos os endpoints. Predictable fields, formato de dados consistente e processamento simples no lado do client.

API Keys

Authentication via Bearer tokens. Gerenciamento de chaves, rotation e revogação de acesso diretamente pelo dashboard.

OpenAPI / Swagger

Documentação interativa com request examples, responses e API testing diretamente no navegador.

Predictable Endpoints

Estrutura lógica de resources e URLs: /links, /groups, /analytics, /webhooks. Fácil de ler, usar e manter.

Integração rápida

Use a API com HTTP clients padrão, backend applications, automation services ou internal tools. Ideal para products, CRM, SaaS e backend workflows.

O que a API da Lix.li pode fazer

Crie short links e gerencie analytics, domains, groups e automação por meio de uma única REST API.

Short Links API

Criação, edição, exclusão e recuperação de short links via API. Suporte para bulk operations, pagination, filtering e link management.

Groups & Tags API

Organize links via API usando groups, tags, projects e workspaces. Ideal para teams, campaigns e integrações em grande escala.

Automation API

Integre link shortening com CRM, plataformas de marketing, internal services e automation workflows.

Link Analytics API

Obtenha dados de clicks, países, devices, browsers, traffic sources e UTM campaigns via API.

Tracking Pixels API

Gerencie Google, Hotjar, Yandex, TikTok e outros tracking pixels via API e conecte-os a short links e workflows.

Custom Domains API

Conecte e gerencie branded domains para short links via API. Use suas próprias short URLs em products e campaigns.

Webhooks API

Real-time events para clicks, criação de links, updates e limits. Integração com qualquer service via webhooks.

Gerenciamento de segurança e expiração via API

Configure passwords, expiration dates, click limits e access rules para links via API.

Ecossistema

Explore SDKs para outras plataformas

Use a mesma API do Lix.li do PHP, JavaScript, Python ou Go com SDKs adaptados a cada ecossistema.

Python SDK
Cliente Python tipado para links curtos, grupos, análise e automação. Construído para aplicações Python modernas e fluxos de trabalho.
GitHub Docs
Go SDK
SDK nativo de Go com estruturas tipadas, suporte de contexto e tratamento de erros idiomático para integrações com API de encurtamento de URL.
GitHub Docs
PHP SDK
SDK moderno de PHP com DTOs tipados, modelos somente leitura, exceções dedicadas e instalação via Composer.
GitHub Docs
JS SDK
SDK de JavaScript baseado em Promises para ambientes Node.js e navegador. Crie e gerencie links curtos com uma experiência de desenvolvimento limpa.
GitHub Docs

Documentação de API fácil de entender

OpenAPI / Swagger, interactive testing, request examples prontos para uso e documentação clara para integração rápida.

  • Especificação OpenAPI 3.1
  • Swagger UI para testes
  • Exemplos em curl, Python e Node.js
  • Descrição de cada field e response code
  • Ajuda com integração
  • Geração simples de API clients
Abrir documentação da API
https://lix.li/api/1.0
POST /links Criar link
GET /links Lista de links
GET /links/{id} Obter link
PATCH /links/{id} Editar link
DELETE /links/{id} Excluir link
GET /groups Groups
POST /links/{id}/ab-test/start Iniciar teste A/B
GET /me Perfil e limites

Webhooks — receba eventos sem fazer polling da API

Inscreva um endpoint nos eventos de redirect dos seus links e receba-os em lotes assim que forem acumulados. Cada request body é assinado com HMAC-SHA256 para que você possa verificar o remetente. Disponível no plano Premium.

  • Assinatura HMAC-SHA256 no header X-Lix-Signature
  • Deduplicação de entregas reenviadas por meio de um event_id único
  • Os eventos chegam assim que são acumulados, sem precisar fazer polling contínuo da API
Saiba mais sobre Webhooks
# Requisição para o seu endpoint POST https://your-app.com/webhook X-Lix-Signature: sha256=6b7a3fce1d9c... X-Lix-Timestamp: 1790798400 X-Lix-Delivery: 5b1e2c3d-8f2a-4b7e-9c1a-2f6e7d8a9b0c
# Corpo da requisição { "delivery_id": "5b1e2c3d-8f2a-4b7e-9c1a-2f6e7d8a9b0c", "event_type": "redirects.batch", "sent_at": "2026-09-30T19:40:00Z", "window": { "from": "2026-09-30T19:35:00Z", "to": "2026-09-30T19:40:00Z" }, "count": 1, "truncated": false, "events": [ { "event_id": "a1b2c3d4e5f60718293a4b5c6d7e8f9012345678", "link_id": 9053352, "datetime": "2026-09-30T19:36:12Z", "country": "DE", "city": "Berlin", "browser": "Chrome", "os": "Android", "device": "mobile", "ref_domain": "t.co", "group_id": null, "is_bot": false } ] }

Onde a Short Links API e a URL Shortener API são utilizadas

Products, services e automation workflows onde APIs de short links são usadas em cenários reais.

Produtos SaaS

Short links dentro de user interfaces, referral programs, onboarding flows, notifications e product workflows.

Plataformas de marketing

Criação automática de links para campaigns, publicações, channels e anúncios com UTM tags, analytics e tracking pixels.

Sistemas CRM

Short links personalizadas para clientes, email sequences, deals e rastreamento de user workflows em sistemas CRM.

Automation Workflows

Integração com Zapier, Make, n8n e internal workflows. Criação, atualização e gerenciamento automático de links via API.

Internal Tools

Short links em admin panels, dashboards, service tools e produtos internos sem gerenciamento manual de URLs.

Analytics Pipelines

Coleta de dados de clicks, traffic e analytics via API para BI systems, custom dashboards, data pipelines e relatórios internos.

Comece a usar a Short Links API

Documentação, request examples, Swagger UI e um início rápido sem configurações desnecessárias. Conecte a API ao seu product, service ou automation workflow em minutos.

Abrir documentação da API Criar conta

Perguntas frequentes sobre a Short Links API

A API permite criar, editar, excluir e recuperar short links, além de gerenciar groups, tags, custom domains, tracking pixels, analytics e webhook notifications. Tudo está disponível via REST API com JSON responses.
Sim. A API utiliza HTTP methods padrão (GET, POST, PATCH, DELETE), estrutura de URL clara, semantic endpoints e predictable response codes. Todas as responses são retornadas em formato JSON.
JSON. Cada endpoint retorna structured data com predictable fields. Errors incluem code, message e contexto adicional para troubleshooting e debugging.
Sim. Há uma especificação OpenAPI 3.1 disponível com Swagger UI interativa, request examples e API testing diretamente no navegador.
A authentication é feita com tokens no header X-Api-key. API keys podem ser criadas, rotacionadas e revogadas através do dashboard.
Os API limits dependem do plano escolhido. Restrições atuais e status dos rate limits estão disponíveis nas API responses e na documentação.
Webhooks enviam HTTP requests para seu endpoint quando ocorrem system events: criação de links, clicks, updates ou limit events. Isso permite receber real-time data sem polling contínuo da API.
Sim. O analytics endpoint fornece dados sobre clicks, países, devices, browsers, traffic sources e outras metrics. São suportados filters por dates, links, groups e data ranges.
Basic API access está disponível para testing. Features e limits disponíveis dependem do seu plano. Advanced functionality está disponível nos planos pagos.
Sim. A API evolui continuamente: novos endpoints, documentação expandida, webhook events adicionais e novas automation capabilities são adicionados regularmente. Todas as mudanças são versioned para manter compatibility.
São aceitos bank cards, Bitcoin (BTC), TON e USDT (TRC20). Invoice billing está disponível para Enterprise customers.