Octo Browser proxy setup: one profile, one IP

Every profile needs its own IP

Octo Browser gives each profile its own browser fingerprint. Without a proxy, every profile goes online through your computer's connection, so websites see them all on one IP.

The Octo Browser Proxy Manager only stores proxies you bought yourself. Buy the IP in Proxy302, save it there once, and every profile can pick it from a list.

Octo Browser supports HTTP, HTTPS, SOCKS5 and SSH. Its help docs recommend SOCKS5 or SSH, and Proxy302 static IPs can be set to SOCKS5.

The screenshots below come from the Octo Browser help docs.

• Octo Browser docs: The Proxy Manager
• Octo Browser docs: Adding Proxies in Bulk

• Sources:
• Octo Browser docs: Adding Proxies in Bulk
• Octo Browser docs: The Proxy Manager
• Octo Browser docs: Temporary proxies / VPNs
• Octo Browser docs: Types of Proxies

Five steps

1. Copy the connection details in Proxy302

   Open My assets in the Proxy302 console and click the IP for this profile. The tag next to Entry address shows its protocol, HTTP or SOCKS5. Below are the host, port, username and password, plus a host:port:user:pass button that copies all four as one line. Octo Browser reads that format.

   proxy302.com/libraryTap to view full size

2. Click New proxy / VPN in the Proxy Manager

   In Octo Browser, switch to the My proxies and VPNs tab at the top. That page is the Proxy Manager. Click the blue New proxy / VPN button at the top right. The count at the top left is saved proxies against your plan limit, for example 8 / 20000.

   Octo BrowserTap to view full size

3. Paste the line and check it

   In the window that opens, paste the line you copied into the Host field. Protocol, host, port, login and password split into their boxes. If the line has no protocol in front, make sure the dropdown on the left matches the protocol shown in My assets. Click Check proxy. A green Available with a flag means it works, a red Unavailable means it does not. Then click Confirm.

   Octo BrowserTap to view full size

4. Adding many at once: Bulk Add

   On the same page click Bulk Add and paste one proxy per line, written as socks5://host:port:login:password. That is the line you copied with the protocol and :// put in front. Fill in Proxy name prefix, for example US, and the saved names become US #1, US #2. A line in the wrong format gets an ERROR next to it.

   Octo BrowserTap to view full size

5. Pick the proxy in the profile

   Go back to the profile list and click the Proxy / VPN column of the profile. A profile with no proxy shows Direct. Click the saved proxy in the dropdown. Before you launch, you can also check its row in the Proxy Manager: the flag in the status column should be the country you bought.

   Octo BrowserTap to view full size

Which IP to buy

Shop, social and ad accounts that stay signed in for months: buy a static ISP IP, one per profile. It does not change during the term, and a 30-day or longer term is a dedicated IP.

Scraping, price checks or viewing pages from different regions in Octo Browser: use dynamic residential. It is billed by traffic, you choose the exit country, and the Premium line goes down to state and major city. The entry is proxy.proxy302.com, HTTP port 2222, SOCKS5 port 3333.

Extra credit on your first top-up

Sign up for Proxy302 through a partner link or an invite link and your first top-up within 120 days gets an extra 20%, up to US$50. The bonus goes into your wallet as its own entry once the top-up arrives.

• Browse all partner tools

Many profiles: what to know first

A single profile is set up as described above. This part only covers what you need when there are many profiles.

The lines from the list generator are dynamic. On the Budget line you set how long an IP holds, anywhere from 1 to 120 minutes (10, 30, 60 and 120 are presets, or enter your own). On the Premium line the IP usually stays the same while you keep using it (80 minutes unchanged in our test, with an occasional change after that) and changes after about 5–10 minutes idle. For accounts you stay logged into for months you need static IPs. Buy as many as you have profiles (up to 100 per purchase) and export them from My assets with Bulk export: Selected, then Download text .txt. The export has no protocol in front of each line, so add socks5:// before pasting into Octo (as in the Bulk Add step above).

