Full analysis of Telegram filter result fields: CSV/TXT export and operation application guide

In the overseas customer acquisition scenario, Telegram screening is a key data processing link - you submit a batch of phone lists to the screening platform, and the platform tells you which numbers are registered with Telegram, whether they have been active recently, and even deduce gender and age group. Once you get these fields, how do you understand them correctly? How to export to CSV or TXT file for subsequent analysis? This article takes the KK-DATA platform as an example to break down the meaning of the core fields in the screen number results one by one, and gives the best practices for export operations and operational applications.

---

What is Telegram screen number? ——Batch verification number validity and attributes

Telegram screening refers to using technical means to batch detect whether the target number has registered with Telegram, and further obtain public inference information such as account activity, gender, age, etc. To put it simply, enter a bunch of mobile phone numbers and output a table: each number corresponds to one or more “attribute tags”.

Taking the KK-DATA platform as an example, its Telegram filter includes three types of detection:

• tg activation: Check whether the number is a registered Telegram user (the most basic ability)
• tg active: Determine whether the user has logged in within the specified time window (such as 7 days, 30 days, 60 days)
• telegram gender data: infer additional attributes such as gender, age group, etc. based on public information

Once the task is complete, you can download a CSV or TXT file, where each line represents a number and its detection result. Let’s get into the detailed explanation of the fields.

---

What core fields does the Telegram filter result include?

The result file you export usually contains the following fields (the actual fields are subject to the console preview):

Field name	Type	Business meaning
Number	String	Original submission number, international format (e.g. +8613800138000)
tg activation	Boolean/enumeration	Whether to register Telegram: 1 (yes) / 0 (no) / Unknown
tg active	number/enumeration	activity level, e.g. 0=inactive, 1=active within 30 days, 2=active within 7 days
Gender	Enumeration	male / female / unknown (based on public inference)
Age	String	For example, “25-35” represents an age group, not an exact number
tgid	Number	Telegram internal unique user ID
wsid	String	User ID corresponding to WhatsApp (if WhatsApp is also filtered)
uid	String	Other social platform user IDs, etc.

Note: Some fields will only be returned if the detection type contains this item, otherwise they will be empty.

Activation and activity fields (tg activated / tg active)

• tg activation: the most basic test results. If it displays 1, it means the number is a real Telegram user; if it displays 0, it means it is not registered (the number may have been deleted or never registered).
• tg active: Helps you determine whether the user has recently used it. The higher the activity, the greater the chance that your followers or private messages will be seen. For example, selecting “Active within 7 days” can filter out accounts that were registered very early but have been abandoned.

Gender and age fields (telegram gender data)

Gender detection and age judgment do not come from ID cards or real-name authentication, but are based on statistical models of public information (such as nicknames, avatars, profiles, language habits, etc.) based on algorithms. Therefore:

• Gender: divided into male, female, and unknown. The accuracy rate can reach more than 80% in most scenarios, but 100% is not guaranteed.
• Age: The output is the age range, such as 20-30, 30-40. You can’t use it as “real age”, but it can be used for rough crowd screening, such as focusing on users “about 30 years old”.

Unique identification and additional fields (tgid/wsid/uid)

• tgid: A unique numeric ID (not a mobile phone number) assigned to each user by Telegram. You can use tgid to interact with Telegram API (such as sending messages, joining groups), or as a basis for deduplication (the same user may change their mobile phone number but the tgid remains unchanged).
• wsid: If the same task also filters WhatsApp, the results will include WhatsApp ID to facilitate cross-platform joint analysis.
• uid: User ID of other social platforms (such as Line, Zalo), which can be used for cross-platform attribution.

---

How to export Telegram filter results to CSV or TXT?

In the “Task Details” page of the KK-DATA console, you can re-export the results of completed tasks at any time. The export steps are as follows:

1. Enter the console → Historical tasks → Click the task ID to enter details
2. Click the “Export” button and select the format (CSV/TXT)
3. Check the fields to be exported in the pop-up window.
4. Click Confirm and wait for the file to be generated and downloaded.

Select the export format: CSV vs TXT Applicable scenarios

Format	Advantages	Applicable scenarios
CSV	Can be opened directly by Excel, WPS, database, supports column name and field filtering	Data analysis, CRM import, merge and deduplication
TXT	Pure list, small size, one number per line	Batch powder addition, import diffusion tool, API batch query

If your follow-up operation is to “filter by activity + gender and send in groups”, the CSV format is recommended to facilitate secondary processing with Excel pivot tables.

How to filter the required fields before exporting?

All available fields are checked by default in the export pop-up window. It is recommended to keep only the columns you really need, for example:

• Only export “number + tg activated + tg active + gender”
• Remove the “Age” column (if age is not of concern)
• Do not export “tgid” (if API linkage is not required in the future)

The advantages of this are: smaller file size, cleaner subsequent processing, and avoidance of misuse of irrelevant data.

