Solicitud API

Para extraer datos de una página web, envía una solicitud GET al endpoint base de la Web Scraping API con tu api_key y la url de destino. Parámetros opcionales adicionales te permiten controlar el renderizado, el tipo de proxy, la geolocalización, los tiempos de espera y más.

Endpoint

GET https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=<TARGET_URL>

Parámetros

Parámetro	Tipo	Obligatorio	Descripción
api_key	string	sí	Tu clave de acceso a la Web Scraping API. Se encuentra en el panel de control de tu cuenta.
url	string	sí	La URL de destino de la que extraer datos.
render_js	integer	no	0 (por defecto) o 1. Activa el renderizado de JavaScript mediante un navegador headless. Cuesta 5 llamadas a la API para datacenter y 25 para residential.
proxy_type	string	no	datacenter (por defecto) o residential. Residential cuesta 10 llamadas sin renderizado de JS y 25 con él.
country	string	no	Código de país de 2 letras para la geolocalización del proxy. La lista admitida depende del tipo de proxy.
keep_headers	integer	no	1 para pasar tus propias cabeceras de solicitud personalizadas, 0 para usar solo las que especifiques.
session	integer	no	Reutiliza la misma IP de proxy en varias solicitudes reutilizando el mismo número de sesión. Caduca 5 minutos después del último uso.
timeout	integer	no	Tiempo máximo de solicitud en milisegundos. Máximo 60000. La API devuelve el HTML que se haya obtenido antes de que se agote el tiempo de espera.
device	string	no	desktop (por defecto), mobile o tablet.
wait_until	string	no	Avanzado. Condición para determinar cuándo se considera completado el renderizado. Requiere render_js=1.
wait_for	integer	no	Avanzado. Milisegundos de espera tras la carga de la página. Se recomienda 5000-10000. Requiere render_js=1.
wait_for_css	string	no	Avanzado. Espera hasta 10 segundos a que aparezca un selector CSS. Requiere render_js=1.
screenshot	integer	no	Avanzado. Establécelo en 1 para devolver una captura de pantalla. Requiere render_js=1.
screenshot_options	object	no	Avanzado. Controla las dimensiones de la captura de pantalla y full_page.
extract_rules	string	no	Avanzado. JSON codificado en URL que describe las reglas de extracción CSS.
disable_stealth	integer	no	Avanzado. Establécelo en 1 para desactivar el plugin stealth predeterminado. Requiere render_js=1.
auto_parser	integer	no	Avanzado. Establécelo en 1 para devolver JSON analizado en lugar de HTML.
js_instructions	string	no	Avanzado. Array JSON codificado en URL de acciones que se ejecutan antes de la extracción. Requiere render_js=1.
binary_response	integer	no	Establécelo en 1 para devolver un archivo binario codificado en base64 (para PDFs, imágenes, etc.).

Ejemplo de solicitud

curl

curl "https://scrape.shifter.io/v1?api_key=YOUR_API_KEY&url=https://httpbin.org/get"

Python

import requests

r = requests.get("https://scrape.shifter.io/v1", params={
    "api_key": "YOUR_API_KEY",
    "url": "https://httpbin.org/get",
})
print(r.text)

Node.js

import fetch from 'node-fetch';

const url = 'https://scrape.shifter.io/v1?' + new URLSearchParams({
  api_key: 'YOUR_API_KEY',
  url: 'https://httpbin.org/get',
});
const res = await fetch(url);
console.log(await res.text());

Consulta también

• Solicitud básica - ejemplo mínimo
• Renderizado de JavaScript
• Proxies
• Errores de la API