API pública
Todos os dados das marcas publicadas estão disponíveis em JSON, sob a licença CC BY 4.0. Sem chaves e sem registo.
Endpoints
| Endereço | Devolve |
|---|---|
/api/v1/brands.json | Todas as marcas publicadas. |
/api/v1/brands/<slug>.json | Uma marca, pelo seu slug. |
/api/v1/categories.json | Categorias e subcategorias, com o número de marcas. |
/api/v1/tags.json | Etiquetas e sinónimos, com o número de marcas. |
/api/v1/regions.json | Distritos e regiões autónomas, concelhos e centroides. |
/api/v1/sustainability.json | Práticas e certificações reconhecidas. |
/api/v1/schema.json | JSON Schema de uma marca (sem envelope). |
Formato da resposta
Todas as respostas são um objeto com os metadados e os dados em data:
{
"version": "v1",
"generated_at": "2026-10-05T18:16:50.747Z",
"license": {
"id": "CC-BY-4.0",
"url": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "Feito em Portugal — https://feitoemportugal.org"
},
"count": 90,
"data": [
…
]
}Schema
O JSON Schema de uma marca é gerado a partir do schema Zod do projeto, por isso acompanha sempre os dados. As regras entre campos que o JSON Schema não consegue expressar continuam a ser validadas pelo validador do projeto.
Versões
A API está em /api/v1. Alterações incompatíveis — remover ou mudar o significado de um campo — passam para uma versão nova; acrescentar campos não é considerado incompatível.
Atribuição
Os dados estão sob CC BY 4.0: podes usá-los, incluindo comercialmente, desde que atribuas a fonte com um link para .feitoemportugal.org
Notas
- Só marcas publicadas entram na API. Rascunhos ficam no repositório.
- Não há dados pessoais nem coordenadas exatas: a localização é o concelho e, nos mapas, o centroide do concelho.
/search-index.jsonnão faz parte da API: é um detalhe interno da pesquisa e pode mudar sem aviso.