API · v1

Documentation.

Une seule URL : https://api.jobydoo.io/v1/jobs

Auth

Header Authorization: Bearer jdy_…. Génère ta clé dans le dashboard.

POST /v1/jobs

curl -X POST https://api.jobydoo.io/v1/jobs \
  -H "Authorization: Bearer jdy_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "directeur industriel",
    "country": "FR",
    "city": "Paris",
    "seniority": "director",
    "remote": "any",
    "posted_within_days": 30,
    "max_results": 50,
    "must_have": ["B2B SaaS"],
    "exclude": ["crypto"],
    "use_xray": false
  }'

Réponse 200

{
  "run_id": "uuid",
  "results": [
    {
      "id": "abc12…",
      "source": "scouter:apec_fr",
      "title": "Directrice industrielle",
      "company": { "name": "…", "logo_url": "…", "domain": "…" },
      "location": { "city": "Lyon", "country_iso2": "FR", "remote": "hybrid" },
      "salary": { "min": 95000, "max": 120000, "currency": "EUR", "period": "year" },
      "posted_at": "2026-04-22T09:14:00Z",
      "apply_url": "https://…",
      "fit_score": 0.91
    }
  ],
  "source_status": [
    { "source": "apec_fr", "status": "ok", "count": 12 }
  ],
  "quota": { "remaining": 49, "plan": "free" },
  "latency_ms": 18420
}

Codes d'erreur

401 missing_credentials	Pas de header Authorization
401 invalid_credentials	Clé inconnue ou révoquée
402 subscription_inactive	Paiement en échec
429 quota_exceeded	Quota du mois épuisé
503 engine_unreachable	Engine indisponible — retry

Sources

26 sources publiques officielles en parallèle : 11 systèmes ATS d'entreprise + boards d'emploi régionaux + feeds nationaux. Toutes les intégrations passent par des APIs documentées, aucune source fermée n'est touchée. Le détail par plan est dans la grille tarifaire.

Fit score

Le champ fit_score (0–1) est calculé à partir des mots-clés partagés par utilisateurs comparables et de la similarité textuelle au titre demandé. Aucun profilage individuel — le score reflète la pertinence agrégée du marché, pas un appariement à votre profil.