KK-DATA Console Tutorial: How to Create a tg Active Data Filtering Task

If you are doing overseas marketing, community operations, or need to contact potential customers on Telegram in batches, simply knowing whether a number is registered with Telegram is not enough. What’s really valuable is tg activity data – real users who have logged into Telegram recently and are likely to reply to messages. This article will teach you step-by-step how to create a tg active data filtering task in the KK-DATA console. It will practice the entire process from uploading numbers to exporting results, helping you to accurately filter out “zombie accounts” and numbers that have not logged in for a long time.

What is tg active data? Why is it more valuable than just turning on testing?

tg active data refers to detecting the Telegram server interface to determine whether a mobile phone number has logged in or used Telegram within a specified time window (such as the past 7 days, the past 30 days). This is essentially different from “only enabling detection”:

Detection type	Meaning	Value in customer acquisition scenarios
Activation test (registration test)	Verify whether the number has been registered with Telegram	I only know that the other party has an account, but it may have been abandoned
Activity detection	Verify whether the number has recently used Telegram	There is a high probability that it is still using Telegram, and there is a real chance of reaching it

In actual marketing, sending a message to a Telegram account that has not been logged in for 2 years is almost equal to nothing. And tg active data can help you filter out live people who are “still using it today or this week”, greatly increasing the response rate and conversion rate. Especially when you do private message promotion, community invitations, and airdrop activities, the effect of the list filtered by active data may be 3–5 times higher than the simple activation list.

How to create the first tg active data task in the KK-DATA console? (Five steps of practical operation)

The following takes the KK-DATA console as an example to demonstrate the complete operation process. You only need to complete five steps in order to get a list of tg active users that can be directly used for marketing.

Step one: Log in to the console and make sure your balance is sufficient

Open the Application Console and log in. If you are using it for the first time, you need to complete the registration first.

KK-DATA adopts a per-item billing model, with no monthly or annual fee packages. Before submitting a tg active task, please confirm that the account balance is sufficient. The recharge entrance is on the “Recharge” page in the top navigation bar of the console. It only supports USDT (TRC20), with a minimum of about 50 USDT. The balance will be automatically updated after the recharge arrives.

Step 2: Create a new screening task and select the “Telegram active” detection type

Click “Screen Task” → “Create Task” on the left menu of the console. Then on the task configuration page:

1. Select platform: Pull down and select “Telegram”.
2. Detection Type: Check “Active” detection. You can also check “Open” and “Gender” (including the age field) at the same time, so that the export results will be richer.
3. Set active window: The console can customize the “active time window”, such as the last 7 days, the last 30 days, the last 60 days, etc. It is recommended to choose according to your marketing cycle: choose the last 7 days for short-term promotions and the last 30 days for regular follow-up. The default is usually the last 30 days.

Step 3: Upload the number to be detected or generate it using a global number

There are two ways to enter a number:

• Upload files directly: Support CSV, TXT format, one international area code + number per line, for example 8613800138000. You can also paste the list of numbers directly.
• Use global number generation: If you do not have a ready-made number pool, you can first use the “Number Generation” module of the console. This module supports 240+ country/region number random generation, global number segment generation, and even supports custom number segment CSV import. The generated numbers are free, and fees will be deducted only when subsequent numbers are screened.

Tips: Put “Generate → Filter → Export” into a pipeline to quickly produce high-quality active contacts in a certain country/region.

Step 4: Submit the task and wait for notification

After uploading the number, the console will display the estimated cost. Please carefully check the total number of items and budget, and click “Submit Task” after confirming that they are correct.

After the task is submitted, you can view the real-time progress in the “Task List”. If you want to receive a notification immediately when the task is completed, please bind your Telegram account in the console (Settings → Notification Binding), and a robot will send a message reminder after the task is completed.

Step 5: Export tg active data results

When the task status changes to “Completed”, click the “Export” button on the right side of the task. Supports exporting to CSV or TXT format.

The fields of the export file usually include (subject to the actual export columns of the console):

• Mobile phone number
• Whether Telegram is activated (is_active_tg)
• Is it active (is_active)
• Last active time (active_at)
• tgid
• gender (gender) and age (age)
• Avatar link etc.

What fields does the tg active data result contain? How to interpret it for subsequent marketing?

It is recommended to open the exported CSV file in Excel or Google Sheets. The core fields and their interpretation are as follows:

Field examples	Meaning	Marketing recommendations
is_active = true	This number has used Telegram within the active window	Try to contact now, the probability of reply is high
is_active = false	The number has not been used beyond the active window	Lower the priority or try other channels
gender = male, age = 30	Gender and age identification results	If the product is targeted at men/30-year-olds, targeted copywriting can be sent
tgid	Telegram user unique ID	Can be used for subsequent tgid level filtering or API calls

You can filter multiple conditions directly in Excel, for example: “active” + “male” + “age between 25-35”, and then only send targeted promotion information to this group of people, so that efficiency and accuracy will be significantly improved.

What other auxiliary functions are there in the console related to tg active data?

In addition to basic screening tasks, controlling several practical tools can also indirectly improve the experience of using tg active data:

• Data Deduplication Warehouse: Each number you upload will be deduplicated with historical tasks to avoid wasting balance due to repeated detection of the same number. Especially when you run active tests in similar countries or regions multiple times, deduplicating the warehouse can save a lot of costs.
• Task History: You can filter historical tasks by time, platform, and result status to facilitate the review of previous activities.
• Balance change details: Every deduction and recharge record is clearly visible, making cost accounting easy.

What is the difference between tg active data and tg activated data? When should you use which one?

Dimension	Activation Detection	Activity Detection
Judgment criteria	Whether the number is registered with Telegram	Whether the number has login/usage records within the active window
Data aging	Permanently valid (unless logged out)	As time changes, the reference value of old task data decreases
Applicable scenarios	Preliminary screening, database construction, large-scale account scanning	Accurate reach, event invitation, paid conversion
Cost	Lower	Slightly higher (because the active status is queried once more)

Practical suggestions:

• If you have a limited budget, first use the activation test to save the roughly screened numbers to the data warehouse, and then do active testing later to avoid waste.
• If you are engaged in reaching high-value customers (such as finance, education, B2B), it is strongly recommended to use tg active data directly, because the other party is most likely to be a real person and has been active recently, and the communication cost is lower.

Precautions and common misunderstandings when using tg active data

1. The upper limit of a single task is about 1 million: If your number list exceeds this number, please split it into multiple tasks and submit them in batches.
2. Activity data does not mean real-time online: The other party may have set the stealth mode, but this does not affect the activity detection. We can only know whether the other party has logged in within the time window, but we cannot determine whether the other party is looking at the phone at the moment.
3. Gender/age fields are for reference only: Telegram officially does not provide real identity information. Gender and age are inferred through a variety of signals (such as nicknames, avatars, public information, etc.). The accuracy is at the industry average and should not be used as ID-level information.
4. Don’t rely too much on one test result: The active status will change over time. It is recommended to update the data periodically according to the marketing rhythm.

FAQ

Question: How many numbers can be submitted at one time for tg active data detection?

Answer: A single task supports up to about 1 million numbers. If the original list is larger, it is recommended to divide it into multiple tasks and submit them in batches to avoid exceeding the limit.

Question: After the detection is completed, is there any information other than mobile phone number in the tg active data I exported?

Answer: Yes. The exported fields usually include: mobile phone number, whether Telegram is opened, whether it is active, the last active time, tgid, gender, age, avatar link, etc. The details are subject to the export column on the console task results page.

Question: How much does tg active data detection cost?

Answer: Billing is per item. The unit prices for different detection types (activated only/activated + active) are different and may be adjusted over time. Please view real-time estimated costs when creating tasks in the console, or visit Billing Instructions to learn about billing rules.

Q: How do I know the task is completed?

Answer: After submitting the task in the console, you can bind your Telegram account, and a notification message will be automatically sent when the task is completed. You can also manually refresh and view the status on the “Task List” page of the console.

Question: What does the detected “active” mean? How long does it take to be considered active?

Answer: “Active” means that the number has Telegram login or usage records within the time window you set (such as the past 7 days, the past 30 days). The time window can be customized when creating a task, and the default is the past 30 days.

---

The above is the entire process of obtaining tg active data in the KK-DATA console. Whether you are doing community recruitment, cross-border e-commerce promotion or airdrop activities, a contact list filtered by activity will make every contact more valuable.

👉Log in to the console to start screening numbers Two-way contact customer service:https://t.me/kkdata_robot Official website:https://kkdata.cc/ Usage documentation:https://docs.kkdata.cc/