Skip to content

lutfizp/Number2Gram

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Number2Gram Checker

Python Version License Maintenance

                                                                                    
▄▄▄    ▄▄▄                ▄▄                ▄▄▄▄▄▄▄   ▄▄▄▄▄▄▄                       
████▄  ███                ██                ▀▀▀▀████ ███▀▀▀▀▀                       
███▀██▄███ ██ ██ ███▄███▄ ████▄ ▄█▀█▄ ████▄    ▄██▀  ███       ████▄  ▀▀█▄ ███▄███▄ 
███  ▀████ ██ ██ ██ ██ ██ ██ ██ ██▄█▀ ██ ▀▀  ▄███▄▄▄ ███  ███▀ ██ ▀▀ ▄█▀██ ██ ██ ██ 
███    ███ ▀██▀█ ██ ██ ██ ████▀ ▀█▄▄▄ ██    ████████ ▀██████▀  ██    ▀█▄██ ██ ██ ██ 
 ▄▄▄▄▄▄▄ ▄▄                                                                         
███▀▀▀▀▀ ██                ▄▄                                                       
███      ████▄ ▄█▀█▄ ▄████ ██ ▄█▀ ▄█▀█▄ ████▄                                       
███      ██ ██ ██▄█▀ ██    ████   ██▄█▀ ██ ▀▀                                       
▀███████ ██ ██ ▀█▄▄▄ ▀████ ██ ▀█▄ ▀█▄▄▄ ██                                          
                                             
(c) Copyright by LTFZP 2025

number2gram checker is a high-performance technical utility designed for Instagram account registration discovery via phone numbers. By leveraging Instagram's GraphQL endpoints and implementing sophisticated session management, the tool provides accurate verification of account existence while adhering to security best practices.

Features

  • High-Accuracy Verification: Utilizes direct GraphQL queries to confirm registration status.
  • Batch Processing: Efficiently handles large lists of phone numbers from .txt or .csv files.
  • Intelligent Rate Limiting: Built-in safety mechanisms including randomized delays, session rotation, and automatic cooldown periods.
  • Dynamic Token Extraction: Real-time retrieval of CSRF, revision IDs, and session cookies to mimic legitimate browser behavior.
  • Flexible Interface: Support for single-target lookup, interactive shell, and batch execution via CLI arguments.

Installation

  1. Clone or download the project files.
  2. Ensure Python 3.8 or higher is installed.
  3. Install the required dependencies:
pip install -r requirements.txt

Usage

Command Line Interface

number2gram checker supports multiple execution modes to fit different workflows:

Batch Mode (Recommended):

python ig_checker.py --file numbers.txt --output results.csv

Single Lookup:

python ig_checker.py --number 08123456789

Interactive Mode:

python ig_checker.py

Country Code Support

number2gram checker includes a smart normalization engine that automatically formats local numbers into international formats. By default, the following country codes are supported:

Region Country Code Prefix
Asia Indonesia ID +62
Singapore SG +65
Malaysia MY +60
Thailand TH +66
Philippines PH +63
Vietnam VN +84
Japan JP +81
South Korea KR +82
China CN +86
India IN +91
UAE AE +971
Europe United Kingdom GB +44
Germany DE +49
France FR +33
Italy IT +39
Spain ES +34
Netherlands NL +31
Switzerland CH +41
Russia RU +7
Americas United States US +1
Canada CA +1
Mexico MX +52
Brazil BR +55
Oceania Australia AU +61
New Zealand NZ +64
Other Saudi Arabia SA +966
South Africa ZA +27

Customizing Country Codes

You can easily extend the supported countries by editing the COUNTRY_PREFIXES dictionary at the beginning of the ig_checker.py script. Simply add the ISO country code and its corresponding international prefix.

Data Preparation

For batch operations, you can prepare your data in the following formats:

Text Files (.txt)

List one phone number per line. The script automatically handles international prefixing (e.g., converting 08... to 628...).

08123456789
628123456789

CSV Files (.csv)

The script reads phone numbers from the first column of the CSV file. Results are saved to a new CSV file containing both the number and its registration status.

Technical Safeguards

To prevent IP blacklisting and maintain service stability, number2gram checker implements:

  • Random Delays: 30 to 60 seconds between individual requests.
  • Session Cooling: Automatic 60-second pause every 5 requests.
  • Rate Limit Recovery: Mandatory 10-minute sleep interval upon detection of HTTP 429 (Rate Limited) status.

Disclaimer

This software is provided for educational and authorized security auditing purposes only. Users are responsible for ensuring their use of this tool complies with Instagram's Terms of Service and applicable privacy laws.

License

This project is licensed under the MIT License.

Contributors

Languages