Obter chave de API

API de navegador headless que os sites veem como Chrome completo

Mude uma linha: launch vira connect. Seu código Puppeteer, Playwright ou Python roda igual, e cada página tem Chrome completo, dispositivo real e IP residencial. Sem Docker, sem patches no Chrome, sem teto de 15 minutos.

Comece grátis, sem cartão. Tráfego residencial a $1/GB.

4.7 / 5 no G2de 79 avaliações

Conecte Puppeteer ou Playwright à API de navegador headless com uma linha

Tudo depois da linha de conexão é o código que você roda hoje no Chrome headless local. Adicione seu token e o ID do perfil, e o script salva uma captura de tela da página inteira, um PDF e o HTML da página.

  1. Passo 01

    Obtenha seu token

    Cadastre-se com o Google e copie sua chave no painel. Grátis, sem cartão.

  2. Passo 02

    Crie um perfil

    Um clique no painel ou uma chamada de API. Escolha o país do IP: o perfil mantém esse dispositivo, IP e login em cada execução.

  3. Passo 03

    Rode o script

    Instale a biblioteca e rode o script abaixo com seu token e o ID do perfil. Ele salva page.png e page.pdf ao lado do script e imprime o título da página. Mais no guia de primeiros passos.

Instalar
npm install playwright-core
Executar
GOLOGIN_TOKEN=your_token GOLOGIN_PROFILE_ID=your_profile_id node page.mjs
Conecta a
wss://cloudbrowser.gologin.com/connect?token=…&profile=…
import { chromium } from "playwright-core";

const token = process.env.GOLOGIN_TOKEN;
const profileId = process.env.GOLOGIN_PROFILE_ID;
const endpoint = `wss://cloudbrowser.gologin.com/connect?token=${token}&profile=${profileId}`;

const browser = await chromium.connectOverCDP(endpoint);
const page = await browser.contexts()[0].newPage();

await page.goto("https://books.toscrape.com/");

const html = await page.content();
await page.screenshot({ path: "page.png", fullPage: true });
await page.pdf({ path: "page.pdf" });

console.log(await page.title(), html.length);

await page.close();
await browser.close();

Veja o que a página vê: Chrome headless no seu servidor vs Gologin

Mesmo script, mesma página, dois navegadores. O Chrome headless local avisa à página que é headless antes do seu primeiro clique. O Gologin Cloud Browser mostra um Chrome completo em um Mac real e um IP residencial, com o fuso horário correspondente.

O que a página lêChrome headlessGologin
Nome do navegadorHeadlessChromeChrome
GráficosSwiftShader, por softwareIntel HD Graphics 6000
Plugins05
Tela1280 x 720, o padrão1470 x 956, um notebook real
IPSeu servidor, um datacenterResidencial, Michigan
Fuso horárioO do seu servidorDetroit, igual ao IP
PareceUm servidor num datacenterUm MacBook na rede de casa

Faça login uma vez, não em cada execução headless

Nenhum arquivo storageState para salvar, carregar e perder. Cookies, dispositivo e IP residencial voltam juntos, então a execução 40 abre o mesmo navegador logado da execução 1.

Segunda-feiraexecução 1Login feito

O script faz login uma vez, você digita o código de verificação no Live View e o perfil é salvo.

cookiesdispositivoendereçosalvo
Sexta-feiraexecução 2Continua logado

Mesmo dispositivo, mesmo IP, mesma conta. Nenhuma tela de login, então o script vai direto ao trabalho.

sessão restaurada
Mês que vemexecução 40Ainda o mesmo usuário

Nada mudou: uma conta em um único dispositivo o tempo todo, então o site não tem nada de novo para verificar.

sessão restaurada

Quer entender como funciona? Leia como conectar um perfil e depois crie o seu primeiro.

Compare APIs de navegador headless: preço, IP e duração da sessão

Browserless, Browserbase e Steel rodam o Chrome para o seu script. O Gologin tem a hora mais barata, tráfego residencial a $1/GB em vez de $8-12 e nenhum teto para a duração de uma sessão.

Preço da hora de navegador, tráfego residencial, IP, login salvo e duração da sessão no Gologin Cloud Browser, Browserless, Browserbase e Steel
O que você recebeGologinBrowserlessBrowserbaseSteel
Hora de navegador, primeiro plano pago$0.09$0.15$0.12$0.10
Tráfego residencial$1/GB$8-12/GB$12/GB$10/GB
Mesmo IP na próxima execuçãoSimNão publicadoNão publicadoAdd-on pago
Login mantido para a próxima execuçãoSimAté 7 diasSimSim, 30 dias sem uso
Sessão mais longa, primeiro plano pagoSem limite15 minutos6 horas15 minutos

Só precisa do HTML de uma página, não de um navegador? O Web Unlocker o retorna em uma requisição e cobra só quando dá certo.

Acompanhe a automação de navegador headless ao vivo, ou conclua uma etapa manualmente

Headless até você precisar ver. Toda sessão tem um link de Live View: abra-o, veja a página em que o script está, digite um código, feche a aba, e a execução continua.

  • Depure sem headless: false

    Sem janela local, sem capturas de tela em loop. Abra a sessão ao vivo e veja o script clicar.

  • Passe o controle pelo seu código

    Assumir o controle é uma chamada de API. A qualquer momento, em qualquer sessão ao vivo, sem reiniciar e sem segundo login.

  • Coloque no seu próprio produto

    Incorpore a sessão ao vivo no seu painel, para que seus usuários concluam uma etapa no mesmo navegador logado.

