How to use a proxy with Telethon

Which proxy works best with Telethon?

A residential or mobile proxy with a sticky session, in the country the account is used from.

• Residentialfrom $3.52 per GB
• Mobilefrom $3.52 per GB

Proxy settings for Telethon: host, port and login

A BooProxies plan gives you four things: a host, a port, a username and a password. These are the values for Residential; the username and password are on your plan page.

The country and the session are chosen in the username, not in a separate setting. The generator on your plan page writes the username for you, and Targeting and sessions explains each part.

Telethon proxy setup, step by step

1. Install python-socks alongside Telethon.
2. Pass proxy to TelegramClient with the type, host, port, username and password.

Telethon proxy example

Python

from telethon import TelegramClient

proxy = {
    "proxy_type": "socks5",
    "addr": "resi.proxies.boo",
    "port": 1080,
    "username": "USERNAME-country-us-time-600-session-a1b2c3d4",
    "password": "PASSWORD",
    "rdns": True,
}
client = TelegramClient("session", API_ID, API_HASH, proxy=proxy)

Replace USERNAME and PASSWORD with the login from your plan page. The example asks an IP-check address, so the output is the address your request left from.

Rotating or sticky sessions for Telethon?

If Telethon is acting as one visitor through several steps, use a sticky session so the IP address stays the same throughout. If each run is independent, leave the session out and every run starts from a new address.

A sticky username looks like this:

USERNAME-country-us-time-600-session-a1b2c3d4

Telethon proxy not working?

• Use a sticky username. Telegram keeps a long-lived connection, and a session that changes IP address in the middle is dropped.
• A 407 error means the username or password was not accepted. Copy both again from your plan page, and check that nothing added a space or cut the username short.
• If the IP address is in the wrong country, look at the username: the country code is part of it. More fixes.

Questions about Telethon and proxies

Terms explained: headless browser, rotating proxy, sticky session, proxy authentication.

Telethon is a product of its own makers. BooProxies is not affiliated with it; the name is used here only to say what this guide is about. Use it within the rules of the sites you work with and our acceptable use policy.