API pública

Encurte links e consulte estatísticas via API

A API gratuita do Diminua foi criada para integrações simples, testes rápidos e automações leves. Use sempre o host https://api.diminua.me.

Testar agora
Sem chave inicial O uso público é liberado sem token, protegido por rate limit por IP.
JSON simples Respostas padronizadas com success, data, error e meta.
Host dedicado Integrações devem chamar somente api.diminua.me.
Endpoint

Criar link curto

Cria um link curto aleatório no formato atual do Diminua.

POST https://api.diminua.me/api/v1/links/
Content-Type: application/json

{
  "url": "https://exemplo.com/minha-pagina"
}
{
  "success": true,
  "data": {
    "short_url": "https://diminua.me/N1ch",
    "slug": "N1ch",
    "original_url": "https://exemplo.com/minha-pagina"
  }
}
Endpoint

Consultar estatísticas

Consulta cliques totais, últimas 24 horas, últimos 7 dias e série diária recente.

GET https://api.diminua.me/api/v1/stats/N1ch/
GET https://api.diminua.me/api/v1/stats/?url=https://diminua.me/c/6gG
{
  "success": true,
  "data": {
    "short_url": "https://diminua.me/N1ch",
    "slug": "N1ch",
    "clicks": {
      "total": 20,
      "last_24h": 3,
      "last_7d": 12
    }
  }
}
Endpoint

Criar URL personalizada

Cria um link com tag escolhida, respeitando palavras reservadas, blacklist e disponibilidade.

POST https://api.diminua.me/api/v1/custom-links/
Content-Type: application/json

{
  "url": "https://exemplo.com/minha-campanha",
  "slug": "minha-tag"
}
{
  "success": true,
  "data": {
    "short_url": "https://diminua.me/minha-tag",
    "slug": "minha-tag",
    "original_url": "https://exemplo.com/minha-campanha"
  }
}
Limites

Rate limit gratuito

20 encurtamentos por minuto por IP 10 URLs personalizadas por minuto por IP 120 consultas de estatísticas por minuto por IP 60 consultas de ranking ou blog por minuto por IP 5 denúncias por minuto por IP Somente https://api.diminua.me localhost e 127.0.0.1 liberados para desenvolvimento

Os headers X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset são enviados em todas as respostas da API.

Endpoint

Ranking público

Retorna os dez links mais acessados nas últimas 24 horas, incluindo identificação pública quando houver usuário associado.

GET https://api.diminua.me/api/v1/rankings
Endpoint

Artigos recentes

Retorna os artigos públicos mais recentes para exibição em aplicativos e integrações leves.

GET https://api.diminua.me/api/v1/blog
Endpoint

Artigo público

Obtém o conteúdo textual de um artigo publicado, pronto para leitura segura no aplicativo.

GET https://api.diminua.me/api/v1/blog/67
Endpoint

Perfil público

Retorna avatar, métricas públicas e links de destaque, sem expor e-mail do usuário.

GET https://api.diminua.me/api/v1/profiles/1
Endpoint

Denunciar link

Envia uma denúncia de link Diminua suspeito para análise manual da equipe.

POST https://api.diminua.me/api/v1/reports
Content-Type: application/json

{
  "link": "https://diminua.me/xxxx",
  "email": "[email protected]",
  "description": "Explique o problema encontrado"
}
Exemplo

cURL

curl -X POST https://api.diminua.me/api/v1/links/ \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"https://exemplo.com/minha-pagina\"}"
curl -X POST https://api.diminua.me/api/v1/custom-links/ \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"https://exemplo.com/minha-campanha\",\"slug\":\"minha-tag\"}"
curl https://api.diminua.me/api/v1/stats/N1ch/
Erros

Códigos comuns

421 Use https://api.diminua.me 422 URL ou short URL inválida 429 Rate limit excedido 503 Tabela de rate limit indisponível
Sandbox

Encurtar uma URL

O resultado aparecerá aqui.
Sandbox

Consultar estatísticas

O resultado aparecerá aqui.
Sandbox

Criar URL personalizada

O resultado aparecerá aqui.