API pública de concursos

A Tendova publica os dados de concursos recolhidos no TED como uma API JSON só de leitura. É gratuita, pode ser experimentada sem chave e devolve os mesmos anúncios que o site mostra.

O que a API devolve

Dois endpoints, ambos JSON e ambos só de leitura.

GET /api/tenders — pesquisa concursos ativos por texto integral, país, código CPV e ordenação, e devolve uma página de resultados com paginação.
GET /api/tenders/{id} — devolve um concurso completo: entidade adjudicante, códigos CPV, local de execução, valor estimado, prazos e as ligações oficiais à fonte.
Títulos e descrições são devolvidos em qualquer uma das 24 línguas oficiais da UE através do parâmetro locale.

Resumos de IA, pontuações de correspondência, verificações de adequação e análise documental nunca fazem parte de uma resposta da API. Ficam dentro do produto.

Autenticação

Não é preciso chave para experimentar a API. Envie uma assim que construir sobre ela: as chaves são gratuitas em todos os planos e aumentam o seu limite. Ambos os cabeçalhos funcionam.

Authorization: Bearer tdv_live_…
X-Api-Key: tdv_live_…

Uma chave desconhecida, malformada ou revogada é rejeitada com HTTP 401 e o código de erro invalid_api_key. Não enviar chave nenhuma é uma chamada anónima, não um erro.

Criar uma chave na sua conta

Limites de pedidos

Chamador	Limite de pedidos	Registos por pedido
Sem chave	20 pedidos por minuto, por endereço IP	até 20
Chave no plano Free	500 pedidos por dia, por chave	até 20
Chave no plano Pro	10.000 pedidos por dia, por chave	até 50

As chamadas com chave passam ainda por um travão de picos de 60 pedidos por minuto, para que um limite diário não se esgote de uma só vez.

Cada resposta inclui x-ratelimit-limit e x-ratelimit-remaining. Uma chamada acima do limite devolve HTTP 429 com retry-after em segundos.

Exemplos

Pesquisar concursos

curl -s "https://tendova.eu/api/tenders?q=software&country=DE&limit=20&locale=pt" \
  -H "Authorization: Bearer tdv_live_YOUR_KEY"

Obter um concurso

curl -s "https://tendova.eu/api/tenders/{id}?locale=pt" \
  -H "Authorization: Bearer tdv_live_YOUR_KEY"

Omita o cabeçalho Authorization para chamar de forma anónima. Cada item da lista traz um campo apiUrl: o URL de detalhe desse concurso, pronto a consultar.

Para agentes de IA

Um pequeno ficheiro de orientação descreve os mesmos endpoints no formato llmstxt.org, para assistentes de código e frameworks de agentes.

Abrir llms.txt

De onde vêm os dados

Todos os anúncios vêm do Tenders Electronic Daily (TED), o jornal oficial de contratação pública da UE. A Tendova acrescenta tradução, estrutura e pesquisa; os anúncios em si continuam a ser dados públicos.

Para acesso em massa ou comercial aos dados, escreva para [email protected].