API de Web Scraping
Un único endpoint para todas las páginas. La API de scraping gestiona la rotación de proxies, Chrome headless, la ejecución de JavaScript, la resolución de CAPTCHA y los reintentos automáticos.
Endpoint
Sección titulada «Endpoint» GET https://scrape.shifter.io/v1
También se admiten las variantes POST y PUT; consulta solicitudes POST y solicitudes PUT.
Autenticación
Sección titulada «Autenticación»Pasa tu clave de API como el parámetro de consulta api_key en cada solicitud. Las claves se gestionan en el panel en Web Scraping API → API Keys.
curl "https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=https://example.com"Parámetros principales
Sección titulada «Parámetros principales»| Parameter | Type | Required | Description |
|---|---|---|---|
api_key | string | yes | Tu clave de API |
url | string | yes | La URL que se va a obtener |
render_js | 0 | 1 | no | Habilita la renderización con Chrome headless |
premium_proxy | 0 | 1 | no | Enruta a través de IPs residenciales (Growth+) |
mobile_proxy | 0 | 1 | no | Enruta a través de IPs móviles (Growth+) |
country | ISO code | no | País para la geolocalización del proxy |
device | desktop | mobile | tablet | no | Dispositivo simulado |
session_id | string | no | Reutiliza cookies y proxy entre solicitudes |
timeout | ms | no | Tiempo máximo que puede emplear el navegador, hasta 60000 |
wait_for | ms | no | Espera de inactividad tras la navegación (se recomienda 5000-10000) |
wait_for_css | selector | no | Bloquea hasta que aparezca el selector CSS |
wait_until | string | no | Condición de espera de navegación (avanzado) |
keep_headers | 0 | 1 | no | Reenvía cabeceras personalizadas al destino |
custom_headers | JSON | no | Cabeceras de solicitud personalizadas (codificadas en URL) |
custom_cookies | string | no | Valor de la cabecera Cookie |
extract_rules | JSON | no | Selectores CSS para convertir en JSON estructurado |
auto_parser | 0 | 1 | no | Analiza automáticamente las respuestas JSON |
screenshot | 0 | 1 | no | Devuelve un PNG en lugar de HTML |
screenshot_options | JSON | no | Tamaño de la captura y selector |
binary_response | 0 | 1 | no | Transmite datos binarios (PDFs, imágenes) |
js_instructions | JSON | no | Ejecuta desplazamiento/clic/espera antes de la captura |
disable_stealth | 0 | 1 | no | Desactiva el complemento stealth |
webhook | URL | no | Envía la respuesta mediante POST a esta URL cuando esté lista |
forward_proxy | URL | no | Encadena a través de tu proxy ascendente |
Todos los parámetros que esperan JSON deben estar codificados en URL.
Ejemplo rápido
Sección titulada «Ejemplo rápido»curl "https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=https://example.com&render_js=1&wait_for_css=h1"Páginas del endpoint
Sección titulada «Páginas del endpoint» Solicitud básica Minimal GET with api_key and url.
Parámetros completos Every parameter documented in detail.
Solicitudes POST Scrape URLs that require POST bodies.
Solicitudes PUT Scrape PUT endpoints.
Renderización de JavaScript render_js flag and limits.
Instrucciones de JavaScript Scroll, click, wait before capture.
Esperar por CSS wait_for_css selector syntax.
Forzar tiempos de espera Cap browser time with timeout.
Captura de pantalla Capture full-page or element PNG.
Sesiones Hold cookies and IP across requests.
Archivos binarios Download PDFs, images, other binaries.
Cabeceras personalizadas Forward headers to the target.
Cookies personalizadas Inject cookies into the request.
Proxies Datacenter vs residential vs mobile.
Geolocalización country parameter and supported locations.
Reglas de extracción Return parsed JSON.
Analizador automático de JSON auto_parser for JSON endpoints.
Errores de la API Status codes and retry semantics.