Skillberg
Console
Vue d'ensembleLa base de compétencesConnecteur Claude et ChatGPTRéférence APIDémarrage rapideTarifs de l'API

Interrogez notre base de compétences
depuis vos propres logiciels.

158 000 compétences, 5 référentiels intégrés, 18 073 correspondances. Une API REST (interface de programmation standard du web), accessible avec une simple clé (x-api-key), décrite au format OpenAPI 3.1 et hébergée en France (Paris, région fr-par).

BASE_URL=https://api.skillberg.app/v1
● disponibilité > 99,9 %region: fr-paropenapi 3.1 · stable
GET /v1/skills/search
$ curl https://api.skillberg.app/v1/skills/search?q=python \
    -H "x-api-key: sk_live_..."
 
{
  "skills": [
    {
      "uri": "skillberg://skill/a8f72c...",
      "label": "Python",
      "confidence": 0.98,
      "referentials": ["esco", "onet"]
    },
    ...
  ],
  "meta": { "took_ms": 142, "region": "fr-par" }
}
Accès

Deux façons de vous authentifier.

HEADERBuilder · Scale · Partner

Clé API dans l'en-tête de la requête

Une clé par environnement (test, production…), créée depuis votre espace client (la console). Elle ne s'affiche qu'une fois, à sa création.

curl https://api.skillberg.app/v1/skills/search?q=python \
  -H "x-api-key: sk_live_..."
  • Recommandé pour la plupart des intégrations
  • Remplaçable à tout moment depuis la console
  • Offre Discovery activée dès la création
OAUTH 2.1Multi-tenant · DCR + PKCE

OAuth (Partner & Omni)

Pour servir plusieurs clients ou entités depuis une même plateforme (multi-tenant), ou pour une offre à votre marque. Inclut DCR et PKCE.

POST /v1/oauth/token
grant_type=client_credentials
client_id=...
client_secret=...
  • Un jeton d'accès distinct pour chaque compte
  • Compatible avec le connecteur MCP
  • Sur devis : contact@skillberg.app
Points d'accès

Cinq familles de points d'accès (endpoints).

Une seule base de référence. Chaque famille traite un type de donnée.

01

Skills

Rechercher, lire et explorer les 158 000 compétences de la base.

Voir dans l'OpenAPI
GET/v1/skills/search?q={query}Recherche tolérante aux fautes.
GET/v1/skills/{uri}Fiche complète multilingue.
GET/v1/skills/{uri}/neighborsCompétences voisines (prérequis, plus larges, plus précises).
GET/v1/skills/{uri}/prerequisitesArbre des prérequis (Skill Trees).
02

Métiers

20 600 métiers (5 référentiels intégrés, 3 en cours) : recherche et fiches détaillées.

Voir dans l'OpenAPI
GET/v1/occupations/search?q={query}Recherche par intitulé, tolérante aux fautes.
GET/v1/occupations/{uri}Fiche métier et compétences requises.
GET/v1/occupations/{uri}/skillsCompétences requises, avec le niveau de maîtrise attendu.
03

CVs

Lecture et enrichissement de CV fournis en texte brut.

Voir dans l'OpenAPI
POST/v1/cvs/treatStructure un CV fourni en texte brut.
POST/v1/cvs/enrichComplète un CV structuré avec les identifiants Skillberg.
POST/v1/cvs/extract-skillsRaccourci : texte brut → identifiants de compétences.
04

Rapprochement

Score d'adéquation entre un CV et un poste.

Voir dans l'OpenAPI
POST/v1/matching/cv-to-jobCV déjà envoyé (user_id) ↔ poste (job_id).
POST/v1/matching/cv-text-to-job-textTexte brut ↔ texte brut, sans envoi de fichier.
05

Correspondances

Traduit un identifiant Skillberg dans le référentiel de votre choix.

Voir dans l'OpenAPI
GET/v1/mapping/crosswalk?uri={uri}&target_taxonomy={ESCO|ROME|ONET|SSF|KLDB|ONS}Conversion.
Tous les endpoints dans l'OpenAPI 3.1
Quotas

Quotas et limites de débit.

Ils dépendent de l'offre choisie dans la console.

