Skip to main content
Avril 2026 : l’accès à l’API Pylote est désormais gratuit pour tous les partenaires. L’API n’a pas changé, mais la documentation a été entièrement réécrite. Si vous constatez un oubli, une erreur ou une information manquante, signalez-le à hello@pylote.io - on corrige dans la journée.

Pylote Client API

L’API Client Pylote vous permet de récupérer les profils freelances tech de la base Pylote et de les intégrer dans votre plateforme de recrutement. Pylote centralise les profils de freelances inscrits sur Crème, Comet, Free-Work, Collective, WTTJ et plein d’autres, et les met à disposition via cette API au format JSON Resume enrichi.

Ce que vous obtenez

  • Profils complets : compétences, expériences, formations, certifications, langues
  • Disponibilité en temps réel : le freelance met à jour sa dispo dans l’extension Pylote
  • Préférences de mission : TJM, télétravail, durée, jours/semaine, mobilité géographique
  • Liens trackés : CV et LinkedIn via hive.pylote.io (watermarké pour le suivi)
  • Emails proxy : @freelance.pylote.io pour protéger l’identité du freelance

Vos engagements

L’utilisation de cette API est soumise à des engagements contractuels :
  1. Tracker les consultations : chaque fois qu’un recruteur consulte un profil, vous devez envoyer un event via POST /partners/events (détails)
  2. Supprimer les profils deleted sous 30 jours : quand un freelance supprime son compte, vous devez le retirer de votre base dans un délai de 30 jours (détails)
  3. Protéger les données : ne jamais exposer les emails personnels des freelances
  4. Respecter le RGPD : vous êtes responsable de traitement indépendant pour les données que vous recevez via l’API (détails)
  5. Maintenir votre intégration à jour : vous disposez de 15 jours après notification pour vous conformer aux évolutions de l’API (détails)

Interdictions

L’utilisation de l’API est strictement limitée à la mise en relation recruteurs/freelances. Il est interdit de :
  • Revendre, sous-licencier ou transférer l’accès à l’API à des tiers
  • Constituer une base de données concurrente à partir des données Pylote
  • Utiliser les profils à des fins de prospection commerciale non sollicitée
  • Procéder à un profilage automatisé ou illicite des freelances
  • Stocker les données de manière disproportionnée au regard de vos besoins opérationnels
Pour le détail complet, consultez les conditions légales.

Base URL

https://client-p.pylote.io/v1
EnvironnementURLUsage
Productionhttps://client-p.pylote.io/v1Données réelles
Preprodhttps://client-pp.pylote.io/v1Tests avec données réelles (clé preprod)
Sandboxhttps://client-p.pylote.io/v1/sandboxTests sans clé API (données anonymisées)

Démarrage rapide

1

Testez la sandbox

Aucune clé nécessaire. Validez votre intégration avec des données anonymisées :
curl "https://client-p.pylote.io/v1/sandbox/freelances?modifiedTime=0&page=1&limit=10"
2

Obtenez votre clé API

Contactez Pylote pour recevoir votre clé API de production. Voir Authentification pour les détails.
3

Synchronisez les freelances

Récupérez tous les profils avec modifiedTime=0, puis les mises à jour incrémentales. Voir Guide d’intégration pour la stratégie de synchronisation.
4

Trackez les consultations

Envoyez un event à chaque consultation de profil par un recruteur. Voir Obligations de tracking (contractuel).

Format des réponses

L’API retourne du JSON et utilise des codes HTTP standards :
CodeSignification
200Requête réussie
201Ressource créée (POST freelances par IDs, whitelist, events)
204Suppression réussie (pas de body)
400Paramètres invalides (voir le champ message)
401Clé API manquante
403Clé API invalide ou accès refusé

Rate limiting

Pas de rate limiting strict. Nous recommandons 200 requêtes/minute maximum. Si vous avez besoin de plus, contactez-nous.

Import dans votre client API

Le fichier OpenAPI est disponible pour import dans Postman, Insomnia, Bruno ou tout autre client :
https://documentation.client-p.pylote.io/openapi.yaml