| 400 | Bad Request / mensaje de validación | El cuerpo de la solicitud no superó la validación del esquema (campos ausentes o no válidos). | Corrige la carga útil de la solicitud utilizando la referencia del punto de conexión. Consulta details para ver los campos afectados. | No |
| 400 | Invalid URL | Falta el campo url, su formato no es válido o usa un esquema no compatible. | Envía una URL absoluta http(s)://. | No |
| 400 | THIRD_PARTY_DATA_UNSUPPORTED_URL | La URL pertenece a un sitio cubierto por un provider de datos de terceros, pero el provider solo sirve la página principal de un registro (como una página de perfil), no las subpáginas que cuelgan de ella. La respuesta incluye este valor en code. | Haz scraping de la página principal del registro en lugar de una subpágina o un listado que dependa de ella. | No |
| 400 | THIRD_PARTY_DATA_UNSUPPORTED_OPTION | Esta URL (como un perfil de LinkedIn) solo puede servirla un provider de datos de terceros, y la solicitud establece una opción que el provider no puede respetar: actions, profile, minAge, zeroDataRetention, lockdown, redactPII o un formato no compatible, como screenshot o branding. error indica el nombre de la opción. La respuesta incluye este valor en code. | Envía la solicitud sin esa opción. Si la política de tu equipo exige la retención de datos cero, no se pueden servir estas URL. Consulta URL enrutadas a través de un provider. | No |
| 401 | Unauthorized: Invalid token | Falta la clave de API, tiene un formato incorrecto o ha sido revocada. | Envía Authorization: Bearer fc-... con una clave válida obtenida del Dashboard. | No |
| 402 | Payment Required: Insufficient credits | Los créditos del plan se han agotado o la facturación no está configurada. | Activa el pago por uso o cambia a un plan superior. | No |
| 403 | Forbidden | La clave no tiene permisos para acceder a este punto de conexión o función. | Usa una clave con el alcance requerido o cambia a un plan superior que dé acceso a esta función. | No |
| 403 | SCRAPE_PROMPT_INJECTION_DETECTED | La opción checkPromptInjection detectó un intento de inyección de prompts en el contenido de la página extraída, por lo que se abortó el scraping. | Revisa manualmente el contenido de la página. Si se trata de un falso positivo, vuelve a intentarlo sin checkPromptInjection. Consulta Detección de inyección de prompts. | No |
| 403 | THIRD_PARTY_DATA_NOT_ENABLED | El provider de datos de terceros para esta URL no está habilitado en tu organización, por ejemplo, porque un administrador de la organización lo desactivó. La respuesta incluye este valor en code. | Pide a un administrador de la organización que active el provider desde su página de Alexandria o quítalo de tus providers de enriquecimiento. | Una vez habilitado |
| 403 | THIRD_PARTY_DATA_ENRICHMENT_NOT_ENABLED | La URL corresponde a un perfil o a una página de empresa de LinkedIn, pero el enriquecimiento está desactivado para ese tipo de perfil o ninguno de tus providers de enriquecimiento guardados puede procesarla. La respuesta incluye este valor en code, y error enlaza a la configuración de enriquecimiento. | Pide a un administrador de la organización que active el enriquecimiento y seleccione los providers en la configuración de enriquecimiento. Consulta URL enrutadas por provider. | Tras la configuración |
| 403 | We apologize for the inconvenience but we do not support this site... / UNSUPPORTED_SITE | Firecrawl no hace scraping de este sitio y ningún provider de datos de terceros da servicio a esa URL. Algunas respuestas también incluyen UNSUPPORTED_SITE en code. | Use otra fuente para obtener estos datos. Los clientes Enterprise pueden ponerse en contacto con el equipo de ventas para consultar sobre el sitio. | No |
| 403 | THIRD_PARTY_DATA_TERMS_REQUIRED | Un provider de Alexandria requiere que tu organización acepte sus términos para poder ejecutar la solicitud. El provider no se ejecutó. La respuesta incluye este valor en code, además de requiresAction.url. | Envía requiresAction.url a un administrador de la organización para que revise y acepte los términos en esa página. Los agentes no deben aceptar los términos por su cuenta. Una vez aceptados, vuelve a enviar la misma solicitud. | Tras aceptar los términos |
| 404 | Not Found | El ID de trabajo, el recurso o la ruta del punto de conexión no existe. | Verifica el ID del recurso y la URL del punto de conexión. | No |
| 404 | THIRD_PARTY_DATA_NOT_FOUND | La URL la proporcionan providers de datos de terceros y ninguno tiene un registro de ella. Si hay varios providers de enriquecimiento, se consultaron todos. Los providers sin registro no generan ningún cargo. La respuesta incluye este valor en code. | Compruebe que la URL apunte a un perfil o a una página de empresa que exista. Añadir más providers de enriquecimiento puede aumentar la cobertura. | No |
| 408 | Request Timeout | La página tardó en cargarse más que el timeout definido en la solicitud. | Aumenta timeout, simplifica las acciones o usa fastMode. | Sí, con espera progresiva |
| 409 | Conflict | El recurso está en un estado que impide la operación (p. ej., ya se ha eliminado). | Vuelva a consultar el estado y resuelva las discrepancias antes de reintentar. | No |
| 413 | Payload Too Large | El cuerpo de la solicitud superó el tamaño máximo permitido. | Reduce la carga útil (p. ej., con un esquema más corto o menos URLs por lote). | No |
| 422 | Unprocessable Entity / error en el esquema de extracción | El esquema no es un JSON Schema válido o el modelo no pudo generar un resultado que se ajuste al esquema. | Valida el esquema; reduce los campos obligatorios; prueba con otro model. | A veces |
| 429 | Rate limit exceeded | Se ha superado el límite de solicitudes por minuto de tu plan. | Reduce la frecuencia de solicitudes y vuelve a intentarlo cuando transcurran los segundos indicados en Retry-After. Consulta Límites de tasa. | Sí, con espera progresiva |
| 429 | Concurrency limit reached | Se ha alcanzado el límite de navegadores simultáneos de tu plan. | Espera a que terminen los trabajos en curso, reduce la concurrencia o cambia a un plan superior. | Sí, con espera progresiva |
| 500 | Internal Server Error | Fallo no controlado en el servidor. | Reintenta con espera exponencial. Si el fallo se conserva, ponte en contacto con el soporte e indica el ID de la solicitud. | Sí, con espera progresiva |
| 502 | Bad Gateway | El proxy o proceso de trabajo upstream devolvió una respuesta no válida. | Reintente aumentando el tiempo de espera entre intentos. | Sí, aumentando el tiempo de espera entre intentos |
| 503 | Service Unavailable | El servicio no puede procesar la solicitud en este momento. | Reintenta con esperas progresivas. | Sí, con esperas progresivas |
| 504 | Gateway Timeout | La solicitud superó el tiempo de espera de la puerta de enlace (normalmente en rastreos prolongados). | En su lugar, usa los puntos de conexión asíncronos de rastreo y procesamiento por lotes y consulta el estado. | Sí, con espera progresiva |