Complete Guide to CSV/TXT Export of US TG Data: Field Selection, Naming Standards and Downstream Usage Suggestions
关于作者
KK-DATA 获客数据筛号平台官方内容团队。
Complete guide to CSV/TXT export of US TG data: field selection, naming conventions and downstream usage suggestions
Obtaining accurate contact information of overseas users is a key link in overseas marketing, and US tg data (that is, filtered results of Telegram activation, activity, gender, etc. in the US) is the basis for many teams to reach target customers in batches. However, if the filtered data just stays on the console interface, it cannot be truly used. Exporting US TG data to CSV/TXT is a prerequisite for subsequent data analysis, CRM import, and remarketing. This article will systematically explain field selection, file naming techniques, downstream usage scenarios, and common precautions when exporting to help you make efficient use of this batch of data.
What is US TG data? Why do you need to export CSV/TXT?
US tg data specifically refers to the structured results obtained after conducting Telegram detection on a batch of US mobile phone numbers through number screening platforms (such as KK-DATA). Typical output dimensions include:
- Whether the number has been registered with Telegram (activated status)
- Whether it has been active recently (time window can be specified, such as 7 days, 30 days)
- Gender, age, avatar and other auxiliary information (provided by gender detection, not real-name authentication)
- Corresponding tgid (Telegram internal user ID)
This data is displayed in list form in the console, but only by exporting it to a CSV or TXT file, you can:
- Import into Excel or Python for secondary analysis and deduplication
- Batch import into CRM system or add powder tool
- Stratify by activity/gender/region to formulate differentiated marketing strategies
- Long-term archiving for subsequent comparison or expansion
Therefore, mastering export operations and file organization specifications can significantly improve data usage efficiency.
What fields are available when exporting US TG data?
After creating a screening task in the KK-DATA console and completing the detection, enter the “Export Column Settings” to check the fields that need to be output. Different fields correspond to different business meanings. Understanding the purpose of each field can help you avoid exporting redundant information.
Common fields and business meanings
| Field name (example) | Business meaning | Typical usage scenarios |
|---|---|---|
| Mobile phone number (number) | Original mobile phone number (with international area code) | Used to add friends and send invitation chains |
| Activation status | Whether to register Telegram (1/0 or true/false) | Filter registered users to avoid invalid additions |
| Active status | Whether to go online within a specified window (e.g. 7 days) | Lock in recent online users to increase reach rate |
| Gender | Inferred gender (male/female/unknown) | Targeting by gender, such as promoting games or tools to male users |
| Age | Estimated age (approximate value, such as 25-35) | Assists in screening target groups, for reference only (not real-name data) |
| Avatar | Whether to set an avatar | Users with avatars are usually more active |
| tgid | Telegram internal ID (exportable) | Used for API level operations or deduplication |
| Country code | Home country code | Confirm it is a US number |
The fields are subject to the console
For the actual list of supported fields, please refer to the “Export Column Settings” of the KK-DATA console. New fields may be updated from time to time. Depending on the detection type (such as Telegram activation vs. active vs. gender), the available fields will also be different.
Which fields are most valuable to marketing?
For most TG private message promotion or community invitation scenarios, the most recommended field combinations are:
- Open status + active status - Ensure that the user is truly registered and online recently
- Gender + Age - Assisted crowd targeting (for example, screening male users around 30 years old)
- tgid - to facilitate subsequent deduplication or API calls
It is recommended to preview a small amount of data before exporting and confirm that the selected fields are accurate before exporting in full to avoid finding that key information is missing after downloading.
How to correctly name files exported with US TG data?
File naming may seem like a trivial matter, but it is crucial when managing multi-batch and multi-platform data. A clearly traceable file name can save hours of organization costs.
Recommended file naming template
{国家}_{平台}_{状态}_{日期}_{自定义标签}.csv
Example:
US_TG_active_male_20250320.csv—— United States, Telegram, active, male, March 20, 2025US_TG_all_registered_20250315.txt—— United States, Telegram, all registered, March 15, 2025US_TG_7d_active_20250322.csv—— United States, Telegram, active in the past 7 days, March 22, 2025
The meaning of each paragraph in the template:
| Segmentation | Meaning | Recommended values |
|---|---|---|
| Country | Number location | US (ISO two letters) |
| Platform | Social platform abbreviation | TG, WA (WhatsApp), Line, etc. |
| Status | Filter dimensions | active, registered, male, female, etc. |
| Date | Export date or task completion date | YYYYMMDD (to avoid ambiguity) |
| Custom label | Optional, such as batch number, remarks | batch1, test, v2 |
Common naming mistakes and how to avoid them
- Avoid spaces and non-ASCII characters: Use underscores or hyphens instead of spaces to prevent parsing errors in Excel or command line tools.
- Uniform date format: Do not mix “2025-03-20”, “20250320” and “03/20/2025”. YYYYMMDD is recommended.
- Do not have the same name for different batches: If you filter multiple batches of data in one day, be sure to add the batch number or timestamp (such as
_batch1or_1430for export at 14:30). - Distinguish between platforms: When doing Telegram and WhatsApp at the same time, clearly indicate the platform in the file name to avoid confusion.
After exporting CSV/TXT, how can it be used for downstream marketing?
After obtaining structured U.S. TG data, common downstream usage paths include:
- Import into the CRM system: Write mobile phone number, tgid, gender and other information into the customer table in batches to achieve label management.
- Add contacts in batches: Many TG fan adding tools support CSV import, read numbers by line and automatically initiate addition requests.
- Private message mass sending preparation: Stratify the exported data according to activity level and send it to users who have been active in the past 7 days first to increase the open rate and reply rate.
- Reuse data after deduplication: If historical data already exists, the new export file can be merged with the existing library to remove duplication to avoid wasting costs of repeated detection.
- Second Enrichment: After exporting the tgid, you can query user groups, Bot interactions and other more information through other tools.
Data re-cleaning suggestions
It is recommended that the exported CSV be checked for duplicate numbers and null fields in Excel or Python before being used for adding followers or private messages. Especially when data from multiple tasks is spliced, deduplication can significantly reduce the cost of invalid contact.
What are the precautions for filtering data and batch exporting of US TG?
Processing strategy when the amount of exported data is too large
KK-DATA supports up to about 1 million number detections in a single task, but the exported file is too large (such as more than 100MB), which may cause lag in opening or the tool does not support it. Recommended practices:
- Split tasks by dimensions: For example, instead of exporting all registered users at once, create tasks separately according to “active for 7 days”, “active for 30 days” and “inactive”.
- Split by gender: If you need data for both men and women, it is recommended to export it into two tasks for subsequent targeted use.
- Compression after export: CSV files can be compressed with ZIP to reduce transmission and storage space.
Data Compliance and Privacy Reminder
- All US TG data comes from public number screening or number pools uploaded by users. Please comply with Telegram’s terms of service and local data regulations (such as GDPR, CCPA).
- Never use data for spam, harassing mass messaging, etc.
- Fields such as age and gender are derived from statistical calculations and are not real-name authentication and cannot be used as legal evidence or absolutely accurate indicators.
Why choose KK-DATA for US Telegram data screening and export?
There are many screening platforms on the market, but KK-DATA has several practical advantages in US TG data:
- No subscription package, billed by item: Pay as you use, suitable for flexible needs from small teams to large data operations. For specific unit prices, please see [Console Real-time Price] (https://app.kkdata.cc/) or [Official Website Billing Page] (https://kkdata.cc/billing/).
- Supports multiple accurate detections: Telegram activation, activity (customizable window), gender (including age, avatar and other fields), and tgid export.
- Flexible export format: CSV and TXT are optional, and fields can be customized to meet the needs of different downstream tools.
- Data Deduplication Warehouse: Automatically remove duplicates across tasks to avoid wasting balances through repeated detection.
- Telegram Notification: Push immediately after the task is completed, no need to keep an eye on the console.
If you are looking for a flexible and transparent US TG data screening tool, KK-DATA is worth a try.
FAQ
**Q: Are there any additional charges for exporting US TG data? ** Answer: There is no additional export fee. You only pay for the number of detections for your number (different by platform and detection type, see the real-time price on the console for details). There is no additional charge for exporting to CSV or TXT.
**Q: Can the exported CSV be directly imported into a third-party tool? ** Answer: Most tools support CSV import, but you may need to adjust the field header (for example, change “mobile phone number” to “phone”) or delete redundant columns. It is recommended to import 10 lines of tests first, and then process them in batches after confirming that the mapping is correct.
**Q: Are the ages in the US TG data accurate? ** Answer: The age comes from the inferred field in gender detection (based on statistical models such as account information, not real-name authentication data), which is not guaranteed to be 100% accurate. It is recommended to be used as a reference for population proportion, rather than as a basis for accurate delivery.
**Q: Can I preview some results before exporting? ** Answer: Yes. After the task is completed, the console usually provides a “download sample” or “preview” function, allowing you to check the field format and content of a small amount of data first, and then export the full amount after confirming it is correct.
**Q: How to download the export files of multiple tasks in batches? ** Answer: Currently, single tasks are exported one by one. It is recommended that you download the files one by one in the task list after the task is completed, and organize the files into the same folder according to naming conventions to facilitate subsequent merge processing.
Start using US TG data filtering and exporting!
👉 Log in to the console to start screening numbers
Two-way contact customer service https://t.me/kkdata_robot
Official Documentation https://docs.kkdata.cc/
Visit the official website https://kkdata.cc/
Related Articles
Guide to CSV/TXT Export of American TG Male Data Field Selection and Naming Conventions
Get US TG male data and export to CSV or TXT? This article explains in detail the meaning of filter fields (activated, active, gender), naming conventions, downstream marketing application suggestions, and practical steps of the KK-DATA platform to help overseas teams efficiently obtain high-quality American Telegram male user data.
U.S. TG data remarketing practice: How to use U.S. Telegram data to update silent user lists and tiering strategies
Master the compliant usage of US TG data in remarketing. This article explains in detail how to filter active users through US Telegram data, update silent lists and reach them in layers to improve the efficiency of overseas customer acquisition. Attached are the key points for KK-DATA screening operations, allowing U.S. tg data to help with precise remarketing.
U.S. TG data hierarchical screening guide: four steps of activation, activity, gender and age to accurately locate high-value users
How to efficiently filter US TG data? This article explains in detail the step-by-step usage from activation detection, activity stratification to gender and age fields (including people around 30 years old). Combined with actual combat scenarios, we will teach you how to hierarchically manage US Telegram data according to activity and crowd characteristics. It is suitable for reference for B2B overseas and community operation teams.