← All articles

What Is the session+JSON Format of a Telegram Account and How to Use It

What the session+JSON Format Is

The session+JSON format is a pair of files that describe a single authorized Telegram account. The .session file is a SQLite database used by the Telethon (or Pyrogram) library, storing the authorization key (auth_key), the data-center ID (DC), the server address and the session state. The accompanying .json file holds account metadata: phone number, user_id, api_id and api_hash, device_model, app_version, system_lang_code, and sometimes the 2FA password and proxy. Together they let you spin up an active session without logging in via SMS again.

At TeleGamarket (telegamarket.pro), session+JSON is one of the main delivery formats for Telegram accounts alongside tdata. It is ideal for automation through MTProto libraries and bulk tasks: mailing, parsing, airdrops and arbitrage.

How session+JSON Differs from tdata

tdata is the folder of the official Telegram Desktop client, bound to a specific installation. session+JSON is a cross-platform format for Python scripts. A quick comparison:

Criterionsession+JSONtdata
Where usedTelethon, Pyrogram (scripts)Telegram Desktop
FormatSQLite + JSONFolder of binary files
AutomationPerfect for bots and mailingNeeds conversion
Device metadataSet in JSONFixed by the client

The key advantage of session+JSON is precise control over device_model and API parameters, which is critical for antidetect.

Importing an Account via Telethon

Place account.session next to your script and read the parameters from the JSON. A minimal authorization flow looks like this:

  • Read api_id and api_hash from the JSON file.
  • Pass the device parameters: device_model, app_version, system_version.
  • Create TelegramClient('account', api_id, api_hash, device_model=..., proxy=...).
  • Call client.connect() and check client.is_user_authorized().
  • If 2FA is enabled, pass the password from the twoFA field.

For Pyrogram the logic is similar, but it uses its own session format, so conversion is sometimes needed. Important: the api_id/api_hash in the JSON must match those the account was registered with, otherwise a ban is possible.

Antidetect and Proxy Best Practices

Safe work with session+JSON relies on a stable environment. One account — one proxy for its entire lifetime. Abrupt changes of IP, country or device_model trigger a flag and a freeze.

  • Use mobile or residential proxies, preferably from the number's country of registration.
  • Do not change device_model and app_version between runs — keep them as in the JSON.
  • Use MTProto proxies to bypass ISP-level blocking.
  • Never run one .session in two places at once — it kills the auth_key.
  • Warm up fresh autoreg accounts gradually, with no mass actions in the first 24 hours.

Buying and Warranty at TeleGamarket

The TeleGamarket catalog offers Telegram accounts in session+JSON format: autoregs, real-SIM accounts, premium, with 2FA and verification, retail and bulk. Payment is via USDT and other cryptocurrencies, as well as CryptoBot and RUB; crypto settlement is convenient for arbitrage and airdrop tasks.

Every account comes with a 24-hour validity warranty: if a session fails to load or is invalid, it is replaced. For questions about the format, conversion and integration, contact support @RegaProvider. Following proxy hygiene and antidetect practices is on the buyer's side and directly affects how long an account survives.