tg US data field dictionary: From number status to gender and age, understand TG US number data in one article

For any overseas operations team, tg US data is a core asset for cold start and accurate access to US users. However, after getting a batch of US numbers, many people often only see the two statuses of “activated” or “not activated”. In fact, a complete set of tg US data fields - from number activation status, activity level to gender, age, and tgid - contains far more actionable information than imagined. This article is a TG US Number Data field dictionary that will help you understand the business meaning of each record field by field, and know which fields can help you screen out users with high response rates, which fields can be used for crowd portraits, and which fields can open up private message docking.

---

What is tg US data? Why do we need to understand its field structure when acquiring customers overseas?

The so-called tg US data refers to a set of structured records output after determining the status, attributes, and behavior of the target US mobile phone number on the Telegram platform through number detection means. It is not a simple “yes/no” list, but a multi-dimensional data pool - including whether the number is registered with Telegram, the last online time, the gender filled in by the user (or the gender inferred by the algorithm), age range, and the platform’s unique identity ID (tgid).

Understand the actual value that field structure can bring:

• Avoid wasting budget: Only conduct follow-up contacts to truly activated and active numbers to reduce invalid sending.
• Improve conversion rate: Targeted delivery of content based on gender, age, and active time periods, rather than blind mass delivery.
• Establish a long-term user pool: Use tgid deduplication and management to continue to follow up even if the number changes.

In a word: **Only if you understand the fields, it is not considered a white screen. **

---

What core fields does tg US data contain? — Field type panorama

Field Categories	Typical Fields	Business Usage
Number status	Activation status, valid status	Determine whether the number is a registered Telegram user
Activity	Last online time, active window	Determine whether the user has recently logged in, suitable for private message contact
User portrait	Gender, age, presence of avatar	Population orientation, such as female users, people around 30 years old
Platform identification	tgid (Telegram ID)	Private message docking, blacklist management, deduplication
Others	Username (if any), privacy settings	Secondary verification, personalized messages

Each type of field has independent detection entrance and export options, which are disassembled one by one below.

Number basic status field (activated/valid)

The two most commonly used fields in detection results:

• Activation status: Whether the number has been registered with Telegram. The return value is usually 开通 / 未开通. This field is the prerequisite for all subsequent tests - only activated numbers can continue to perform activity, gender and other tests.
• Effective status: On the basis of activation, it is further determined whether the number can be privately messaged (that is, there is no privacy restriction or the account is not blocked). The return value may contain 有效 / 无效 / 有限制.

Business Scenario: For mass verification tasks, it is usually enough to just look at “activate”; when doing one-on-one private message promotion, you must filter out “valid” numbers to avoid being blocked or reported by the other party.

User portrait fields (gender, age, avatar, etc.)

The gender and age fields come from Telegram’s public information or platform algorithm inferences. They are not accurate data at the ID card level and are statistical references. Specific meaning:

• Gender: May return male, female, unknown (or Chinese description). Typical usage scenarios: Female beauty products are only available to female users.
• Age: Returns an approximate age value or age range (e.g. 25-34). You can filter “people around 30 years old”, but it cannot be used as the age of the household registration.
• Avatar: Some detection types will return whether there is an avatar. Users with avatars are generally more active and authentic.

Note: The value of the age field fluctuates greatly. It is recommended to use it in combination with other fields (such as activity) to increase the reliability of screening.

Platform identification field (tgid)

tgid is a unique numeric ID assigned to each user by Telegram (in the format of 1234567890). Unlike a mobile phone number, tgid will not change after the user changes his number. You can use it to do:

• Private message docking: Some automation tools support sending messages by tgid to bypass number restrictions.
• Database deduplication: Even if the same user registers with different numbers, the tgid is still unique, which can avoid repeated detection.
• Blacklist Management: Add user tgid that has been explicitly rejected in the past to the blacklist and no longer access it.

---

How to interpret the number status field? — The difference between activation and validity in actual screen numbers

Many new operators confuse “activate” and “effective”, but there are essential differences between the two:

Status	Meaning	Business Risk
Activation	The number has been registered on Telegram	Can be added to the group (if the group settings allow it), but private messages may fail
Valid (can be privately messaged)	The number has been registered and is allowed to receive non-contact messages	The success rate of private messages is high
Restrictions	The account has strict privacy settings (only contacts can message)	It is not recommended to send private messages directly, as it is easy to be reported

Practical Suggestions:

• When sending group invitations, the activated status is sufficient.
• When sending one-to-one private messages or marketing messages, the “valid” status must be selected.
• When filtering US TG data, because American users have a low tolerance for marketing, it is recommended to use the “valid” filter first to reduce the probability of account closure.

---

How to use the activity field in tg US data? — Basis for determining the user’s online time period

