Inscription d’agent

L’Inscription d’agent permet aux agents IA de créer des clés API Firecrawl par programmation — sans navigateur, sans OAuth et sans humain dans la boucle au moment de la création. L’agent fournit l’e-mail d’un humain, et Firecrawl provisionne une clé API isolée qui fonctionne immédiatement avec une limite de 50 crédits. L’humain reçoit un e-mail pour confirmer ou bloquer la clé.

Aucune authentification requise. Le point de terminaison /agent-signup est public. Les agents n’ont pas besoin d’une clé API existante pour l’appeler.

Comment ça marche

Agent appelle POST /v2/agent-signup avec l’e-mail de l’utilisateur, le nom de l’agent et accept_terms: true.
Firecrawl renvoie immédiatement une clé API. La clé est placée en sandbox avec 50 crédits et limitée au seul scraping d’index jusqu’à confirmation du sponsor.
L’utilisateur humain reçoit un e-mail avec deux liens : Confirmer & lier la clé ou Bloquer cette clé.
En cas de confirmation, la clé en sandbox est fusionnée avec le compte Firecrawl existant de l’utilisateur (ou un nouveau compte est créé). La clé hérite des limites complètes de l’offre.
En cas de blocage, la clé est désactivée et l’e-mail est protégé contre de futures inscriptions non autorisées.

Agent                    Firecrawl                  Human
  │                         │                         │
  │── POST /agent-signup ──▶│                         │
  │◀── API key (sandboxed) ─│── verification email ──▶│
  │                         │                         │
  │   uses key (50 credits) │                         │
  │                         │                         │
  │                         │◀── confirm or block ────│
  │                         │                         │
  │   key upgraded to full  │                         │
  │   plan (if confirmed)   │                         │

Pour les Agents

Créer une clé

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
  }'

Réponse :

{
  "success": true,
  "api_key": "fc-...",
  "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"
}

Utilisez immédiatement l’api_key renvoyée pour le scraping, la recherche et les autres opérations de Firecrawl. La clé fonctionne immédiatement, mais elle est plafonnée à 50 credits jusqu’à confirmation par un humain.

Gestion des limites du sandbox

Tant que sponsor_status est "pending" :

La clé est soumise à un plafond strict de 50 crédits. Une fois ce plafond atteint, les requests renvoient 402 avec error: "unverified_credit_limit_reached".
Toutes les scrape requests sont limitées au mode index-only (sans rendu complet dans le navigateur).
La clé expire si elle n’est pas confirmée dans un délai de 5 jours.

Une fois que l’humain confirme, la clé passe à son offre complète, sans plafond de crédits ni restrictions de mode.

Gestion des erreurs

Statut	Erreur	Signification
`402`	`unverified_credit_limit_reached`	Sandbox de 50 crédits épuisé. Demandez à l’humain de confirmer.
`403`	`sponsor_verification_expired`	Le délai de 5 jours est dépassé sans confirmation.
`403`	`This API key has been blocked`	L’humain a bloqué la clé. Arrêtez de l’utiliser.
`409`	`A pending agent signup confirmation has already been sent`	Une clé est déjà en attente pour cet e-mail.

Pour les humains

Lorsqu’un agent crée une clé avec votre e-mail, vous recevez un e-mail avec deux options :

Confirmer et lier la clé — Lie la clé de l’agent à votre compte Firecrawl. Si vous n’avez pas de compte, un compte est créé pour vous. La clé hérite des limites de votre offre.
Bloquer cette clé — Désactive immédiatement la clé et empêche toute future inscription d’agent avec cet e-mail.

Vous pouvez également gérer les clés d’agent depuis le Firecrawl dashboard. Si vous avez déjà un compte, vous verrez aussi une notification dans l’application.

Si vous n’avez pas autorisé l’agent, cliquez immédiatement sur Bloquer cette clé. Cela révoque la clé et empêche toute utilisation ultérieure.

Référence de l’API

Point de terminaison	Description
`POST /v2/agent-signup`	Créer une clé API isolée
`POST /v2/agent-signup/confirm`	Confirmer et lier une clé à un compte
`POST /v2/agent-signup/block`	Bloquer et désactiver une clé

Utilisation de l’API

Points de terminaison pour le scraping

Points de terminaison pour la recherche

Points de terminaison pour la cartographie

Points de terminaison pour l’exploration

Points de terminaison pour le navigateur

Points de terminaison pour les agents

Points de terminaison d’inscription des agents

Points de terminaison d’Extract

Points de terminaison du compte

Payloads de webhook

Inscription d’agent

Comment ça marche

Pour les Agents

Créer une clé

Gestion des limites du sandbox

Gestion des erreurs

Pour les humains

Référence de l’API

​Comment ça marche

​Pour les Agents

​Créer une clé

​Gestion des limites du sandbox

​Gestion des erreurs

​Pour les humains

​Référence de l’API

Comment ça marche

Pour les Agents

Créer une clé

Gestion des limites du sandbox

Gestion des erreurs

Pour les humains

Référence de l’API