From Russia, connect over SOCKS5, port 3333. An exit inside Russia exists only on dynamic residential proxies, and a city cannot be chosen.

• Sources:
• Proxy302 console: proxy list generator and Bulk export
• Octo Browser docs: Adding Proxies in Bulk
• Octo Browser docs: The Proxy Manager

A proxy list for many profiles

1. Make the list in Proxy302

   Open the purchase page for dynamic residential proxies. Next to the Quantity field click Open the proxy list generator. Pick the line and country, set IP mode to Keep the IP (every line gets its own session and its own IP) and the protocol to SOCKS5. Type the number of profiles in Lines (1 to 500), choose With protocol (URL) as the Format and click Generate N lines. Octo reads protocol://login:password@host:port, so nothing needs adding.

   proxy302.com/proxy-listTap to view full size

2. Copy or download the list

   Click Copy all (N) or Download .txt. Every line has the same host, port and password, and its own -session-... tail in the login. My assets gets one new entry.

   proxy302.com/proxy-listTap to view full size

3. Paste the list into Bulk Add

   In Octo Browser open My proxies and VPNs, click Bulk Add and paste the list. The Octo documentation says you can also drag a file with the list into this window, so the downloaded .txt works too. In Proxy name prefix type, for example, p302: the names become p302 #1, p302 #2.

4. Check them all at once

   In the Proxy Manager tick the new proxies and choose Check proxy from the bulk actions. The Octo documentation lists these bulk actions for selected proxies: delete, check, change the exit IP.

Change the proxy on existing profiles

1. Add the new proxies

   Make a new list in the generator, as many lines as there are profiles, and add it with Bulk Add as above.

2. One profile at a time: the Proxy / VPN column

   In the profile list click the Proxy / VPN column of the profile and pick the new proxy from the dropdown. The Octo documentation describes quick editing of a profile with a proxy picked from the list. It does not describe assigning a saved proxy to several profiles at once, so for dozens of profiles use the API below.

API: proxies from Proxy302, profiles in Octo Browser

1. A Proxy302 key

   In the console open API keys and click Create key. Requests to /open_api/v3 use Basic authentication: the key id and the secret. Creating credentials costs nothing; you pay for traffic while the proxy works.

   • Proxy302 open API documentation

2. An Octo Browser token

   In the Octo Browser app open the settings, the API section, and copy the token (the documentation writes the path as Settings → API). Requests go to https://app.octobrowser.net/api/v2/automation with the X-Octo-Api-Token header.

   • Octo Browser: API authentication

3. Create the proxies and the profiles

   The script in the first code block takes one set of credentials from Proxy302, makes N logins with a -session-... tail and for each one calls POST /proxies, then POST /profiles with proxy: {"uuid": ...}. A profile needs a title and fingerprint.os.

   • Octo Browser: profiles API
   • Octo Browser: proxies API

4. Change the proxy on existing profiles

   For existing profiles the script in the second code block creates a new proxy and sends PATCH /profiles/{uuid} with the proxy field. The documentation advises updating stopped profiles. The request limit is shared by the whole team: 50 a minute on Base, 100 on Team, 200 on Advanced, which is why the script pauses.

   • Octo Browser: rate limits

Script: N proxies and N profiles

import requests, secrets, string, time

KEY = ("KEY_ID", "KEY_SECRET")  # key from "API keys" in the Proxy302 console
COUNTRY_ID = 0  # country id: GET /open_api/v3/proxy/area/country
N = 20

# one set of credentials: dynamic SOCKS5
r = requests.post(
    "https://proxy302.com/open_api/v3/proxy/api/proxy/dynamic/traffic",
    auth=KEY,
    json={"s": 3, "protocol": "socks5", "country_id": COUNTRY_ID,
          "billing_mode": "prepaid_pool", "idempotency_key": "batch-0001"},
)
cred = r.json()["data"]  # username, password, host, port


# tail -session-<12 chars>: every line gets its own IP
def tail():
    return "".join(secrets.choice(string.ascii_letters + string.digits) for _ in range(12))


