pygologin - GoLogin Python SDK
This package provides functionality to run and stop GoLogin profiles with python and then connect the profiles to automation tools like Selenium, Puppetteer, Playwright etc.
How does it work?
- You give SDK your dev token and profile id that you want to run
- SDK takes care of downloading, preparing your profile and starts the browser
- SDK gives you websocket url for automation tools
- You take this websocker url and connect it to the automation tool on your choice: Puppetteer, Selenium, Playwright etc
- Automation tool connects to browser and you can manage it through code
Getting Started
Where is token? API token is here.
Installation
pip3 install gologin
for base case - we use selenium as it is the most popular tool
pip3 install -r requirements.txt
Example "gologin-selenium.py"
import time
from gologin import GoLogin
from selenium import webdriver
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager
profile_id = "Your profile id"
# Initialize GoLogin
gl = GoLogin({
"token": "Your token",
"profile_id": profile_id
})
# Start Browser and get websocket url
debugger_address = gl.start()
# Get Chromium version for webdriver
chromium_version = gl.get_chromium_version()
# Add proxy to profile
gl.addGologinProxyToProfile(profile_id, "us")
# 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.stop()
Running example:
python gologin-selenium_4_11.py
Methods
constructor - initiate your token, profile that you want to run and browser params
Required options:
token<[string]> Required - your API tokenprofile_id<[string]> Required - profile ID (NOT PROFILE NAME)
Optional options:
executablePath<[string]> path to executable Orbita file. Orbita will be downloaded automatically if not specifiedextra_paramsarrayof <[string]> additional flags for browser start. For example: '--headles', '--load-extentions=path/to/extension'uploadCookiesToServer<[boolean]> upload cookies to server after profile stopping (default false). It allows you to export cookies from api later.writeCookesFromServer<[boolean]> if you have predefined cookies and you want browser to import it (default true).
gl = GoLogin({
"token": "your token",
"profile_id": "your profile id",
"extra_params": ["--headless", "--load-extentions=path/to/extension"]
})
createProfileRandomFingerprint - you pass os ('lin', 'win', 'mac') and profile name and we give you brand new shiny profile
gl = GoLogin({
"token": "your token",
})
profile = gl.createProfileRandomFingerprint({"os": "lin", "name": "some name"})
gl.setProfileId(profile['id'])
createProfileWithCustomParams - This method creates a profile and you can pass any particular params to it. Full list of params you can find here - https://api.gologin.com/docs
gl = GoLogin({
"token": "your token",
})
profile = gl.createProfileWithCustomParams({
"os": "lin",
"name": "some name",
"navigator": {
"userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36",
"resolution": "1920x1080",
"language": "en-US",
"platform": "Linux x86_64",
"hardwareConcurrency": 8,
"deviceMemory": 8,
"maxTouchPoints": 0
}
})
gl.setProfileId(profile['id'])
updateUserAgentToLatestBrowser - user agent is one of the most important thing in your fingerprint. It decides which browser version to run. This method help you to keep useragent up to date.
gl = GoLogin({
"token": "your token",
})
gl.updateUserAgentToLatestBrowser(["profineId1", "profileId2"], "workspceId(optional)")
addGologinProxyToProfile - Gologin provides high quality proxies with free traffic for paid users. Here you can add gologin proxy to profile, just pass country code
gl = GoLogin({
"token": "your token",
})
gl.addGologinProxyToProfile("profileId", "us")
addCookiesToProfile - You can pass cookies to the profile and browser will import it before starting
gl = GoLogin({
"token": "your token",
})
gl.addCookiesToProfile("profileId", [
{
"name": "session_id",
"value": "abc123",
"domain": "example.com",
"path": "/",
"expirationDate": 1719161018.307793,
"httpOnly": True,
"secure": True
},
{
"name": "user_preferences",
"value": "dark_mode",
"domain": "example.com",
"path": "/settings",
"sameSite": "lax"
}
])
refreshProfilesFingerprint - Replaces your profile fingerprint with a new one
gl = GoLogin({
"token": "your token",
})
gl.refreshProfilesFingerprint(["profileId1", "profileId2"])
changeProfileProxy - allows you to set a proxy to a profile
gl = GoLogin({
"token": "your token",
})
gl.changeProfileProxy("profileId", { "mode": "http", "host": "somehost.com", "port": 109, "username": "someusername", "password": "somepassword"})
start() - prepares profile, starts browser and returns websocket url
gl = GoLogin({
"token": "your token",
"profile_id": "some_profile_id"
})
wsUrl = gl.start()
start browser with profile id
stop() - stops browser, saves profile and upload it to the storage
gl = GoLogin({
"token": "your token",
"profile_id": "some_profile_id"
})
wsUrl = gl.start()
gl.stop()
Full GoLogin API
Swagger: link here
Postman: link here
1 maintainer
Metadata
1 maintainer
Release files for gologin 2025.4.22172740
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| gologin-2025.4.22172740.tar.gz | 25.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| gologin-2025.4.22172740-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 57.9 kB
Release files / gologin-2025.4.22172740.tar.gz
| Download URL | gologin-2025.4.22172740.tar.gz |
|---|---|
| Size | 25.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
53873a4a864d6963c9c4e5dc3c7646fa09ecef4113dcd52400a3324bba060870
|
|
BLAKE2b-256 checksum How to use checksums |
36c9c5ac494d3ac7d9f13b58032770abf110765c6c91c73b81b951b233f7cf4d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.0
|
Release files / gologin-2025.4.22172740-py3-none-any.whl
| Download URL | gologin-2025.4.22172740-py3-none-any.whl |
|---|---|
| Size | 32.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
190f27a367ff31849aebf6e7f8ad8374f8d66aaed364597c8257149ff9e4bd4a
|
|
BLAKE2b-256 checksum How to use checksums |
ac81245375d4067033454b013cd188f6ec7b73acee0bd0a93fbe7fc0ad24dc3f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.0
|