Recommendations for data cleaning and deduplication after exporting

• Check for null values: Some fields (such as age, tgid) may be empty. Use the filter function in Excel to view the proportion and decide whether to retain it.
• Deduplication: KK-DATA’s built-in Data Deduplication Warehouse can automatically exclude existing records when submitting tasks to avoid wasting balances through repeated detection. If there are still duplicates after exporting, it is recommended to use Excel “Delete Duplicates” or a Python script to clean them up.
• Uniform format: Confirm that the number column does not contain spaces, dashes, etc., and maintains pure numeric format (with international codes).

---

What is the actual value of the filter number field to customer acquisition operations?

Scenario 1: Female user community promotion If you are a cross-border e-commerce business (women’s clothing, beauty cosmetics), you would like to join the Telegram female user group or send a private message. Use the “gender=male” in the filter number results to filter out men and keep only female numbers, and then combine it with “tg active=within 7 days” to improve reach efficiency.

Scenario 2: High-intent users are reached first Let’s say you have 100,000 numbers and a limited budget. It can be divided into two steps: first run “tg activation” to filter out 50,000 registered users; then run “tg active = within 7 days” on these 50,000, and finally only send messages to 10,000 active users. The activity field is your “priority label.”

Scenario 3: Cross-platform user portrait If WhatsApp and Telegram are screened at the same time, comparing wsid and tgid can identify overlapping users and design exclusive activities for such high-value users.

Scenario 4: Age Targeting For example, if a game is targeted at people aged 25-35, the age field of the filter results (such as “25-35”) can help you narrow down the range. Although not precise enough, it is much better than completely random mailing.

---

What should you pay attention to when using Telegram filters?

1. Field accuracy has boundaries: Gender/age is an inferred result, especially age is an interval value and cannot be used for real-name authentication or legal scenarios.
2. Task upper limit: The maximum number of single tasks is about 1 million. If this amount is exceeded, split the commit.
3. Billing Rules: Charges are deducted on a per-item basis. The unit price for each detection type is different. The specific price is based on the real-time price of the console. The estimated cost will be displayed before the task is submitted.
4. Insufficient balance: New tasks cannot be submitted. You need to recharge USDT (TRC20) first, with a minimum of about 50 USDT.
5. Anti-fraud reminder: Only contact customer service through the platform’s official channels (Telegram @kkdata_robot or robot @kkdata_robot). Be wary of any other accounts claiming to be customer service.

---

Telegram screening and data deduplication: How to avoid wasting balance through repeated detection?

Duplicate testing is a hidden drain on many teams. Suppose you screened 50,000 numbers last month and screen them again this month, you will be financially charged again for the same numbers.

KK-DATA has a built-in data deduplication warehouse function: when submitting a task, the system will automatically match the historical detected numbers in the current workspace, skip existing records directly (without deduction), and only detect new numbers.

Operation suggestions:

• Before submitting a new task each time, import the deduplication warehouse (the console can be configured with one click)
• Regularly export warehouse data backup to avoid loss
• When multiple people collaborate in a team, use the same workspace to achieve better deduplication results.

This saves budget and avoids duplication of work.

---

FAQ

**Q: Is the “age” field in the Telegram screening results accurate? ** Answer: The age field comes from algorithmic inference in gender detection. It is an estimated age group (such as 20-30 years old) based on public information and is not the real ID card age. It can be used as a reference for crowd screening, but it is not suitable for real-name verification scenarios.

**Q: How to solve the garbled characters after exporting CSV? ** Answer: Please check whether UTF-8 encoding is selected when exporting (KK-DATA defaults to UTF-8). If the code is still garbled after opening, try using Notepad to save as UTF-8 or use Excel to “Import from text/CSV” and specify the encoding.

**Q: Why is there no “tgid” field in my filter number results? ** Answer: The tgid field will only be returned when the detection type contains “tg activated” or “tg active” and the number is a valid registration. This field is empty if the number is not registered or the detection type does not include this.

**Q: How many numbers can be screened at most at one time? ** Answer: The maximum number for a single task is about 1 million. If the amount of data is larger, it is recommended to submit it in batches. For detailed restrictions, please refer to the prompts on the console task submission page.

**Q: Can the filter number results be exported repeatedly? ** Answer: The screening results of completed tasks can be re-exported at any time in the console history without repeated deductions. However, it should be noted that the data deduplication warehouse only retains the duplication check records in the work area. It is recommended to download it as soon as possible.

---

If you are looking for a stable and comprehensive telegram screen platform, you might as well try KK-DATA. From number generation to multi-platform screening, to data deduplication and export, one assembly line solves the problem of acquiring customer data.

👉 Log in to the console to start screening numbers Two-way contact customer service: https://t.me/kkdata_robot More documentation and billing instructions: https://kkdata.cc/ · https://docs.kkdata.cc/