Errores de la API

La API de Web Scraping devuelve códigos de estado HTTP estándar. Las respuestas que no son 2xx incluyen un cuerpo JSON con un campo error que describe qué ha fallado.

Códigos de error

Código	Significado
400	Bad Request. La solicitud está mal formada o tiene parámetros no válidos. También se devuelve cuando no se ha podido scrapear la URL de destino.
401	Unauthorized. Falta la clave de API, no es válida, o se ha superado la cuota de créditos.
403	Forbidden. Tu plan no incluye esta función (por ejemplo, renderizado de JavaScript o geolocalización específica por país). Mejora tu suscripción para poder usarla.
406	Not Acceptable. El formato de respuesta solicitado no es compatible.
422	Unprocessable Entity. La solicitud era válida pero no se pudo completar. Causas habituales: el sitio de destino devolvió un CAPTCHA con un 200 OK, el HTML de la respuesta está vacío, un perfil de Instagram devolvió la página de inicio de sesión, o un selector wait_for_css nunca llegó a aparecer.
429	Too Many Requests. Estás enviando solicitudes demasiado rápido o ejecutando demasiadas en paralelo. Google también puede devolver este código cuando detecta el scraper.
500	Internal Server Error. Algo ha fallado por nuestra parte. Vuelve a intentarlo en breve.
503	Service Unavailable. La API está temporalmente fuera de servicio por mantenimiento. Vuelve a intentarlo más tarde.

Semántica de reintentos

Nota

Las respuestas 422 y 5xx se pueden reintentar de forma segura tras una breve espera progresiva. Las respuestas 4xx distintas de 429 suelen indicar un problema del lado del cliente que reintentar no solucionará.

• Reintenta 500 y 503 con espera progresiva exponencial (por ejemplo, 1s, 2s, 4s).
• Reintenta 429 tras una pausa, y reduce la concurrencia de solicitudes.
• No reintentes 400, 401, 403 ni 406 sin modificar la solicitud.

Ver también

• Web Scraping API - punto central del endpoint
• Solicitud básica - ejemplo de llamada mínima