Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 11 additions & 10 deletions es/api-reference/endpoint/browser-create.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,16 +14,17 @@ openapi: '/es/api-reference/v2-openapi.json POST /interact'

## Cuerpo de la solicitud {#request-body}

| Parámetro | Tipo | Obligatorio | Valor predeterminado | Descripción |
| --------------------- | ------- | ----------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ttl` | number | No | 600 | Duración total de la sesión en segundos (30-3600) |
| `activityTtl` | number | No | 300 | Segundos de inactividad antes de que la sesión se elimine (10-3600) |
| `blockAds` | boolean | No | true | Bloquea anuncios, rastreadores y ventanas emergentes de cookies, como en el scraping |
| `profile` | object | No | — | Habilita el almacenamiento persistente entre sesiones. Consulta más abajo. |
| `profile.name` | string | Sí* | — | Nombre del perfil (1-128 caracteres). Las sesiones con el mismo nombre comparten almacenamiento. |
| `profile.saveChanges` | boolean | No | `true` | Cuando es `true`, el estado del navegador se guarda de nuevo en el perfil al cerrar. Establécelo en `false` para cargar los datos existentes sin escribir. Solo se permite un proceso de guardado a la vez. |
| `location` | object | No | — | País desde el que navega la sesión. Si no se especifica, las sesiones navegan desde EE. UU. |
| `location.country` | string | Sí* | — | Código de país ISO 3166-1 alfa-2, como `GB` o `DE`. Cualquier otro valor, como `us-generic`, se rechaza con un error `400`. |
| Parámetro | Tipo | Obligatorio | Valor predeterminado | Descripción |
| --------------------- | ------- | ----------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ttl` | number | No | 600 | Duración total de la sesión en segundos (30-3600) |
| `activityTtl` | number | No | 300 | Segundos de inactividad antes de que la sesión se elimine (10-3600) |
| `blockAds` | boolean | No | true | Bloquea anuncios, rastreadores y ventanas emergentes de cookies, como en el scraping |
| `profile` | object | No | — | Habilita el almacenamiento persistente entre sesiones. Consulta más abajo. |
| `profile.name` | string | Sí* | — | Nombre del perfil (1-128 caracteres). Las sesiones con el mismo nombre comparten almacenamiento. |
| `profile.saveChanges` | boolean | No | `true` | Cuando es `true`, el estado del navegador se guarda de nuevo en el perfil al cerrar. Establécelo en `false` para cargar los datos existentes sin escribir. Solo se permite un proceso de guardado a la vez. |
| `location` | object | No | — | País desde el que navega la sesión. Si no se especifica, las sesiones navegan desde EE. UU. |
| `location.country` | string | Sí* | — | Código de país ISO 3166-1 alfa-2, como `GB` o `DE`. Cualquier otro valor, como `us-generic`, se rechaza con un error `400`. |
| `zeroDataRetention` | boolean | No | `false` | Ejecuta la sesión con [retención de datos cero](/es/features/interact#zero-data-retention-zdr). Requiere que ZDR esté habilitado para tu equipo (de lo contrario, devuelve `403`). No se puede combinar con `profile` (`400`). |

## Respuesta {#response}

Expand Down
36 changes: 19 additions & 17 deletions es/api-reference/endpoint/scrape-execute.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -23,13 +23,15 @@ Cuando hayas terminado, llama a `DELETE /v2/scrape/{jobId}/interact` para detene

## Request Body {#request-body}

| parámetro | tipo | Required | Default | descripción |
|-----------|------|----------|---------|-------------|
| `code` | string | No | — | Código que se ejecutará en el sandbox del navegador (1–100,000 caracteres). Obligatorio si no se establece `prompt`. |
| `prompt` | string | No | — | Tarea en lenguaje natural para el agente de IA (1–10,000 caracteres). Obligatorio si no se establece `code`. |
| `language` | string | No | `"node"` | Uno de `"python"`, `"node"` o `"bash"`. Solo se usa con `code`. |
| `timeout` | number | No | `30` | Tiempo de espera de ejecución en segundos (1–300). |
| `origin` | string | No | — | Etiqueta de origen opcional que se usa para telemetría. |
| parámetro | tipo | Required | Default | descripción |
| ------------------- | ------- | -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `code` | string | No | — | Código que se ejecutará en el sandbox del navegador (1–100,000 caracteres). Obligatorio si no se establece `prompt`. |
| `prompt` | string | No | — | Tarea en lenguaje natural para el agente de IA (1–10,000 caracteres). Obligatorio si no se establece `code`. |
| `language` | string | No | `"node"` | Uno de `"python"`, `"node"` o `"bash"`. Solo se usa con `code`. |
| `timeout` | number | No | `30` | Tiempo de espera de ejecución en segundos (1–300). |
| `origin` | string | No | — | Etiqueta de origen opcional que se usa para telemetría. |
| `zeroDataRetention` | boolean | No | `false` | Ejecuta la sesión con [retención de datos cero](/es/features/interact#zero-data-retention-zdr). Requiere que ZDR esté habilitado para tu equipo. Se aplica automáticamente si la propia extracción de datos web usó ZDR. |
| `url` | string | No | — | Página que se abrirá en una nueva sesión cuando el contexto de la extracción de datos web original no esté disponible, por ejemplo, tras una extracción de datos web con ZDR. Las acciones de la extracción de datos web no se vuelven a ejecutar. |

## respuesta {#response}

Expand Down Expand Up @@ -107,15 +109,15 @@ curl -X POST "https://api.firecrawl.dev/v2/scrape/550e8400-e29b-41d4-a716-446655

### Códigos de error {#error-codes}

| Status | descripción |
|--------|-------------|
| `402` | Créditos insuficientes para una sesión del navegador |
| `403` | El trabajo de scrape pertenece a otro equipo |
| `404` | No se encontró el trabajo de scrape |
| `409` | Contexto de repetición no disponible — vuelve a ejecutar el scrape e inténtalo de nuevo |
| `410` | La sesión del navegador ya ha sido destruida |
| `429` | Se alcanzó el número máximo de sesiones simultáneas del navegador |
| `502` | Falló el servicio del navegador o la ejecución del agente de IA |
| `503` | La función del navegador no está configurada (solo autogestionado) |
| Status | descripción |
| ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `402` | Créditos insuficientes para una sesión del navegador |
| `403` | El trabajo de extracción de datos web pertenece a otro equipo, o se solicitó `zeroDataRetention`, pero ZDR no está habilitado para tu equipo |
| `404` | No se encontró el trabajo de extracción de datos web |
| `409` | Contexto de repetición no disponible — vuelve a ejecutar la extracción de datos web e inténtalo de nuevo, o pasa `url`. También se devuelve cuando se solicita `zeroDataRetention` en una sesión existente que se inició sin ZDR |
| `410` | La sesión del navegador ya ha sido destruida |
| `429` | Se alcanzó el número máximo de sesiones simultáneas del navegador |
| `502` | Falló el servicio del navegador o la ejecución del agente de IA |
| `503` | La función del navegador no está configurada (solo autogestionado) |

Para obtener información detallada sobre el uso con ejemplos, consulta la [guía de la función Interact](/es/features/interact).
16 changes: 8 additions & 8 deletions es/billing.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,14 +21,14 @@ Los créditos son la unidad de consumo en Firecrawl. Cada plan incluye una cuota

### Costo de créditos por endpoint {#credit-costs-per-endpoint}

| Endpoint | Credit Cost | Notes |
| ------------ | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Scrape** | 1 crédito / página | Convierte una única URL en markdown limpio, HTML o datos estructurados. Se aplican créditos adicionales al usar opciones de extracción (ver más abajo). |
| **Crawl** | 1 crédito / página | Extrae un sitio web completo siguiendo enlaces desde una URL inicial. Los mismos costos por página de las opciones de extracción se aplican a cada página rastreada. |
| **Map** | 1 crédito / llamada | Descubre todas las URL de un sitio web sin extraer su contenido. |
| **Search** | 2 créditos / 10 resultados | Busca en la web y, opcionalmente, extrae los resultados. Redondeado hacia arriba por cada 10 resultados (p. ej., 11 resultados = 4 créditos). Se aplican costos adicionales de extracción por página a cada resultado que se extrae. Consulta [aquí](/es/features/search#zero-data-retention-zdr) los precios de búsqueda ZDR Enterprise. |
| **Interact** | 2–7 créditos / minuto de navegador | Sesión interactiva de navegador en sandbox, facturada por minuto de navegador con un mínimo de un minuto. Las sesiones que usan un `prompt` se facturan a 7 créditos / minuto de navegador; las sesiones sin un prompt (solo `code` de Playwright) se facturan a 2 créditos / minuto de navegador. |
| **Agent** | Dinámico | Agente autónomo de investigación web. 5 ejecuciones diarias gratuitas; precios basados en uso a partir de ese límite. |
| Endpoint | Coste en Créditos | Notes |
| ------------ | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Scrape** | 1 crédito / página | Convierte una única URL en markdown limpio, HTML o datos estructurados. Se aplican créditos adicionales al usar opciones de extracción (ver más abajo). |
| **Crawl** | 1 crédito / página | Extrae un sitio web completo siguiendo enlaces desde una URL inicial. Los mismos costos por página de las opciones de extracción se aplican a cada página rastreada. |
| **Map** | 1 crédito / llamada | Descubre todas las URL de un sitio web sin extraer su contenido. |
| **Search** | 2 créditos / 10 resultados | Busca en la web y, opcionalmente, extrae los resultados. Redondeado hacia arriba por cada 10 resultados (p. ej., 11 resultados = 4 créditos). Se aplican costos adicionales de extracción por página a cada resultado que se extrae. Consulta [aquí](/es/features/search#zero-data-retention-zdr) los precios de búsqueda ZDR Enterprise. |
| **Interact** | 2–7 créditos / minuto de navegador | Sesión interactiva de navegador en sandbox, facturada por minuto de navegador con un mínimo de un minuto. Las sesiones que usan un `prompt` se facturan a 7 créditos / minuto de navegador; las sesiones sin un prompt (solo `code` de Playwright) se facturan a 2 créditos / minuto de navegador. Las sesiones con [retención de datos cero](/es/features/interact#zero-data-retention-zdr) suman 2 créditos / minuto de navegador (9 con prompt, 4 solo con `code`). |
| **Agent** | Dinámico | Agente autónomo de investigación web. 5 ejecuciones diarias gratuitas; precios basados en uso a partir de ese límite. |

### Costos de crédito adicionales para las opciones de extracción {#additional-credit-costs-for-scrape-options}

Expand Down
Loading
Loading