From e83756d68e105a795ed7593cd27ed6ddb6ff76c5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wizard=20Loop=20=F0=9F=A7=99=E2=80=8D=E2=99=82=EF=B8=8F?= <67387949+WizardLoop@users.noreply.github.com> Date: Mon, 26 Jan 2026 11:31:19 +0200 Subject: [PATCH 1/5] Revise README for clarity Updated README to clarify project purpose and usage instructions. --- README.md | 66 +++---------------------------------------------------- 1 file changed, 3 insertions(+), 63 deletions(-) diff --git a/README.md b/README.md index dc0084e..b64fa17 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,9 @@ # 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) @@ -13,8 +11,7 @@ ## 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. @@ -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 --- @@ -85,47 +80,7 @@ https://wizardloop.github.io/CreationDate/api/?userid=208238248 --- -## 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 - Date: Mon, 26 Jan 2026 11:32:08 +0200 Subject: [PATCH 2/5] Remove API usage details from README Removed API usage section from README. --- README.md | 32 -------------------------------- 1 file changed, 32 deletions(-) diff --git a/README.md b/README.md index b64fa17..f695040 100644 --- a/README.md +++ b/README.md @@ -48,38 +48,6 @@ 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 algorithm The **core estimation algorithm** is implemented separately for reuse in other projects: From 78a4b96adbbc812f5b715af1cb1acfe3b7ca2dd3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wizard=20Loop=20=F0=9F=A7=99=E2=80=8D=E2=99=82=EF=B8=8F?= <67387949+WizardLoop@users.noreply.github.com> Date: Mon, 26 Jan 2026 11:34:26 +0200 Subject: [PATCH 3/5] Fix accuracy timeframes in README --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index f695040..4c6dc3c 100644 --- a/README.md +++ b/README.md @@ -69,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**. From 5f3abdb7dcd73a2c64eaece3424fb5875b8dc9ee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wizard=20Loop=20=F0=9F=A7=99=E2=80=8D=E2=99=82=EF=B8=8F?= <67387949+WizardLoop@users.noreply.github.com> Date: Mon, 26 Jan 2026 11:40:12 +0200 Subject: [PATCH 4/5] Update CHANGELOG for version 1.0.1 Added version 1.0.1 with a fix for accuracy timeframes. --- CHANGELOG.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 3e8ddaf..e67ed91 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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`) @@ -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 From c881825e370abfa68f685d7e78b2a6835469e9f5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wizard=20Loop=20=F0=9F=A7=99=E2=80=8D=E2=99=82=EF=B8=8F?= <67387949+WizardLoop@users.noreply.github.com> Date: Mon, 26 Jan 2026 11:46:26 +0200 Subject: [PATCH 5/5] Add language-specific rules to .gitignore --- .gitignore | 3 +++ 1 file changed, 3 insertions(+) diff --git a/.gitignore b/.gitignore index 0eef7fb..a8495f0 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,6 @@ +examples/php/*.php linguist-language=PHP +examples/python/*.py linguist-language=Python + # Node / JavaScript node_modules/ dist/