Comenzando
Obtén tu clave API
Accede al panel de control de Scraping Browser y obtén tu clave API en la pestaña de configuración. Usaremos esta clave API en los siguientes pasos.
Parámetros
| Nombre del Parámetro | Tipo | Descripción |
|---|---|---|
| token | string | La clave API generada en el panel de control. |
| sessionTTL | number | Controla la duración de la sesión y cierra automáticamente la instancia del navegador después del tiempo de espera. Medido en segundos (s), por defecto es 180 segundos (3 minutos), personalizable entre 60 segundos (1 minuto) y 900 segundos (máximo recomendado 15 minutos, pero se pueden establecer tiempos más largos). Una vez que se alcanza el TTL especificado, la sesión expirará y Scraping Browser cerrará la instancia del navegador para liberar recursos. |
| sessionName | string | Establece un nombre para tu sesión para facilitar la búsqueda y visualización en la lista de sesiones históricas. |
| sessionRecording | boolean | Si habilitar la grabación de la sesión. Cuando está habilitado, todo el proceso de ejecución de la sesión del navegador se grabará automáticamente, y después de que la sesión se complete, se puede reproducir y ver en los detalles de la lista de sesiones históricas. Por defecto es falso. |
| proxyURL | string | Se utiliza para establecer la URL del proxy del navegador, por ejemplo: http://user:pass@ip:port. Si se establece este parámetro, se ignorarán todos los demás parámetros proxy_*.- 💡La funcionalidad de proxy personalizado actualmente solo está disponible para usuarios de suscripción Enterprise y Enterprise Enhanced Actualiza ahora - 💡Los usuarios personalizados a nivel Enterprise pueden contactarnos para usar proxies personalizados. |
| proxyCountry | string | Especifica el país/región objetivo para el enrutamiento del proxy, dirigiendo las solicitudes a través de direcciones IP de la ubicación seleccionada. Acepta códigos de país ISO (por ejemplo, US para Estados Unidos, GB para Reino Unido, ANY para selección aleatoria). Soporta más de 195 países y territorios. Cuando se combina con proxyState y proxyCity, permite un enrutamiento geográfico preciso hasta el nivel de ciudad. |
| proxyState | string | (Opcional) Especifica el estado/provincia objetivo dentro del país seleccionado para un enrutamiento de proxy más granular. Debe usarse junto con proxyCountry. Acepta códigos de estado (por ejemplo, CA para California, NY para Nueva York). Disponible para países seleccionados con divisiones definidas de estado/provincia. aprende más |
| proxyCity | string | (Opcional) Especifica la ciudad objetivo dentro del estado/provincia seleccionado para el enrutamiento de proxy a nivel de ciudad. Debe usarse junto con proxyCountry y proxyState. Proporciona el enrutamiento geográfico más preciso. La disponibilidad depende de la infraestructura de proxy en ciudades específicas. aprende más |
| extensionIds | string | configura la extensión del navegador por ID de extensión, separa por comas para múltiples extensiones |
| fingerprint | string | Una huella digital del navegador es una “huella digital” digital casi única creada utilizando la información de configuración de tu navegador y dispositivo, que se puede utilizar para rastrear tu actividad en línea incluso sin cookies. Afortunadamente, configurar huellas digitales en Scraping Browser es opcional. Ofrecemos una personalización profunda de las huellas digitales del navegador, como parámetros centrales como el agente de usuario del navegador, la zona horaria, el idioma y la resolución de pantalla, y soportamos la extensión de funcionalidad a través de parámetros de lanzamiento personalizados. Adecuado para la gestión de múltiples cuentas, la recopilación de datos y escenarios de protección de la privacidad, utilizando el propio navegador Chromium de scrapeless se evita completamente la detección. Por defecto, nuestro servicio de Scraping Browser genera una huella digital aleatoria para cada sesión. Referencia |
Ejemplo de una URL de conexión WebSocket completa de Scraping Browser:
wss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyCountry=ANYwss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyCountry=US&proxyState=CA&proxyCity=Los%20Angeleswss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyURL=proxyURLNota: Cuando se especifica proxyURL, tiene prioridad y se ignorarán otros parámetros relacionados con el proxy (proxyCountry, proxyState, proxyCity). Los parámetros de proxy geográfico deben usarse juntos: proxyState requiere proxyCountry, y proxyCity requiere tanto proxyCountry como proxyState.