Skip to main content
POST
Interagissez avec la session de navigateur associée à une tâche de scrape
Utilisez ce point de terminaison pour continuer à interagir avec le même état de navigateur initialisé à partir d’un scrape précédent. Vous devez fournir soit code, soit prompt — pas les deux. POST /v2/scrape/{jobId}/interact gère l’ensemble du cycle de vie :
  1. Si aucune session de navigateur n’existe encore pour cette tâche de scraping, Firecrawl en crée une dans le même état de page que le scrape d’origine.
  2. Lorsque code est fourni, Firecrawl l’exécute dans le sandbox du navigateur. Lorsque prompt est fourni, un agent IA automatise la tâche en langage naturel.
  3. Les appels ultérieurs à POST /interact sur le même jobId réutilisent le même état actif du navigateur.
Lorsque vous avez terminé, appelez DELETE /v2/scrape/{jobId}/interact pour arrêter la session.

Paramètres de chemin

Corps de la requête

Réponse

Exemple de requête (Code)

Exemple de réponse (code)

Exemple de requête (Prompt)

Exemple de réponse (Prompt)

Codes d’erreur

Pour des informations d’utilisation détaillées avec des exemples, consultez le guide de la fonctionnalité Interact.

Autorisations

Authorization
string
header
requis

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Paramètres de chemin

jobId
string<uuid>
requis

L’ID de tâche de scrape

Corps

application/json
code
string
requis

Code à exécuter dans le sandbox du navigateur lié au scrape

Required string length: 1 - 100000
language
enum<string>
défaut:node

Langage du code à exécuter. Utilisez node pour JavaScript ou bash pour les commandes CLI de agent-browser.

Options disponibles:
python,
node,
bash
origin
string

Étiquette d’origine facultative utilisée pour la télémétrie d’exécution

timeout
integer
défaut:30

Délai d’expiration de l’exécution, en secondes

Plage requise: 1 <= x <= 300

Réponse

Code exécuté avec succès

cdpUrl
string | null

URL WebSocket brute du protocole Chrome DevTools (CDP) pour la session de navigateur. Utilisez-la pour vous connecter directement avec Playwright, Puppeteer ou tout autre client CDP.

error
string | null

Message d’erreur si le code a déclenché une exception

exitCode
integer | null

Code de sortie du processus exécuté

interactiveLiveViewUrl
string | null

URL de la vue en direct interactive (les utilisateurs peuvent contrôler le navigateur)

killed
boolean

Indique si le processus a été arrêté en raison d’un délai d’expiration

liveViewUrl
string | null

URL de la vue en direct en lecture seule pour la session de navigateur

output
string | null

Réponse finale de l’agent IA (présente uniquement lors de l’utilisation d’un prompt)

result
string | null

Sortie standard (alias de stdout)

stderr
string | null

Sortie d’erreur standard de l’exécution du code

stdout
string | null

Sortie standard de l’exécution du code

success
boolean