> ## Documentation Index
> Fetch the complete documentation index at: https://gologin.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide

Ce guide vous permet de configurer et de commencer à utiliser l'API Gologin. Nous y verrons comment démarrer avec l'un de nos clients API et comment envoyer votre première requête. Nous vous indiquerons aussi où aller ensuite pour trouver toutes les informations dont vous avez besoin afin de tirer pleinement parti de notre puissante API REST.

> [!NOTE]
>
> Avant de pouvoir envoyer des requêtes à l'API Gologin, vous devez récupérer
> votre clé API depuis votre tableau de bord. Vous la trouverez sous [Paramètres » API](https://app.gologin.com/personalArea/TokenApi).

## Envoyer votre première requête de scraping anonyme

```js node.js theme={null}
import { GologinApi } from 'gologin';

// Token can be passed here in code or from env 
const token = process.env.GL_API_TOKEN || 'your dev token here';
const gologin = GologinApi({
  token,
  // If you want to run particular profile you need to pass profileId param
});

async function main() {
  // This line of code creates new profile that will be run. If you want to run existed profile - delete this line of code
  const profile = await gologin.createProfileRandomFingerprint();
  const profileId = profile.id;

  // This line of code adds gologin proxy to the profile.
  await gologin.addGologinProxyToProfile(profileId, 'US');

  // This line of code starts the browser and return object that can be managed by puppeteer
  const { browser } = await gologin.launch({ profileId });

  // Opens new page in browser
  const page = await browser.newPage();

  // Goes to website and waits untill all parts of the website is loaded
  await page.goto('https://iphey.com/', { waitUntil: 'networkidle2' });

  // Reads profile check result in website
  const status = await page.$eval('.trustworthy:not(.hide)',
    (elt) => elt?.innerText?.trim(),
  );

  await new Promise((resolve) => setTimeout(resolve, 10000));
  console.log('status', status);

  // This line of code deletes used profile. If you dont want to delete used profie - remove this line
  await gologin.deleteProfile(profileId);

  return status;
}

main().catch(console.error)
  .finally(gologin.exit);
```

```python Python theme={null}
import time
import os
from gologin import GoLogin
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager


# Initialize GoLogin
gl = GoLogin({
	"token": os.environ.get('GL_API_TOKEN', 'your dev token'),
	})
profile = gl.createProfileRandomFingerprint({ "os": "win" })
profile_id = profile.get('id')
gl.setProfileId(profile_id)
# Add proxy to the profile
gl.addGologinProxyToProfile(profile_id, "us")

# Start Browser and get websocket url
debugger_address = gl.start()

# Get Chromium version for webdriver
chromium_version = gl.get_chromium_version()


# Install webdriver
service = Service(ChromeDriverManager(driver_version=chromium_version).install())

chrome_options = webdriver.ChromeOptions()
chrome_options.add_experimental_option("debuggerAddress", debugger_address)

driver = webdriver.Chrome(service=service, options=chrome_options)

# Give command to Selenium to open the page
driver.get("http://www.python.org")

time.sleep(30)
driver.quit()
time.sleep(10)

gl.delete(profile_id)

gl.stop()
```

## Exécuter le code vous-même avec Node.js

```bash bash theme={null}
# Install required packages
npm i gologin

# Run the code - change filename.js to your actual filename and add your token
GL_API_TOKEN=[YOUR_GOLOGIN_API_TOKEN] node filename.js
```

## Exécuter le code vous-même avec Python

```bash bash theme={null}
# create local env for the project
python3 -m venv venv

# Install required packages
source venv/bin/activate && pip install gologin selenium webdriver-manager

# Run the script. Your file should not be named gologin.py as it will cause conflict with import
GL_API_TOKEN=[YOUR_GOLOGIN_API_TOKEN] python3 filename.py
```

## Et ensuite ?

Parfait, votre client API est configuré et vous avez envoyé votre première requête à l'API. Voici quelques liens qui pourront vous être utiles pour aller plus loin avec l'API Gologin :

* [Récupérez votre clé API dans Paramètres > API](https://app.gologin.com/personalArea/TokenApi)
* [Gologin Web Access CLI](https://gologin.com/docs/fr/cli-tools/web-access.md) : une CLI unifiée pour le scraping et l'automatisation du navigateur (aucun code nécessaire)
* [Agent Browser CLI](https://gologin.com/docs/fr/cli-tools/agent-browser.md) : une CLI de navigateur cloud conçue pour les agents IA
* [Local Agent Browser CLI](https://gologin.com/docs/fr/cli-tools/local-agent-browser.md) : une CLI Orbita locale avec profils et runbooks
* [AI Skills](https://gologin.com/docs/fr/api-reference/ai-integrations/ai-skills.md) : des skills prêts à l'emploi pour Claude Code
* [MCP Server](https://gologin.com/docs/fr/api-reference/ai-integrations/mcp-server.md) : gérez vos profils via des conversations avec l'IA


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.