Documentation API

Démarrage rapide

1. Abonnez-vous au plan Premium (l'API est incluse, sans surcoût).
2. Dans l'app : Automatisation → Espace API → générez votre clé fm_live_… (affichée une seule fois).
3. Appelez l'API avec le header x-api-key.

# 1. Créer une recherche
curl -X POST https://app.freelancemention.fr/api/v1/searches \
  -H "x-api-key: fm_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "React remote",
    "keywords": ["react", "typescript"],
    "work_mode": "remote",
    "only_direct_client": true
  }'

# 2. Récupérer les missions qui matchent
curl "https://app.freelancemention.fr/api/v1/searches/SEARCH_ID/results?limit=20" \
  -H "x-api-key: fm_live_VOTRE_CLE"

Authentification

Toutes les requêtes exigent votre clé API dans le header x-api-key (ou Authorization: Bearer fm_live_…). Une clé par compte : la régénérer révoque immédiatement l'ancienne. La clé n'est jamais stockée en clair chez nous (hash SHA-256 uniquement) — conservez-la précieusement.

URL de base : https://app.freelancemention.fr/api/v1

Limite : 60 requêtes/minute par clé · statut Premium revérifié à chaque appel · jusqu'à 50 recherches par compte.

Crée une recherche de missions. Les critères sont identiques à ceux des alertes de l'app.

{
  "id": "305e40a7-6fcf-41b6-bf0c-982947d26788",
  "name": "React remote",
  "keywords": ["react", "typescript"],
  "only_direct_client": true,
  "created_at": "2026-07-09T14:38:32Z",
  "results_url": "/api/v1/searches/305e40a7-…/results"
}

Liste vos recherches (les vôtres uniquement — isolation stricte par compte).

Renvoie les missions détectées qui matchent la recherche, les plus récentes d'abord (30 derniers jours par défaut).

{
  "search_id": "305e40a7-…",
  "total": 40,
  "limit": 20,
  "offset": 0,
  "data": [
    {
      "id": "…",
      "title": "Développeur fullstack senior — Node.js / React (Paris)",
      "description": "…",
      "company": "…",
      "city": "Paris",
      "work_mode": "Hybride",
      "tjm": "550-600 €",
      "tjm_amount": 550,
      "duration": "6 mois",
      "is_off_market": true,
      "is_direct_client": true,
      "poster_firstname": "…",
      "poster_lastname": "…",
      "poster_linkedin": "https://linkedin.com/in/…",
      "contact_email": "…",
      "linkedin_post_url": "https://linkedin.com/posts/…",
      "detected_at": "2026-07-09T10:34:12Z"
    }
  ]
}

Erreurs

Format uniforme : { "error": { "code", "message" } }

Recette : polling toutes les 15 min (n8n, Make, cron)

1. Créez la recherche une fois (POST /searches) et stockez son id.
2. Toutes les 15 min : GET /searches/{id}/results?since={derniere_date}.
3. Pour chaque mission reçue : envoyez-la où vous voulez (Slack, Notion, email…) et mémorisez le detected_at le plus récent pour le prochain appel.

Astuce : les abonnés Premium ont aussi des webhooks natifs sur les alertes (push au lieu de polling) — configurables dans l'app, section Automatisation.