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

# Quickstart

## ⚡ Quick Start Guide

Welcome to **SESSION GENERATOR**. To start registering accounts, you only need to integrate our API into your script. Below is a simple example of how to fetch a validated session and prepare for registration.

### 1. Prerequisites

* **API Key:** Get your key from the [Dashboard](https://session-generator.com/).
* **Top up** your balance in cryptocurrency
* **Captcha Provider:** You will need an API key from services like *2Captcha* or *Capsolver*.

### 2. Implementation Example (Python)

This script demonstrates how to get a session from our pool and use its data (cookies, tokens, and fingerprints).

```python theme={null}
import requests

BASE_URL = "https://api.session-generator.com/api/v1"
API_KEY = "API_KEY"

headers = {
    "SESSION-GEN-API-Key": API_KEY
}

def check_balance():
    print("--- Checking the balance ---")
    response = requests.get(f"{BASE_URL}/balance", headers=headers)
    print(f"Status: {response.status_code}")
    print(f"Response: {response.json()}\n")

def buy_sessions(count: int):
    print(f"--- Buying sessions ({count}) ---")
    params = {"count": count}
    response = requests.get(f"{BASE_URL}/get-sessions", headers=headers, params=params)
    print(f"Status: {response.status_code}")
    print(f"Response: {response.json()}\n")

if __name__ == "__main__":
    check_balance()
    buy_sessions(1)
```

### 3. Core API Logic

* **Request:** Your script calls our `/get-sessions` endpoint.
* **Delivery:** We return a fresh session with a valid

  ```
  castle_token
  cookie
  guest_token
  flow_token
  funcaptcha_blob
  js_fingerprint
  ```
* **Registration:** You send these parameters along with the solved captcha directly to Twitter's registration endpoints.
* **Success**

<CardGroup cols={2} />

<Note>
  **⚠️ Session Lifespan:** Use them immediately after fetching from the API.
</Note>