API REST CurriculoATS

Intégration

Un accès programmatique complet à vos données de recrutement. Créez des offres, récupérez les scores des candidats, synchronisez les pipelines et concevez des workflows sur mesure. Disponible avec l'offre Pro ($50/mo).

L'API REST CurriculoATS offre un accès programmatique complet à vos données de recrutement, permettant aux équipes de créer des offres, de récupérer les scores des candidats, de gérer les étapes des pipelines et de construire des intégrations sur mesure avec les SIRH, la paie et les outils de reporting. L'API utilise les conventions REST standards avec des réponses JSON, une authentification par clé API et des événements webhook pour des mises à jour en temps réel. Disponible avec l'offre Pro à $50 par mois, sans frais par requête dans la limite des quotas.

Fonctionnalités de l'API

CRUD pour les offres et les candidats

Créez, lisez, mettez à jour et supprimez des offres et des candidats par programmation. Publiez de nouvelles annonces depuis vos outils internes, mettez à jour les étapes des candidats en masse et synchronisez les profils avec des systèmes externes. Opérations CRUD complètes sur toutes les ressources principales.

Scores et données de pipeline

Récupérez les Impact Scores (0–100) et le détail par dimension pour chaque candidat. Interrogez les étapes des pipelines, suivez la progression des candidats et extrayez des métriques de recrutement agrégées pour vos tableaux de bord et rapports personnalisés.

Événements webhook

Abonnez-vous à des événements webhook en temps réel : nouvelle candidature reçue, candidat évalué, changement d'étape, offre envoyée, candidat recruté. Chaque webhook envoie une charge utile JSON avec le contexte complet de l'événement vers votre endpoint.

Export en masse

Exportez en masse les données des candidats, les résultats d'évaluation et les instantanés de pipeline. Extrayez tous les candidats d'un poste, tous les scores entre les postes, ou l'historique complet du pipeline pour vos besoins de conformité et de reporting.

Cas d'usage

Synchronisation avec le SIRH et la paie

Lorsqu'un candidat est marqué comme recruté dans CurriculoATS, envoyez automatiquement son profil vers votre SIRH (BambooHR, Rippling, etc.) ou votre système de paie (Gusto, ADP). Éliminez la saisie manuelle entre le recrutement et l'onboarding.

Tableaux de bord d'analyse personnalisés

Extrayez les métriques de recrutement via l'API et créez des tableaux de bord personnalisés dans l'outil de BI de votre choix : Looker, Metabase ou Google Sheets. Suivez le temps de recrutement, la qualité des sources, la distribution des scores et les taux de conversion de l'entonnoir.

Publication automatisée des offres

Créez des annonces dans CurriculoATS par programmation depuis vos outils internes ou le CMS de votre site carrière. Quand votre équipe ouvre un nouveau poste, l'API crée l'offre, définit les critères d'évaluation et active automatiquement le pipeline.

Enrichissement des données candidat

Utilisez les webhooks pour déclencher des workflows d'enrichissement quand de nouveaux candidats postulent. Récupérez des données supplémentaires depuis Clearbit, LinkedIn ou vos propres bases de données, puis réécrivez les profils enrichis dans Curriculo ATS via l'API.

Technique

Authentification et limites de requêtes

Authentification par clé API

Générez une clé API depuis votre tableau de bord CurriculoATS, dans Settings > API. Incluez la clé dans l'en-tête Authorization de chaque requête. Les clés peuvent être renouvelées à tout moment sans interrompre les intégrations actives.

Limites de requêtes

Les limites standards sont de 100 requêtes par minute et par clé API. L'API renvoie un code 429 quand les limites sont dépassées, avec un en-tête Retry-After indiquant quand réessayer. Des limites plus élevées sont disponibles avec l'offre Enterprise.

Documentation

La documentation complète de l'API est disponible dans le portail développeur CurriculoATS pour les abonnés de l'offre Pro. Elle inclut un explorateur d'API interactif, des exemples de code en cURL, Python, Node.js et Ruby, ainsi que des outils de test de webhook.

Exemple de code

Créez une nouvelle offre en un seul appel d'API.

# Create a new job listing
curl -X POSThttps://api.curriculo.me/v1/jobs \
-H"Authorization: Bearer YOUR_API_KEY" \
-H"Content-Type: application/json" \
-d'{
"title": "Senior Backend Engineer",
"department": "Engineering",
"location": "Remote",
"employment_type": "full_time",
"description": "Build and scale our API infrastructure...",
"scoring_criteria": {
"role_fit_weight": 40,
"outcomes_weight": 35,
"context_weight": 25
}
}'