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/ 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 diff --git a/README.md b/README.md index dc0084e..4c6dc3c 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 --- @@ -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 -