API publique des marchés

Tendova publie les données de marchés collectées sur TED sous forme d'API JSON en lecture seule. Elle est gratuite, s'essaie sans clé et renvoie les mêmes avis que le site.

Ce que renvoie l'API

Deux points d'accès, tous deux en JSON et en lecture seule.

GET /api/tenders — recherche les marchés actifs par texte intégral, pays, code CPV et tri, et renvoie une page de résultats avec la pagination.
GET /api/tenders/{id} — renvoie un marché complet : acheteur, codes CPV, lieu d'exécution, valeur estimée, échéances et liens officiels vers la source.
Les titres et descriptions sont renvoyés dans chacune des 24 langues officielles de l'UE via le paramètre locale.

Les résumés IA, les scores de correspondance, les analyses d'adéquation et l'analyse documentaire ne font jamais partie d'une réponse API. Ils restent dans le produit.

Authentification

Aucune clé n'est nécessaire pour essayer l'API. Envoyez-en une dès que vous construisez dessus : les clés sont gratuites sur toutes les offres et augmentent votre quota. Les deux en-têtes fonctionnent.

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

Une clé inconnue, malformée ou révoquée est rejetée avec un HTTP 401 et le code d'erreur invalid_api_key. Ne pas envoyer de clé du tout est un appel anonyme, pas une erreur.

Créer une clé dans votre compte

Limites de débit

Appelant	Quota de requêtes	Enregistrements par requête
Sans clé	20 requêtes par minute et par adresse IP	jusqu'à 20
Clé sur l'offre Free	500 requêtes par jour et par clé	jusqu'à 20
Clé sur l'offre Pro	10 000 requêtes par jour et par clé	jusqu'à 50

Les appels avec clé passent aussi un garde-fou de 60 requêtes par minute, afin qu'un quota journalier ne soit pas consommé d'un seul coup.

Chaque réponse porte x-ratelimit-limit et x-ratelimit-remaining. Un appel au-delà de la limite renvoie un HTTP 429 avec retry-after en secondes.

Exemples

Rechercher des marchés

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

Récupérer un marché

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

Omettez l'en-tête Authorization pour appeler anonymement. Chaque élément de la liste porte un champ apiUrl : l'URL de détail de ce marché, prête à être appelée.

Pour les agents IA

Un court fichier d'orientation décrit les mêmes points d'accès au format llmstxt.org, pour les assistants de code et les frameworks d'agents.

Ouvrir llms.txt

D'où viennent les données

Tous les avis proviennent de Tenders Electronic Daily (TED), le journal officiel des marchés publics de l'UE. Tendova y ajoute la traduction, la structure et la recherche ; les avis eux-mêmes restent des données publiques.

Pour un accès massif ou commercial aux données, écrivez à [email protected].