Finodex · API Pública

Dados abertos.
Sem chave. Sem registo.

Todos os preços validados pela comunidade disponíveis em JSON. Use à vontade em projetos pessoais, estudos ou dashboards.

Base URL http://95.179.157.111:3000/api

GET /api/stats

Estatísticas nacionais e médias por distrito. Ponto de entrada recomendado.

Resposta

{
  "national": {
    "avg": 1.85,
    "min": 0.80,
    "max": 6.10,
    "total": 142
  },
  "byDistrict": [
    {
      "district": "Beja",
      "avg": 1.10,
      "count": 8
    },
    {
      "district": "Lisboa",
      "avg": 2.40,
      "count": 54
    }
  ]
}

GET /api/districts

Lista todos os distritos com preço médio, mínimo, máximo e número de entradas.

Resposta

[
  {
    "district": "Porto",
    "avg_price": 1.65,
    "min_price": 1.00,
    "max_price": 2.50,
    "count": 23
  }
]

GET /api/entries

Lista entradas aprovadas. Filtrável por distrito, paginável por limite.

Parâmetro	Tipo	Descrição
`district`	string	Filtrar por distrito (ex: `Lisboa`)
`limit`	number	Número de resultados (padrão: 50, máx: 50)

Exemplo · /api/entries?district=Porto&limit=5

[
  {
    "id": 12,
    "price": 1.20,
    "brand": "Super Bock",
    "size_liters": 0.2,
    "venue": "Café Central",
    "city": "Porto",
    "district": "Porto",
    "address": "R. de Santa Catarina 42",
    "google_rating": 4.3,
    "approved_at": "2026-04-10T14:22:00Z"
  }
]

GET /api/live

As últimas 10 entradas aprovadas, ordenadas por data de aprovação. Ideal para feeds em tempo real.

Resposta

[
  {
    "venue": "Tasca do Zé",
    "city": "Braga",
    "district": "Braga",
    "price": 1.00,
    "brand": "Sagres",
    "size_liters": 0.2,
    "submitter_name": "Miguel",
    "approved_at": "2026-04-16T09:11:00Z"
  }
]

GET /api/random

Devolve um bar aleatório em Portugal com o seu menu. Útil para descoberta e integrações.

Parâmetro	Tipo	Descrição
`:district`	slug (opcional)	Filtrar por distrito — ex: `/api/random/lisboa`, `/api/random/porto`

Resposta · /api/random/porto

{
  "bar": {
    "id": 5,
    "name": "Catraio Craft Beer",
    "slug": "catraio-craft-beer-4",
    "venue_type": "Bar/Pub",
    "city": "Porto",
    "district": "Porto",
    "address": "R. de José Falcão 199",
    "google_rating": 4.7,
    "google_reviews_count": 892
  },
  "menu": [
    { "brand": "Super Bock", "size_liters": 0.2, "price": 2.00 },
    { "brand": "Outra",      "size_liters": 0.33, "price": 4.50 }
  ]
}

Objeto Bar

Representa um estabelecimento físico. Um bar pode ter vários itens de menu.

Campo	Tipo	Descrição
`name`	string	Nome do estabelecimento
`venue_type`	string	Tipo (Café, Bar/Pub, Restaurante...)
`district`	string	Distrito
`city`	string	Localidade
`address`	string\|null	Morada completa
`google_place_id`	string\|null	ID do Google Places
`google_rating`	number\|null	Avaliação Google (1–5)
`latitude`	number\|null	Coordenada geográfica
`longitude`	number\|null	Coordenada geográfica
`slug`	string	Identificador URL (ex: `prison-bar-1`)

Objeto Menu

Representa um produto específico (marca + tamanho) num bar. Cada combinação é única por bar.

Campo	Tipo	Descrição
`price`	number	Preço em euros (ex: `1.20`)
`brand`	string	`Super Bock`, `Sagres` ou `Outra`
`size_liters`	number	Tamanho em litros (ex: `0.2` = 20cL)
`submitter_name`	string\|null	Nome do contribuidor
`comment`	string\|null	Comentário opcional
`approved_at`	string	Data ISO 8601 de aprovação

Notas

🔓

Sem autenticação Todos os endpoints são públicos. Não é necessária chave de API.

✅

Dados validados Apenas entradas aprovadas manualmente são devolvidas. Nenhum spam ou preço falso.

🇵🇹

Portugal apenas Todos os dados referem-se a estabelecimentos em Portugal continental, Açores e Madeira.

⚡

Rate limiting Por favor não abuse. Em caso de uso intensivo, contacte-nos primeiro.

Dados abertos.Sem chave. Sem registo.

Objeto Bar

Objeto Menu

Notas

Dados abertos.
Sem chave. Sem registo.