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.
- 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) │ │
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
}'
{
"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"
}
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
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.
| 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. |
- 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.
| 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é |
