Telegram ID Age

Estimate Telegram account creation dates from user IDs.

Features

• Estimate Telegram account creation date from numeric IDs.
• Human-readable age output (months/years).
• Lightweight and easy to use.
• Extend the dataset dynamically with estimator.addDataset().

Installation

# Using npm
npm install telegram-id-age

# Or using pnpm
pnpm add telegram-id-age

Usage

import { estimator } from 'telegram-id-age';

// Example ID
const id = 1350180828;

const { status, date } = estimator.getDate(id);
const ageDisplay = estimator.formatAge(date);
const year = date.getUTCFullYear();

console.log(`ID:     ${id}`);
console.log(`Year:   ${year}`);
console.log(`Age:    ${ageDisplay}`);
console.log(`Status: ${status}`);

Extending Dataset

You can dynamically add additional datasets without modifying the original package:

import { estimator } from 'telegram-id-age';

// Add a JSON file with additional IDs
estimator.addDataset('./my-new-ids.json');

The JSON file must follow the strict format:

[
  { "id": "135792", "date": "2026-01-10" },
  { "id": "246801", "date": "2027-07-05" }
]

Dates must be in YYYY-MM-DD format. Invalid entries are skipped automatically.

Accuracy Note

The accuracy of the age estimates depends on the dataset. More data means better estimates.

Currently, the dataset only includes accounts collected between 2013-11-01 and 2025-11-11. If you need estimates outside this range, you can either:

1. Extend the dataset dynamically using estimator.addDataset().
2. Or connect a Telegram account and update the dataset using the updater script (requires cloning the repo).

Update Dataset (Optional, requires cloning)

# Clone the repo
git clone https://github.com/jobians/telegram-id-age.git
cd telegram-id-age

# Install dependencies including Telegram (needed only for updater)
npm install telegram dotenv

# Run the updater
npm run update
# or
node src/updateDataset.js

Make sure you set your .env file with:

TELEGRAM_API_ID=your_api_id
TELEGRAM_API_HASH=your_api_hash
TELEGRAM_SESSION="optional_saved_session_string"
DATASET_PATH=dataset.json

💖 Donate

If you like this plugin and want to support development, you can donate using crypto:

Donate here

📜 License

MIT License © 2025 JOBIANSTECHIE