Passer au contenu principal
Crée immédiatement une nouvelle clé API, en bac à sable avec 50 credits. Un e-mail de vérification est envoyé au sponsor. Aucune authentification requise. Pour un aperçu complet du flux, consultez le guide Agent Signup.

​
En-têtes

En-têteValeur
Content-Typeapplication/json

​
Corps de la requête

ParameterTypeObligatoireDescription
emailstringOuiAdresse e-mail du sponsor humain. Doit être une adresse e-mail valide.
agent_namestringOuiNom de l’agent qui crée la clé (1 à 100 caractères). Affiché dans l’e-mail de vérification.
accept_termsbooleanOuiDoit être défini sur true. Indique l’acceptation des Conditions d’utilisation.

​
Réponse

ChampTypeDescription
successbooleanIndique si la clé a été créée
api_keystringLa clé API fournie (commence par fc-)
sponsor_statusstringToujours "pending" lors de la création
credit_limitnumberNombre maximal de crédits disponibles avant vérification (50)
credits_remainingnumberCrédits restants (50 lors de la création)
verification_deadline_atstringHorodatage ISO 8601. Le sponsor doit confirmer avant cette échéance (5 jours).
tos_urlstringURL des Conditions d’utilisation acceptées

​
Exemple de requête

curl -X POST "https://api.firecrawl.dev/v2/agent-signup" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@company.com",
    "agent_name": "Research Assistant",
    "accept_terms": true
  }'

​
Exemple de réponse

{
  "success": true,
  "api_key": "fc-abc123...",
  "sponsor_status": "pending",
  "credit_limit": 50,
  "credits_remaining": 50,
  "verification_deadline_at": "2026-03-23T12:00:00.000Z",
  "tos_url": "https://firecrawl.dev/terms-of-service"
}

​
Réponses d’erreur

ÉtatErreurQuand
400Corps de la requête invalideChamps manquants ou invalides
403Les inscriptions d’agent sont bloquées pour cet e-mailLe sponsor a précédemment bloqué les inscriptions d’agent
403La vérification d’une précédente inscription d’agent a expiréUne inscription précédente a expiré ; le sponsor doit se connecter
409Une confirmation d’inscription d’agent en attente a déjà été envoyéeUne clé est déjà en attente pour cet e-mail