Activity detection will return the user’s “last online time” or “active in the last X days” status. You can specify the active window when submitting a detection task, for example:

• Active within 7 days: Online recently, suitable for sending time-sensitive event invitations.
• Active within 30 days: relatively active regular users.
• Customized interval: such as the last 3 days, 6 months, etc.

Key Points:

• The more recent the activity, the higher the user response rate, but the smaller the number.
• Users with older activity (such as 6 months ago) may have abandoned their accounts and are not recommended to be reached.
• The activity field can be combined with the gender and age fields: for example, filtering “US region + active in the last 7 days + around 30 years old + female”.

---

How to correctly understand the gender and age fields in tg US data?

Reliability and usage suggestions of gender field

Gender judgment is usually based on the user’s public information (the gender filled in the Telegram profile) or algorithmic models (inferred based on the user name, avatar, and behavior patterns). The accuracy rate can reach 70%–90% on most platforms, but 100% cannot be guaranteed. Usage Suggestions:

• When doing audience profiling analysis, you can safely use the gender field for statistical-level targeting.
• When making precise personalized messages, it is recommended to include inclusive wording (such as “friend” instead of “lady”) in the message to avoid embarrassment caused by gender errors.

How does the age field assist in crowd profiling?

The numerical reference meaning of the age field is greater than the absolute meaning. For example, when you filter for people “about 30 years old”, you can set the age range 25-35, and then add activity >7 days to get a group of “American users with a high probability of being around 30 years old who have recently used Telegram.” What not to do: Claim that it can be accurate to “35 years and 3 months”, or used for compliance risk control.

---

What is the use of exporting the tgid field? — Advanced gameplay from numbers to unique IDs

tgid is a unique identifier assigned to each account by Telegram. Even if the user later changes his mobile phone number, tgid will not change. Therefore it has three important uses:

1. Database deduplication: If your team imports numbers from different sources multiple times for detection, tgid can help you identify duplicate accounts and only keep the balance without wasting it.
2. Automatic tasks based on tgid: Many automated interfaces (such as Telegram Bot API) support sending messages by tgid without relying on mobile phone numbers.
3. Long-term user portrait accumulation: Save the tgid after each screening, and match the gender, age, and activity level to build a constantly iterative library of high-value user portraits.

---

How to efficiently use the tg US numeric field dictionary for refined operations?

Recommended “stratified screening method”:

1. The first level: basic number screening (activation detection) From the global number generation or own number pool, first detect the US numbers that have activated Telegram. This step is the lowest cost and can quickly eliminate useless numbers.

2. Second layer: activity detection Perform activity filtering on the activated numbers and select users that meet your reach time window (such as active within 7 days). The quantity is controllable and the response rate is greatly improved.

3. Third level: User portrait filtering (gender + age) According to business needs, make gender targeting (for example, only take female) and age range (25-35). Export the tgid for later use.

For example: A cross-border e-commerce team wants to promote a product “light luxury accessories suitable for 30-year-old American women”. They can combine and filter:

国家 = 美国
开通状态 = 开通
活跃窗口 = 7天内
性别 = female
年龄范围 = 25-35
tgid导出 = 是

What is obtained in this way is a group of high-potential target users, and tgid can be used to dock subsequent automated messages.

---

FAQ

**Q: What are the field types of tg US data? ** Answer: It mainly includes number activation status, activity, gender, age (reference field) and platform ID (tgid), etc. The field combinations exported by different detection tasks are different. For details, see the console task results.

**Q: Is the age field in tg US data accurate? ** Answer: The age field is the result of algorithm inference or public data attribution, which is a statistical reference (for example, it can filter people around 30 years old), and is not accurate data at the identity card level.

**Q: How long can the window period be specified for the activity detection of tg US data? ** Answer: Activity detection supports specifying activity windows (such as active within 7 days, active within 30 days, etc.). The specific options are subject to the console task configuration.

**Q: Are the numbers in tg’s US data real user numbers? ** Answer: The platform conducts Telegram activation/activity detection based on global numbers generated or numbers imported by users. The detection results reflect the status of the number on the Telegram platform and does not guarantee the source of the number itself.

**Q: After the screening is completed, how to select the export fields? ** Answer: After the task is completed, you can choose to export it in CSV or TXT format on the console. The exported fields depend on the detection type you choose (open detection, active detection, complete detection, etc.).

---

Now use KK-DATA’s tg US data filter function to quickly locate target users. Log in to the console to start filtering, and contact two-way customer service for usage guidance.

👉 Log in to the console to start screening numbers | Two-way contact customer service https://t.me/kkdata_robot

Official website https://kkdata.cc/ | Documentation https://docs.kkdata.cc/ | Blog https://kkdata.cc/blog/