Vai integrar isso? Leia a documentação do Live View ou veja Cloud Browser UI.

Elimine os servidores de navegador do seu stack

O que você deixa de manter quando o navegador por trás do seu script roda no Gologin.

Preços da API de navegador headless

Todos os planos rodam o mesmo Chrome completo. O Business custa $8 por mês para 100 horas de navegador; os planos diferem em horas e sessões paralelas. O tráfego residencial custa $1/GB.

Precisa de mais ao mesmo tempo? Adicione sessões paralelas a qualquer plano por $2 por mês cada, quantas precisar. O tráfego residencial custa $1/GB.

Custom

A partir de 4 sessões paralelas, com gerente de conta dedicado, SLA premium e onboarding sob medida.

Agendar demo

Parte de um stack tecnológico completo

Uma conta, uma rede de proxies, um ecossistema. Escolha o produto de que a tarefa precisa.

Não sabe de qual sua tarefa precisa? Agende uma demo e escolhemos com você.

Perguntas sobre API de navegador headless

O que é uma API de navegador headless?

Uma API de navegador headless é um navegador que roda em um servidor e recebe ordens do seu código em vez de uma janela. Seu script abre páginas, clica, as lê e salva capturas de tela, PDFs ou HTML. O Gologin Cloud Browser fala o Chrome DevTools Protocol, então Puppeteer e Playwright se conectam a ele como se conectariam a um Chrome local.

O Gologin Cloud Browser é headless?

Para o seu script, sim: nenhuma janela na sua máquina e nada para instalar além da biblioteca. Do nosso lado, ele roda um Chrome completo com impressão digital de dispositivo real, então as páginas são renderizadas como para uma pessoa. Para acompanhar uma execução, abra o link de Live View dela.

O que é navegador como serviço (browser as a service)?

Navegador como serviço significa que outra empresa hospeda os navegadores e você os aluga por hora ou por requisição. Com o Gologin você aluga horas de navegador, o tráfego residencial custa $1/GB e cada perfil mantém seu próprio dispositivo, cookies e IP entre as execuções.

Posso tirar capturas de tela e gerar PDFs?

Sim. page.screenshot() e page.pdf() funcionam como localmente, e os scripts acima salvam os dois. Não há um endpoint separado para isso: tudo passa pelo Puppeteer ou pelo Playwright.

Existe uma API REST?

O Cloud Browser é controlado por um WebSocket, com Puppeteer ou Playwright; perfis e proxies são gerenciados pela API REST do Gologin. Se você só precisa do HTML de uma página a partir de uma URL, o Web Unlocker é uma única requisição HTTP.

Quais linguagens e bibliotecas funcionam?

Node.js com Puppeteer ou Playwright, e Python com Playwright. Qualquer coisa que fale o Chrome DevTools Protocol se conecta ao mesmo endereço wss://. Veja Playwright & Puppeteer.

Existe uma API de navegador headless gratuita?

Sim. Cadastre-se com o Google e você recebe uma chave de API na hora: 3 execuções de até 15 minutos cada em 1 sessão paralela, sem cartão.

Quantos navegadores posso rodar ao mesmo tempo?

Um no plano gratuito e no Professional, 2 no Business, 3 no Enterprise, a partir de 4 no Custom. Adicione mais a qualquer plano por $2 por mês cada.

Com que rapidez uma sessão inicia?

O primeiro início de um perfil novo leva alguns segundos, enquanto o navegador dele é preparado. Depois disso, uma sessão se conecta em 1-2 segundos, sem um pool de navegadores aquecidos para manter rodando.

Posso enviar e baixar arquivos?

Uploads funcionam com setInputFiles, como localmente. Para salvar um arquivo, busque-o de dentro da página e grave os bytes do seu lado: a requisição sai do mesmo navegador e do mesmo IP residencial do resto da execução.

Posso desenvolver localmente e rodar na nuvem?

Sim. Mantenha chromium.launch() no seu notebook e troque para a linha de conexão quando o script for para um servidor ou passar a rodar agendado. Suítes de teste se conectam do mesmo jeito: veja Playwright & Puppeteer para uma fixture do Playwright Test.

De quais países o IP pode vir?

Escolha o país ao criar o perfil. IPs residenciais e móveis vêm do Gologin Proxies em 195+ países, ou use seu próprio proxy.

O Gologin é uma alternativa ao Browserless ou ao Browserbase?

Sim, para scripts Puppeteer e Playwright: mude a linha de conexão e mantenha o resto. Você paga por hora de navegador a partir de $4.50 por mês, o tráfego residencial custa $1/GB e um perfil mantém o mesmo IP e o mesmo login na próxima execução. Endpoints prontos como /pdf e /screenshot não têm equivalente aqui: você chama as mesmas funções do seu script.

Pare de hospedar o Chrome para os seus scripts.

Uma linha conecta Puppeteer ou Playwright ao Gologin Cloud Browser: capturas de tela, PDFs e HTML de um Chrome completo com IP residencial, a partir de $4.50 por mês.

Comece grátis, sem cartão. Tráfego residencial a $1/GB.

4.7 / 5 no G2de 79 avaliações