API Pública

Acesse alertas de pets perdidos e encontrados programaticamente. Gratuita, sem autenticação, CORS aberto.

Base URL

https://lostpet.auexpert.com.br/api/v1

GET/pets

Lista alertas ativos (não expirados e não resolvidos) com paginação e filtros.

Query Parameters

tipostringFiltrar por tipo: perdido | encontrado

latnumberLatitude do centro (para filtro geográfico)

lngnumberLongitude do centro

radius_kmnumberRaio em km, default 50, máx 200

qstringBusca textual em nome_pet e descricao

pageintegerPágina, default 1

per_pageintegerItens por página, default 20, máx 100

Exemplo

https://lostpet.auexpert.com.br/api/v1/pets?tipo=perdido&per_page=10

Resposta

{
  "total":    42,
  "page":     1,
  "per_page": 10,
  "items": [
    {
      "id":          "550e8400-e29b-41d4-a716-446655440000",
      "tipo":        "perdido",
      "nome_pet":    "Rex",
      "descricao":   "Labrador amarelo, coleira azul...",
      "contato":     "(11) 99999-9999",
      "lat":         -23.5505,
      "lng":         -46.6333,
      "reported_at": "2026-05-28T10:00:00Z",
      "expires_at":  "2026-06-27T10:00:00Z"
    }
  ]
}

GET/pets/:id

Retorna um alerta pelo UUID. 404 se não encontrado, expirado ou resolvido.

Exemplo

https://lostpet.auexpert.com.br/api/v1/pets/550e8400-e29b-41d4-a716-446655440000

Limites de uso

Sem autenticação para leitura (GET)
Rate limit: 60 requisições/minuto por IP
Cache: 30 segundos (Stale-While-Revalidate)
Para criar alertas via API, entre em contato