logins = [f"{cred['username']}-session-{tail()}" for _ in range(N)]

BASE = "https://app.octobrowser.net/api/v2/automation"
OCTO = {"X-Octo-Api-Token": "OCTO_API_TOKEN"}  # token from the Octo Browser settings

for i, login in enumerate(logins):
    proxy = requests.post(f"{BASE}/proxies", headers=OCTO, json={
        "type": "socks5", "host": cred["host"], "port": int(cred["port"]),
        "login": login, "password": cred["password"], "title": f"p302-{i + 1:02d}",
    }).json()["data"]
    requests.post(f"{BASE}/profiles", headers=OCTO, json={
        "title": f"acc-{i + 1:02d}", "fingerprint": {"os": "win"}, "proxy": {"uuid": proxy["uuid"]},
    })
    time.sleep(3)  # Base plan: 50 requests a minute for the whole team

A Python example. Put in your own country_id and platform; the script was not run against a live account.

• Sources:
• Proxy302 open API: buying a dynamic proxy
• Octo Browser: profiles API
• Octo Browser: proxies API
• Octo Browser: rate limits

Script: new proxies for existing profiles

import requests, secrets, string, time

KEY = ("KEY_ID", "KEY_SECRET")  # key from "API keys" in the Proxy302 console
COUNTRY_ID = 0  # country id: GET /open_api/v3/proxy/area/country
N = 20

# one set of credentials: dynamic SOCKS5
r = requests.post(
    "https://proxy302.com/open_api/v3/proxy/api/proxy/dynamic/traffic",
    auth=KEY,
    json={"s": 3, "protocol": "socks5", "country_id": COUNTRY_ID,
          "billing_mode": "prepaid_pool", "idempotency_key": "batch-0001"},
)
cred = r.json()["data"]  # username, password, host, port


# tail -session-<12 chars>: every line gets its own IP
def tail():
    return "".join(secrets.choice(string.ascii_letters + string.digits) for _ in range(12))


logins = [f"{cred['username']}-session-{tail()}" for _ in range(N)]

BASE = "https://app.octobrowser.net/api/v2/automation"
OCTO = {"X-Octo-Api-Token": "OCTO_API_TOKEN"}  # token from the Octo Browser settings

profile_uuids = ["PROFILE_UUID_1", "PROFILE_UUID_2"]  # profile uuids: GET /profiles

for i, (uuid, login) in enumerate(zip(profile_uuids, logins)):
    proxy = requests.post(f"{BASE}/proxies", headers=OCTO, json={
        "type": "socks5", "host": cred["host"], "port": int(cred["port"]),
        "login": login, "password": cred["password"], "title": f"p302-new-{i + 1:02d}",
    }).json()["data"]
    requests.patch(f"{BASE}/profiles/{uuid}", headers=OCTO, json={"proxy": {"uuid": proxy["uuid"]}})
    time.sleep(3)  # Base plan: 50 requests a minute for the whole team

A Python example: for every profile in the list it creates a proxy and sends a PATCH. Run it on a single profile first.

• Sources:
• Proxy302 open API: buying a dynamic proxy
• Octo Browser: profiles API
• Octo Browser: proxies API
• Octo Browser: rate limits

Frequently asked questions

Related settings

ISP proxies (static residential)

Fixed static ISP proxies: a residential-grade IP that stays the same for the whole term. For social accounts, stores and AI tools. HTTP and SOCKS5.

View options and pricing

Rotating residential proxies

Real household IPs in 195+ countries; the Premium line adds state and major-city targeting. A new IP on every new connection, or keep sticky sessions. From US$1.50/GB, US$1.35/GB at 100 GB. HTTP and SOCKS5.

View options and pricing

Proxies in antidetect browsers

Set up a proxy in AdsPower, BitBrowser, GoLogin, Kameleo, Hidemium or GenLogin: one IP per profile, where each field goes, and what a failed proxy check really means.