What are the differences between Telegram's TDATA, Session, and JSON (and how can buyers understand them)?
After purchasing a Telegram account, the seller sends you a tdata folder or a session + json file. Unsure which software to import it into? This article explains the differences between the three formats from the buyer's perspective, what to check first upon receiving the goods, and how to avoid common pitfalls.
Avery Bennett
After you purchase an account, the seller sends you a compressed file. When you open it, you'll find either a folder called tdata, or a .session file paired with a .json file. There's no username or password, and you have no idea which software to import it into. Your first reaction is probably to wonder if the seller sent the wrong item.
In reality, all three are standard delivery formats, just for different login methods. This article will help you understand what the files you receive are and how to use them.
Quick Reference: Three Formats
| Format | What the File Looks Like | Common Use Case |
|---|---|---|
| Tdata | A whole folder containing cache and configuration files | Telegram Desktop client (Windows version). Replace the client's login data folder with this one. |
| Session | A .session file | Automation scripts or bulk messaging tools built on libraries like Telethon or Pyrogram. |
| JSON | A .json file containing the account's login key information | Often paired with the Session file. Some tools require both to log in completely. |
You don't need to remember the technical details. Just know which format your tool or client supports.
3 Things to Check When You Receive Your Files
Three steps are enough. No need to overcomplicate it.
- Check that all files are present: Make sure the required folder or files are all there, with no missing files or empty 0-byte files.
- Check that the format matches your tool: Ideally, you confirmed this before ordering. Double-check again upon receipt to avoid buying a Tdata file when you only have a web-based tool.
- Test in an isolated environment first: Import and test on a clean device or virtual machine to confirm you can log in normally before moving it to your main working environment.
Common Buyer Pitfalls
Two issues are most common, and neither is the format's fault.
- Wrong format, tool won't work: For example, buying a Tdata file but trying to import it into a mobile bulk messaging tool. They are incompatible. Confirm your tool's import format requirements before ordering, don't wait until you receive the files to find out they don't match.
- Conflict from the account being logged in elsewhere: If the seller or someone else still has an active login session with the same files on another device, your import might log them out or trigger an unusual login prompt. Log in yourself as soon as you receive the files to secure your access.
Most disputes stem from these two points. Checking beforehand can save you a lot of trouble later.
Which Format to Choose and When
Different types of buyers tend to prefer different formats.
| Buyer Type | Preferred Format | Reason |
|---|---|---|
| Crypto/Web3 Community Manager | Tdata | Manages communities manually using the desktop client, operating more like a normal user. |
| Channel/Traffic Marketer | Session + JSON | Imports into bulk messaging tools for more efficient, scripted operations. |
| Agent/Service Provider | Tdata (for easy handover) | Clients can log in directly with the desktop client after taking over, requiring no technical know-how. |
| Automation/Bot Developer | Session + JSON | Integrates directly with libraries like Telethon/Pyrogram without needing to log into a client manually. |
| Reseller | Varies based on downstream client needs | Tests one format to confirm it works, then selects in bulk based on client requirements. |
Where to Compare Format Descriptions
On HstockPlus, different suppliers may label the formats for the same batch of Telegram accounts slightly differently. We recommend browsing the Telegram Accounts section to check several listings and ensure the format description matches your needs. When logging into multiple accounts in bulk, assigning a separate proxy IP to each account can help reduce unusual login prompts triggered by IP clustering.
The specialized Telegram account site, tgaccounts.net, also provides fairly detailed format descriptions. If your tool doesn't recognize a format, you can check how other sites label and deliver theirs for comparison.
Frequently Asked Questions
Can a Tdata folder be converted to a Session format? Technically, third-party tools can do this, but the conversion process carries a risk of failure. If your tool specifically requires a certain format, it's better to buy an account in that format directly rather than converting it yourself.
Why do some listings provide both a Session and a JSON file? Many tools require both files to fully restore the login state. Missing one could cause the import to fail. Make sure you have both files upon receipt.
What should I do if I get a prompt saying the account is in use on another device after logging in? This means someone else might still be using the same login files. First, log out other devices from within Telegram, then log in again to secure your access. If the issue persists, contact the seller to verify.
Do format files have an expiration date? The login files themselves don't expire. However, if the platform requires the account to re-verify, or if the password is changed, the old login files will become invalid and you'll need to log in again.
