Primeiros Passos
Obtenha Sua Chave de API
Acesse o painel de controle do Scraping Browser e obtenha sua chave de API na aba de configurações. Usaremos esta chave de API nas próximas etapas.
Parâmetros
| Nome do Parâmetro | Tipo | Descrição |
|---|---|---|
| token | string | A chave de API gerada no painel de controle. |
| sessionTTL | number | Controla a duração da sessão e fecha automaticamente a instância do navegador após o tempo limite. Medido em segundos (s), o padrão é 180 segundos (3 minutos), personalizável entre 60 segundos (1 minuto) e 900 segundos (máximo recomendado de 15 minutos, mas tempos mais longos podem ser definidos). Uma vez atingido o TTL especificado, a sessão expirará e o Scraping Browser fechará a instância do navegador para liberar recursos. |
| sessionName | string | Defina um nome para sua sessão para facilitar a pesquisa e visualização na lista de sessões históricas. |
| sessionRecording | boolean | Se deve habilitar a gravação da sessão. Quando habilitado, todo o processo de execução da sessão do navegador será gravado automaticamente e, após a conclusão da sessão, poderá ser reproduzido e visualizado nos detalhes da lista de sessões históricas. O padrão é false. |
| proxyURL | string | Usado para definir a URL do proxy do navegador, por exemplo: http://user:pass@ip:port. Se este parâmetro for definido, todos os outros parâmetros proxy_* serão ignorados.💡A funcionalidade de proxy personalizado está atualmente disponível apenas para assinantes. Atualize aqui |
| proxyCountry | string | Especifica o país/região de destino para o roteamento de proxy, direcionando as solicitações através de endereços IP do local selecionado. Aceita códigos de país ISO (por exemplo, US para Estados Unidos, GB para Reino Unido, ANY para seleção aleatória). Suporta mais de 195 países e territórios. Quando combinado com proxyState e proxyCity, permite o direcionamento geográfico preciso até o nível da cidade. |
| proxyState | string | (Opcional) Especifica o estado/província de destino dentro do país selecionado para um roteamento de proxy mais granular. Deve ser usado em conjunto com proxyCountry. Aceita códigos de estado (por exemplo, CA para Califórnia, NY para Nova York). Disponível para países selecionados com divisões de estado/província definidas. saiba mais |
| proxyCity | string | (Opcional) Especifica a cidade de destino dentro do estado/província selecionado para roteamento de proxy em nível de cidade. Deve ser usado em conjunto com proxyCountry e proxyState. Fornece o direcionamento geográfico mais preciso. A disponibilidade depende da infraestrutura de proxy em cidades específicas. saiba mais |
| extensionIds | string | configura a extensão do navegador por ID de extensão, separada por vírgula para várias extensões |
| fingerprint | string | Uma impressão digital do navegador é uma “impressão digital digital” quase única criada usando as informações de configuração do seu navegador e dispositivo, que pode ser usada para rastrear sua atividade online mesmo sem cookies. Felizmente, configurar impressões digitais no Scraping Browser é opcional. Oferecemos personalização profunda de impressões digitais do navegador, como parâmetros principais como user agent do navegador, fuso horário, idioma e resolução de tela, e suporte à extensão da funcionalidade por meio de parâmetros de inicialização personalizados. Adequado para gerenciamento de várias contas, coleta de dados e cenários de proteção de privacidade, usando o próprio navegador Chromium do scrapeless evita completamente a detecção. Por padrão, nosso serviço Scraping Browser gera uma impressão digital aleatória para cada sessão. Referência |
Exemplo de uma URL de conexão WebSocket completa do 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: Quando proxyURL é especificado, ele tem precedência, e outros parâmetros relacionados a proxy (proxyCountry, proxyState, proxyCity) serão ignorados. Os parâmetros de proxy geográfico devem ser usados em conjunto: proxyState requer proxyCountry, e proxyCity requer ambos proxyCountry e proxyState.