Skip to main content
graph.swiss
Retour à la plateforme

API Swiss Graph et ressources développeurs

Tout ce dont un développeur ou un agent IA a besoin pour travailler avec les données Swiss Graph : une API publique gratuite en avant-première avec contrat OpenAPI, un serveur MCP, des fiches Markdown pour chaque entreprise et personne, et l'API Graph Swiss à clé pour les gros volumes.

  • Document OpenAPI 3.1 — Contrat lisible par machine de l'API publique en avant-première. https://graph.swiss/openapi.json
  • llms.txt — Aperçu du site et conseils d'utilisation pour les agents IA. https://graph.swiss/llms.txt
  • Serveur MCP — Point de terminaison Streamable HTTP ; document de découverte sous /.well-known/mcp. https://graph.swiss/mcp
  • Fiches Markdown — Ajoutez .md à l'URL de n'importe quel profil d'entreprise ou de personne.
  • Index du plan du site — Chaque page explorable, y compris les index fragmentés des entreprises et des personnes. https://graph.swiss/sitemap.xml
  • Documentation de l'API Graph Swiss — Référence de l'API à clé et facturée à l'appel (X-API-Key). https://docs.graph.swiss/
  • Tarifs — Les formules en version lisible par l'humain et par la machine (pricing.md). https://graph.swiss/pricing.md
  • Clés API — Gérer les clés de l'API Graph Swiss (formule Enterprise).

API publique en avant-première

Cinq opérations en lecture seule sur le registre du commerce suisse, servies depuis graph.swiss sans authentification. Les mêmes faits du registre que le site public, les mêmes règles de confidentialité : organes actuels uniquement, personnes caviardées masquées, les 3 dernières publications FOSC par entreprise. Les réponses sont en JSON ; chaque erreur utilise une enveloppe unique avec un code stable, un message et une indication.

Limites : 60 appels de recherche ou d'autocomplétion et 120 appels de détail par minute et par client. Les réponses portent X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset ; un 429 ajoute Retry-After. Les recherches parcourent au plus 45 lignes par requête — affinez la requête plutôt que de paginer plus loin.

MéthodeCheminOpérationRésumé
GET/api/v1/companies/searchsearchCompaniesSearch Swiss companies
GET/api/v1/companies/autocompleteautocompleteCompaniesAutocomplete a company name
GET/api/v1/companies/{id}getCompanyGet a company record
GET/api/v1/people/searchsearchPeopleSearch registered officers
GET/api/v1/people/{id}getPersonGet a person record

Exemple de requête

curl 'https://graph.swiss/api/v1/companies/search?q=Nestle&canton=VD&limit=3'
curl https://graph.swiss/api/v1/companies/102945

Enveloppe d'erreur

{
  "error": {
    "code": "invalid_parameter",
    "message": "q must be at least 2 characters.",
    "hint": "Pass a company name, UID (CHE-…) or person name of 2–200 characters as ?q=.",
    "docs": "https://graph.swiss/openapi.json"
  }
}

Serveur MCP

Les mêmes opérations sont disponibles sous forme d'outils Model Context Protocol via Streamable HTTP (sans état, sans authentification, réponses JSON). Pointez un client MCP vers le point de terminaison ou laissez-le lire le document de découverte.

Configuration du client

{
  "mcpServers": {
    "swiss-graph": {
      "type": "http",
      "url": "https://graph.swiss/mcp"
    }
  }
}

Fiches Markdown

Chaque profil d'entreprise ou de personne a un jumeau Markdown pour les agents qui préfèrent le texte : ajoutez .md à l'URL canonique. Environ 2 Ko par fiche, les mêmes faits du registre que la page HTML, servis avec un en-tête Link canonique.

https://graph.swiss/companies/{slug}/{id}.md
https://graph.swiss/people/{slug}/{id}.md

API Graph Swiss (à clé)

Pour les gros volumes facturés, les fiches complètes et les données boursières, l'API Graph Swiss s'authentifie par un en-tête X-API-Key, renvoie une enveloppe success/data avec identifiants de requête et facture chaque appel en crédits. Les clés sont délivrées avec la formule Enterprise et gérées sous Compte → Clés API.

Données, confidentialité et conditions

Tous les faits du registre proviennent de la Feuille officielle suisse du commerce (FOSC/SHAB) ; le registre cantonal reste l'autorité légale. L'API en avant-première et le serveur MCP publient uniquement des faits du registre — ni enrichissement, ni coordonnées. Les personnes dont le registre a ordonné le caviardage apparaissent comme « Redacted person » et n'ont aucune fiche consultable. L'utilisation est régie par les conditions d'utilisation.

API Swiss Graph et ressources développeurs | Swiss Graph