Tutorial on Random Number Generation by Country: Batch Generate Random Phone Numbers by Country with KK-DATA

Q: What is the CSV import format for custom prefixes?

The CSV must contain at least a code column (number prefix, e.g., 86), and optionally a number column (full number) or a range column (start and end range of numbers). For specific templates, refer to the examples in the KK-DATA Documentation.

The first step in overseas customer acquisition is often building a high-quality phone number pool. Whether you’re testing the detection effectiveness of Telegram or WhatsApp in different countries, or supplementing raw data for subsequent screening tasks, random number generation by country is a critical part. By batch generating random numbers per country, you can quickly build a number set covering target markets, and then use the platform’s number screening feature to verify the real validity of the numbers. This tutorial will detail the complete process of using KK-DATA’s global number generation module, from country selection, prefix configuration, task submission, export, to connecting with screening.

Why Do You Need to Generate Random Numbers by Country for Overseas Customer Acquisition?

In overseas promotion, having a set of target country phone numbers is the prerequisite to start detection and marketing. However, in real business, you may face the following scenarios:

Testing platform features: Before formally purchasing data, you need a small batch of random numbers to verify the accuracy and speed of Telegram/WhatsApp detection.
Supplementing raw data: When you have insufficient numbers or incomplete country coverage, you need to quickly expand the number pool for a specific country.
Simulating user behavior in different countries: Analyze the activity characteristics of users in different regions, providing references for subsequent DM strategies.
Building a number pool before batch screening: Submit the generated large batch of numbers to the screening module in one go to detect valid and active numbers, avoiding direct purchase of numbers with unknown quality.

KK-DATA’s global number generation module supports random number generation for 240+ countries/regions, and offers two methods: quick generation using global number prefixes, and custom prefix CSV import. Generation is completely free; you are only charged per number when you submit them to subsequent screening tasks (Telegram/WhatsApp/iMessage, etc.). This allows you to build an initial number pool at zero cost, then pay only for screening as needed, greatly reducing trial costs.

Prerequisites: Register an Account and Top Up Balance

Before using the generation module, you need to ensure you have a KK-DATA console account and sufficient balance for subsequent screening (generation itself does not deduct fees).

Log in to the KK-DATA Console

Visit https://app.kkdata.cc/. You can register with an email or quickly log in via your Telegram account. After logging in for the first time, it is recommended to browse the left menu to get familiar with core modules such as “Global Number Generation”, “Global Number Screening”, and “Data Deduplication Warehouse”.

USDT Top-up and Balance Check

Generating numbers does not consume balance, but subsequent screening and detection will deduct fees. Top-up is only supported via USDT (TRC20), with a minimum top-up of approximately 50 USDT. After the funds arrive, the balance is automatically updated. You can view your current balance on the console homepage or in your personal center.

Tip: Generation is free, screening charges per number

The Global Number Generation module is completely free and does not consume balance. You are only charged per detection when you submit generated numbers to subsequent screening steps (such as Telegram/WhatsApp detection). Therefore, it is recommended to generate numbers in bulk first, then submit screening tasks in batches.

Once you have topped up, you can start generating tasks.

Step 1: Enter the “Global Number Generation” Module

Find “Global Number Generation” in the left menu of the console and click to enter.
You will see the main operation interface, including country selection, generation method, quantity settings, output format, etc.

Select Target Country or Region

Click the country dropdown list, which supports search. The list covers 240+ countries/regions. For hot overseas markets, examples include: United States, India, Indonesia, Brazil, Russia, Philippines, etc., all directly selectable. It is recommended to prioritize your target marketing countries.

Configure Number Quantity and Output Format

Quantity: Enter the total number of numbers you want to generate (e.g., 1000, 5000, 10000). The system will automatically calculate the maximum possible quantity based on the selected country and prefix range.
Output format: Check whether to display international dialing codes (e.g., +86), whether to include country abbreviation fields, etc. It is generally recommended to keep the dialing code for direct use in subsequent screening tasks.

Click “Next” to proceed to the prefix configuration stage.

Step 2: Generate Based on Prefixes or Import Custom Prefixes

KK-DATA offers three number generation paths: random full numbers, bulk generation by global number prefixes, and CSV import of custom prefixes. The following focuses on the two commonly used operations.

Fast Generation Using Global Number Prefixes

After selecting a country, the system automatically lists the known number prefixes for that country (e.g., the first few digits of US mobile numbers: 201, 202, 212, etc.). You can check the desired prefixes and specify the quantity for each prefix. If multiple prefixes are selected, the total quantity will be automatically summed.

Advantages: Fast, accurate, prefixes come from real operator data, resulting in high compliance of generated numbers.
Applicable scenarios: You have a basic understanding of target country prefixes and want to quickly obtain a reliable batch of numbers.

Upload CSV for Custom Prefixes

If you have a specific list of prefixes (e.g., number prefixes obtained from other data sources), you can upload a CSV file to customize prefixes.

CSV file format requirements:

