Skip to main content
Gologin Cloud Browser lets you run a browser session in the cloud and control it from your automation tool (Puppeteer / Playwright) using a single connection URL.

​
Connection URL

Use this URL in your automation library as a remote browser endpoint: 
https://cloudbrowser.gologin.com/connect?token=${token}&profile=${profileId}
  • token — your Gologin dev token.
  • profile — profile ID (optional):
    • if provided, Gologin will run this profile in the cloud;
    • if omitted, Gologin will create a new profile for the session.
Note: This URL is used as a WebSocket connection endpoint by automation libraries (for example browserWSEndpoint in Puppeteer).
Generate your token in the GoLogin dashboard: Personal Area → API Token.
Screenshotat Mar0514 27 28

​
Managing profiles (proxy, fingerprint, etc.)

Cloud Browser is only the connection layer (remote browser session).
To create/update profiles, attach proxies, configure fingerprint, tags, and other profile settings, use the Gologin REST API:

​
Examples

const puppeteer = require('puppeteer-core');

(async () => {
  // Your GoLogin dev token
  const token = 'your_token_here';
  
  // Optional: profileId (if you want to use an existing profile)
  const profileId = 'your_profile_id'; // Remove this line if you want to create a new profile
  
  // Construct the cloud browser URL
  const cloudBrowserUrl = `https://cloudbrowser.gologin.com/connect?token=${token}${profileId ? `&profile=${profileId}` : ''}`;
  
  // Connect to the browser
  const browser = await puppeteer.connect({
    browserWSEndpoint: cloudBrowserUrl,
    defaultViewport: null
  });
  
  // Create a new page
  const page = await browser.newPage();
  
  // Navigate to a website
  await page.goto('https://example.com');
  
  // Perform your automation tasks here
  const title = await page.title();
  console.log('Page title:', title);
  
  // Example: take a screenshot
  await page.screenshot({ path: 'screenshot.png' });
  
  // Close the browser when done
  await browser.close();
})();