Skip to content

Commit 883934e

Browse files
authored
Merge pull request #2 from WizardLoop/dev
1.0.1
2 parents 5c1fee6 + c881825 commit 883934e

3 files changed

Lines changed: 12 additions & 99 deletions

File tree

.gitignore

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,6 @@
1+
examples/php/*.php linguist-language=PHP
2+
examples/python/*.py linguist-language=Python
3+
14
# Node / JavaScript
25
node_modules/
36
dist/

CHANGELOG.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,6 @@ All notable changes to this project will be documented in this file.
1313
- Core estimation algorithm implemented in:
1414
- PHP (`examples/php/estimate.php`)
1515
- Python (`examples/python/estimate.py`)
16-
- Static API interface (`api/index.html` + `api.js`)
1716
- Documentation (`README.md`, `data/README.md`)
1817
- Schema file for dataset (`data/schema.json`)
1918
- Contribution guidelines (`.github/CONTRIBUTING.md`)
@@ -34,4 +33,7 @@ All notable changes to this project will be documented in this file.
3433

3534
---
3635

36+
## [1.0.1] - 2026-01-26
3737

38+
### Fixed
39+
- Fix accuracy timeframes

README.md

Lines changed: 6 additions & 98 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,17 @@
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

1916
The project is based on a curated dataset of Telegram accounts with **known creation dates**,
2017
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.
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

13053
The **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

15376
Accuracy 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

Comments
 (0)