Must contain at least one column named code (number prefix, e.g., 86 or 1).
Optional columns: number (full number) or range (number range). If only prefixes are provided, the system will randomly complete the remaining digits based on the prefix.

Note: CSV import format

When importing custom prefixes, ensure the CSV file contains a code column or fill according to the document template; otherwise, parsing may fail. For detailed format examples, see KK-DATA Documentation.

Custom prefixes are suitable for scenarios where you need strict control over number distribution (e.g., only generating numbers with specific city area codes).

Step 3: Submit the Generation Task and View Results

After configuration, click the “Start Generation” button. Since the generation module is completely free, the task will execute immediately (no queue waiting) and usually completes within seconds to tens of seconds, depending on the quantity.

After generation, a preview table is displayed:

Contains fields such as phone number, country, dialing code, generation time, etc.
You can click “Download Sample” to get the first 100 entries to check the format, confirming that the numbers meet expectations (e.g., include international dialing code, uniform format).

At this point, the numbers have been generated and stored in the console’s temporary task list. You can return anytime to view historical generation tasks and re-download results.

Step 4: Export Numbers and Connect with Screening Tasks

Generation is only the first step; the real value lies in using the numbers for subsequent screening (detecting Telegram registration, WhatsApp validity, activity, etc.). Therefore, you need to export the numbers and submit them to the screening module.

Export Format Options

On the task details page, click the “Export” button and choose a format:

Format	Content Characteristics	Applicable Scenarios
CSV	Contains multiple columns (number, country, dialing code, generation time, etc.), rich structure	For subsequent data analysis, deduplication, import into CRM
TXT	Pure numbers, one per line, with or without dialing code	Direct paste into screening tasks or batch import

It is recommended to choose CSV format because it retains the country field, making cross-task deduplication easier.

Directly Initiate a Screening Task

After export, return to the console homepage or enter the “Global Number Screening” module, and click “New Screening Task”:

Paste the exported numbers into the input box (you can also upload a CSV/TXT file).
Select detection type: e.g., Telegram Validity Detection, Telegram Activity Detection, WhatsApp Validity Detection, etc.
See the real-time price for each platform in the console.
The system will automatically estimate the cost based on the number quantity; confirm and submit.

This completes an efficient pipeline of Generate → Screen → Export. Generate once, screen multiple times, avoiding repeated generation.

Notes and Best Practices

Avoid number duplication: When generating numbers multiple times for the same country, duplicate numbers may occur. It is recommended to use KK-DATA’s “Data Deduplication Warehouse” feature to import generated numbers for deduplication, preventing waste of balance in subsequent screening.
Initial quantity suggestion: When using the generation module for the first time, it is recommended to generate 5000–10,000 numbers, combine them with one screening task, and verify detection efficiency and result quality. Adjust as needed later.
Improve hit rate: Prioritize using the system’s built-in global number prefixes, which come from real operator data, making the generated numbers more likely to be real. When using custom prefixes, ensure the prefixes belong to the country’s mobile number range.
Monitor real-time pricing: Different detection types may have different unit prices (e.g., Telegram Validity Detection vs. Activity Detection). Check the console’s real-time price table before submitting a screening task.
No limit on generation tasks: The generation module is free and has no usage limits. You can generate repeatedly as needed, but be careful not to exceed a single task’s maximum of approximately 1 million numbers.

Frequently Asked Questions

Q: Is number generation charged?

A: The Global Number Generation module is completely free and does not consume balance. Charges per number only apply when you perform subsequent number screening (e.g., Telegram/WhatsApp detection).

Q: Can I generate numbers for multiple countries at the same time?

A: Currently, one task can only select one country. To generate numbers for multiple countries, please create separate tasks and merge the exported results.

Q: Are the generated numbers real and existing?

A: All numbers are generated randomly based on each country’s number prefix rules and are not guaranteed to be real/usable. It is recommended to use the platform’s screening functions (e.g., validity detection, activity detection) to verify and filter out valid numbers after generation.

Q: What is the CSV import format for custom prefixes?

A: The CSV must contain at least a code column (number prefix, e.g., 86), and optionally a number column (full number) or a range column (start and end range of numbers). For specific templates, refer to the examples in the KK-DATA Documentation.

Q: Can the generated numbers be used directly for DM promotion?

A: It is not recommended to directly use numbers that have not been screened. It is strongly advised to first use KK-DATA’s Telegram/WhatsApp screening function to detect registration status and activity, and then decide whether to use them for promotion, to improve efficiency and avoid waste.

Through the four steps above, you have mastered the complete process of using KK-DATA for random number generation by country. From selecting a country, configuring prefixes, generating and exporting, to connecting with screening – all operations are completed within the console without any development experience. Go ahead and try it now:

Log in to the console and generate numbers for free: https://app.kkdata.cc/
Read the full documentation for advanced usage: https://docs.kkdata.cc/
For bulk acquisition of specific prefixes or technical support, contact Telegram customer service: @kkdata_cc

National Number Random Generation Tutorial: Using KK-DATA to Generate Random Numbers by Country in Batches

关于作者