Errores y límites

Créditos

Evento	¿Se cobra?
Solicitud exitosa (HTTP 200)	1 crédito
Éxito con renderizado activado (render_js=1)	1 crédito
Solicitud fallida (tiempos de espera, errores de conexión)	0 créditos
HTTP 4xx o 5xx del destino	0 créditos
Reintentos dentro de una misma llamada	Se cuentan como la única llamada principal

Solo se le factura por las respuestas que le llegan con un estado 2xx y un cuerpo no vacío.

Concurrencia

Plan	Máximo de solicitudes concurrentes
Starter	20
Growth	50
Business	100
Enterprise	500

Las solicitudes que superan el límite devuelven 429 Too Many Requests. Reduzca la frecuencia con un retardo exponencial y vuelva a intentarlo.

Códigos de error

Estado	Significado	Qué hacer
200	Éxito, cuerpo de respuesta adjunto	Procesar con normalidad
400	Solicitud incorrecta (parámetros malformados)	Corrija el parámetro extract_rules o url
401	api_key no válida o ausente	Compruebe la clave en el panel
403	El plan no permite esta función	Actualice de plan o elimine el indicador (por ejemplo, premium_proxy en Starter)
408	El sitio de destino agotó el tiempo de espera	Vuelva a intentarlo con un timeout= más alto, u opciones más simples
422	Fallo en el renderizado (fallo de JS, error de navegación)	Vuelva a intentarlo; compruebe que el sitio funciona en un navegador real
429	Límite de concurrencia superado	Reduzca la frecuencia y vuelva a intentarlo
500	Error interno de Shifter	Vuelva a intentarlo tras un breve retardo, o contacte con soporte si persiste
509	Créditos del plan agotados	Actualice de plan o espere al siguiente ciclo de facturación

Reintentos automáticos

Las solicitudes fallidas, los CAPTCHAs y los errores 5xx transitorios del destino se reintentan automáticamente (hasta 3 veces) con proxies diferentes antes de que el endpoint devuelva un error. No se le cobra por los reintentos.

Entrega mediante webhook

Para scrapings de larga duración, pase webhook=<URL> para que la respuesta se envíe mediante POST a su endpoint cuando esté lista:

curl "https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=https://example.com&webhook=https%3A%2F%2Fyour.app%2Fcallback"

Sigue pagando 1 crédito por cada entrega exitosa.

Monitorización

El uso de créditos en tiempo real y la tasa de errores están visibles en el panel en Web Scraping API → Usage.

Consejo

Implemente reintentos en su lado con retardo exponencial. Trate 500, 422 y 408 como reintentables; trate 400, 401, 403 como errores de configuración que no se corregirán por sí solos.

Siguiente

• Preguntas frecuentes, créditos, fallos, scripts personalizados, escalabilidad.
• Avanzado, encabezados, cookies, POST.