TierQuota mensuelRate limitOverage
Discovery500 crédits / mois500 req/jourSoft-block après quota
Builder10 000 crédits / mois5 000 req/jour0,07 € / crédit
Scale25 000 crédits / mois10 000 req/jour0,06 € / crédit
Partner50 000 crédits / moisIllimité0,05 € / crédit
OmniIllimitéIllimitéSur devis

Quota par mois calendaire, remis à zéro le 1er du mois à 00:00 UTC. Offre Discovery gratuite dès la création du compte.

Régions

Où tournent les serveurs.

fr-par
Paris
Région par défaut : l'API et le graphe sont servis depuis la France.
Disponible
eu-west
Dublin
Réplique active-passive.
À l'étude
us-east
Ashburn, VA
Pour les clients américains.
À l'étude
Latence

Temps de réponse.

Ordres de grandeur indicatifs, mesurés depuis l'Europe. Les lectures de la base GET /v1/skills/* sont les plus rapides. Les requêtes POST /v1/matching/* font appel à un modèle et prennent plus de temps.

GET /v1/skills/search~140 ms p50
GET /v1/skills/{uri}~80 ms p50
POST /v1/cvs/treat~400 ms p50
POST /v1/matching/cv-text-to-job-text~600 ms p50
Erreurs

Des erreurs faciles à traiter.

Chaque erreur renvoie le même format JSON, avec un code qui ne change pas.

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Quota mensuel atteint.",
    "details": {
      "tier": "builder",
      "reset_at": "2026-06-01T00:00:00Z"
    }
  }
}
invalid_api_key401
rate_limit_exceeded429
quota_exhausted429
not_found404
validation_error400
internal_error500
Versions

Des versions stables.

Préfixe /v1 stable. Les changements incompatibles sont annoncés 6 mois à l'avance, avec un en-tête Sunset sur les points d'accès concernés.

  • Aucun changement incompatible sans annonce explicite
  • L'ajout de champs ne casse pas vos intégrations
  • Tous les changements notés dans le journal des modifications (CHANGELOG, sur GitHub)
  • Un guide de migration pour chaque version majeure
Voir le CHANGELOG
Kits et spécification

Des outils pour aller plus vite.

OpenAPI 3.1

Description complète, lisible par les logiciels. Importable dans Postman, Insomnia, Stoplight.

openapi.json
β

Kit Python (SDK)

Bibliothèque officielle : appels asynchrones typés, nouvelles tentatives automatiques.

pip install skillberg
Bientôt

Kit TypeScript (SDK)

Bibliothèque TypeScript en préparation.

Me prévenir

Exemples GitHub

Exemples complets pour les 5 familles, en curl, Python et Node.

github.com/Skillberg-app
Prête pour les assistants IA

Une documentation que les assistants IA savent lire.

api.skillberg.app expose un llms.txt, une version llms-full.txt et la spécification OpenAPI 3.1. Vos assistants IA peuvent l'explorer sans passer par nous.

api.skillberg.app · machine-readableLIVE

Compatible avec Claude · ChatGPT · Cursor · Cline · Continue.

prompt · copier-coller dans Claude / ChatGPT / Cursor
Peux-tu explorer la documentation de l'API Skillberg sur
https://api.skillberg.app et voir comment on pourrait intégrer
rapidement leurs outils dans notre application ?

Points à couvrir :
- les 5 familles d'endpoints (skills, occupations, cvs, matching, crosswalk)
- l'authentification x-api-key
- un exemple de requête `GET /v1/skills/search` avec la réponse JSON
- les quotas du tier Builder

Spec machine-readable : https://api.skillberg.app/openapi.json
LLM-friendly digest : https://api.skillberg.app/llms.txt
Version complète : https://api.skillberg.app/llms-full.txt
Commencer

Trente secondes pour une clé.
Cinq minutes pour une intégration.

Créez votre compte, générez une clé, lisez la spécification OpenAPI.

Créer une clé API gratuite Lire la spécification OpenAPI
BASE_URL=https://api.skillberg.app/v1   AUTH=x-api-key

Besoin d'une connexion OAuth ou des quotas de l'offre Omni ? contact@skillberg.app

Vous êtes DRH ou à la direction générale ? La même base fait tourner notre outil pour décider où va l'IA dans vos métiers. Voir la démo