11# CreationDate
22
3- [ ![ Accuracy] ( https://img.shields.io/badge/accuracy-weeks_to_month-green )] ( #accuracy--limitations )
4- [ ![ Platform] ( https://img.shields.io/badge/platform-browser%20%7C%20static-lightgrey )] ( #api-usage )
53[ ![ Status] ( https://img.shields.io/badge/status-stable-brightgreen )] ( # )
6-
74[ ![ GitHub issues] ( https://img.shields.io/github/issues/wizardloop/CreationDate )] ( https://github.com/wizardloop/CreationDate/issues )
85[ ![ License] ( https://img.shields.io/github/license/wizardloop/CreationDate )] ( LICENSE )
6+
97[ ![ GitHub stars] ( https://img.shields.io/github/stars/wizardloop/CreationDate?style=social )] ( https://github.com/wizardloop/CreationDate )
108[ ![ GitHub forks] ( https://img.shields.io/github/forks/wizardloop/CreationDate?style=social )] ( https://github.com/wizardloop/CreationDate )
119
1210---
1311
1412## Overview
1513
16- ** CreationDate** is a lightweight, browser-based API and dataset for estimating
17- the ** creation date of Telegram private user accounts** using only their numeric ** UserID** .
14+ ** CreationDate** is a project for estimating the ** creation date of Telegram user account** using only their numeric ** UserID** .
1815
1916The project is based on a curated dataset of Telegram accounts with ** known creation dates** ,
2017collected 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.
2724
2825- Estimate Telegram account creation date from UserID
2926- Returns exact date (` YYYY-MM-DD ` ) and human-readable account age
30- - Fully client-side (static files only)
3127- Reusable core algorithm (PHP / Python examples included)
32- - Easy GitHub Pages deployment
3328- Transparent and auditable dataset
3429
3530---
@@ -53,79 +48,7 @@ For a given UserID, the algorithm:
5348
5449---
5550
56- ## API Usage
57-
58- The API is fully static and browser-based.
59-
60- ### Endpoint
61-
62- ` /api/?userid=TELEGRAM_USER_ID `
63-
64- ### Example
65-
66- https://wizardloop.github.io/CreationDate/api/?userid=208238248
67-
68- ### Successful Response
69-
70- ``` json
71- {
72- "userid" : 208238248 ,
73- "creation_date" : " 2016-04-10" ,
74- "account_age" : " 8 years"
75- }
76- ```
77-
78- ### Error Response
79-
80- ``` json
81- {
82- "error" : " Invalid userid"
83- }
84- ```
85-
86- ---
87-
88- ## Using the API from Code
89-
90- ### JavaScript (Browser)
91-
92- ``` javascript
93- fetch (" https://wizardloop.github.io/CreationDate/api/?userid=208238248" )
94- .then (res => res .json ())
95- .then (data => console .log (data));
96- ```
97-
98- ### PHP
99-
100- ``` php
101- <?php
102- $json = file_get_contents(
103- "https://wizardloop.github.io/CreationDate/api/?userid=208238248"
104- );
105- $data = json_decode($json, true);
106- print_r($data);
107- ```
108-
109- ### Python
110-
111- ``` python
112- import requests
113-
114- url = " https://wizardloop.github.io/CreationDate/api/?userid=208238248"
115- print (requests.get(url).json())
116- ```
117-
118- ### cURL / Bash
119-
120- ``` bash
121- curl " https://wizardloop.github.io/CreationDate/api/?userid=208238248"
122- ```
123-
124- ---
125-
126- ## Offline / Embedded Usage
127-
128- The API is optional.
51+ ## Using the algorithm
12952
13053The ** core estimation algorithm** is implemented separately for reuse in other projects:
13154
@@ -146,9 +69,9 @@ publicly observed UserID growth patterns.
14669
14770### Typical Accuracy
14871
149- - Older accounts (pre-2020) : ± weeks to months
150- - Mid-range accounts: ± days to weeks
151- - Very recent accounts: may vary significantly
72+ - Older accounts: ± weeks to month
73+ - Mid-range accounts: ± weeks to months
74+ - Very recent accounts: ± weeks to months
15275
15376Accuracy is generally ** month-level reliable** and ** year-level very reliable** .
15477
@@ -189,21 +112,6 @@ See:
189112
190113---
191114
192- ## Deployment
193-
194- CreationDate can be deployed on any static host.
195-
196- ### GitHub Pages (Recommended)
197-
198- 1 . Push the repository to GitHub
199- 2 . Go to ** Settings → Pages**
200- 3 . Select the branch and root (or ` /api ` )
201- 4 . Access the API via:
202-
203- https://wizardloop.github.io/CreationDate/api/?userid=USER_ID
204-
205- ---
206-
207115## Project Structure
208116
209117```
0 commit comments