Aperçu de l'API REST

Quand utiliser l’API REST

• Script d’automation (cron, Zapier, n8n, Make)
• Intégration avec ton ATS, CRM, Notion, Airtable
• Préférence d’un outil que MCP n’adresse pas encore (ChatGPT standard, Gemini, etc.)

Pylote Plus requis

L’API REST et le MCP sont réservés à Pylote Plus. Un compte gratuit reçoit un 403 Forbidden sur /v1/me/*. Voir les accès →

Tip

Si tu utilises un agent IA (Claude Desktop, Cursor), préfère le MCP : tu n’as pas à coder le mapping tools → endpoints, l’agent le fait.

Base URL & authentification

https://api-prod.pylote.io

Header Authorization avec ta clé API :

Authorization: Bearer pylk_xxx_xxxxxxxxxxxxxxxxxxxxxxxx

Récupère ta clé dans Settings → Clé API de l’extension Pylote.

Endpoints

Documentation interactive Swagger :

Swagger UI Documentation interactive, teste tes requêtes depuis ton navigateur.

L’ensemble des endpoints /v1/me/* est réservé à Pylote Plus.

Method	Path	Description
GET	/v1/me	Ton profil complet
GET	/v1/me/visibility	Stats de vues (week/month/total)
GET	/v1/me/visibility/leads	Recruteurs + emails
GET	/v1/me/jobs	5000+ missions agrégées
GET	/v1/me/platforms	Plateformes freelances
PUT	/v1/me/availability	Update dispo
PATCH	/v1/me/profile	Update TJM, skills, remote, etc.

Quickstart

curl

# Récupère ton profil
curl https://api-prod.pylote.io/v1/me \
  -H "Authorization: Bearer pylk_xxx_xxxxxxxxxxxxxxxxxxxxxxxx"

# Update ta dispo
curl https://api-prod.pylote.io/v1/me/availability \
  -X PUT \
  -H "Authorization: Bearer pylk_xxx_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"available": true, "date": "2026-05-05"}'

Node.js

const API_KEY = process.env.PYLOTE_API_KEY;
const BASE = 'https://api-prod.pylote.io';

const profile = await fetch(`${BASE}/v1/me`, {
  headers: { Authorization: `Bearer ${API_KEY}` },
}).then((r) => r.json());

await fetch(`${BASE}/v1/me/availability`, {
  method: 'PUT',
  headers: {
    Authorization: `Bearer ${API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ available: true, date: '2026-05-05' }),
});

Python

import os, requests

API_KEY = os.environ["PYLOTE_API_KEY"]
BASE = "https://api-prod.pylote.io"

headers = {"Authorization": f"Bearer {API_KEY}"}

profile = requests.get(f"{BASE}/v1/me", headers=headers).json()

requests.put(
    f"{BASE}/v1/me/availability",
    headers={**headers, "Content-Type": "application/json"},
    json={"available": True, "date": "2026-05-05"},
)

Codes de retour

• 200 : succès
• 401 : clé invalide ou manquante
• 429 : rate limit dépassé (voir les chiffres)
• 500 : erreur serveur, on est notifié