Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,3 +1,6 @@
examples/php/*.php linguist-language=PHP
examples/python/*.py linguist-language=Python

# Node / JavaScript
node_modules/
dist/
Expand Down
4 changes: 3 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,6 @@ All notable changes to this project will be documented in this file.
- Core estimation algorithm implemented in:
- PHP (`examples/php/estimate.php`)
- Python (`examples/python/estimate.py`)
- Static API interface (`api/index.html` + `api.js`)
- Documentation (`README.md`, `data/README.md`)
- Schema file for dataset (`data/schema.json`)
- Contribution guidelines (`.github/CONTRIBUTING.md`)
Expand All @@ -34,4 +33,7 @@ All notable changes to this project will be documented in this file.

---

## [1.0.1] - 2026-01-26

### Fixed
- Fix accuracy timeframes
104 changes: 6 additions & 98 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,17 @@
# CreationDate

[![Accuracy](https://img.shields.io/badge/accuracy-weeks_to_month-green)](#accuracy--limitations)
[![Platform](https://img.shields.io/badge/platform-browser%20%7C%20static-lightgrey)](#api-usage)
[![Status](https://img.shields.io/badge/status-stable-brightgreen)](#)

[![GitHub issues](https://img.shields.io/github/issues/wizardloop/CreationDate)](https://github.com/wizardloop/CreationDate/issues)
[![License](https://img.shields.io/github/license/wizardloop/CreationDate)](LICENSE)

[![GitHub stars](https://img.shields.io/github/stars/wizardloop/CreationDate?style=social)](https://github.com/wizardloop/CreationDate)
[![GitHub forks](https://img.shields.io/github/forks/wizardloop/CreationDate?style=social)](https://github.com/wizardloop/CreationDate)

---

## Overview

**CreationDate** is a lightweight, browser-based API and dataset for estimating
the **creation date of Telegram private user accounts** using only their numeric **UserID**.
**CreationDate** is a project for estimating the **creation date of Telegram user account** using only their numeric **UserID**.

The project is based on a curated dataset of Telegram accounts with **known creation dates**,
collected over several years, and applies **linear interpolation** to estimate unknown accounts.
Expand All @@ -27,9 +24,7 @@ No Telegram API, no authentication, no backend, no rate limits.

- Estimate Telegram account creation date from UserID
- Returns exact date (`YYYY-MM-DD`) and human-readable account age
- Fully client-side (static files only)
- Reusable core algorithm (PHP / Python examples included)
- Easy GitHub Pages deployment
- Transparent and auditable dataset

---
Expand All @@ -53,79 +48,7 @@ For a given UserID, the algorithm:

---

## API Usage

The API is fully static and browser-based.

### Endpoint

`/api/?userid=TELEGRAM_USER_ID`

### Example

https://wizardloop.github.io/CreationDate/api/?userid=208238248

### Successful Response

```json
{
"userid": 208238248,
"creation_date": "2016-04-10",
"account_age": "8 years"
}
```

### Error Response

```json
{
"error": "Invalid userid"
}
```

---

## Using the API from Code

### JavaScript (Browser)

```javascript
fetch("https://wizardloop.github.io/CreationDate/api/?userid=208238248")
.then(res => res.json())
.then(data => console.log(data));
```

### PHP

```php
<?php
$json = file_get_contents(
"https://wizardloop.github.io/CreationDate/api/?userid=208238248"
);
$data = json_decode($json, true);
print_r($data);
```

### Python

```python
import requests

url = "https://wizardloop.github.io/CreationDate/api/?userid=208238248"
print(requests.get(url).json())
```

### cURL / Bash

```bash
curl "https://wizardloop.github.io/CreationDate/api/?userid=208238248"
```

---

## Offline / Embedded Usage

The API is optional.
## Using the algorithm

The **core estimation algorithm** is implemented separately for reuse in other projects:

Expand All @@ -146,9 +69,9 @@ publicly observed UserID growth patterns.

### Typical Accuracy

- Older accounts (pre-2020): ± weeks to months
- Mid-range accounts: ± days to weeks
- Very recent accounts: may vary significantly
- Older accounts: ± weeks to month
- Mid-range accounts: ± weeks to months
- Very recent accounts: ± weeks to months

Accuracy is generally **month-level reliable** and **year-level very reliable**.

Expand Down Expand Up @@ -189,21 +112,6 @@ See:

---

## Deployment

CreationDate can be deployed on any static host.

### GitHub Pages (Recommended)

1. Push the repository to GitHub
2. Go to **Settings → Pages**
3. Select the branch and root (or `/api`)
4. Access the API via:

https://wizardloop.github.io/CreationDate/api/?userid=USER_ID

---

## Project Structure

```
Expand Down