Metadata-Version: 2.4
Name: webrank
Version: 3.0.0
Summary: Open domain popularity + authority rank — a free Tranco alternative (webrank + pagerank).
Author-email: "webrank.top" <peter@webrank.top>
License: BSD-3-Clause
Project-URL: Homepage, https://webrank.top
Project-URL: API, https://api.webrank.top
Project-URL: Source, https://github.com/webrank-top/webrank-python
Keywords: domain,rank,popularity,pagerank,tranco,seo,authority
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: BSD License
Classifier: Topic :: Internet
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# webrank (Python)

Official Python client for [**webrank**](https://webrank.top) — the open domain popularity +
authority rank, a free alternative to Tranco. No API key, no rate-limit signup.

Two numbers per domain:
- **`webrank`** — popularity rank (1 = most popular), driven by real user traffic.
- **`pagerank`** — 0–10 link authority (PageRank-style): how much the web links to it.

## Install
```bash
pip install webrank
```

## Use
```python
import webrank

webrank.rank("google.com")
# {'domain': 'google.com', 'webrank': 1, 'webrank_score': 10.0, 'pagerank': 10.0,
#  'sources': 8, 'ranks': {...}, 'updated': '2026-07-15'}

webrank.rank_many(["stripe.com", "gmpg.org"])   # batch, one request
webrank.top(100)                                 # the leaderboard
webrank.history("github.com")                    # monthly trend
```

Or grab the whole list (top 1M, updated daily; monthly snapshots are permanent + citable):
```bash
curl -O https://api.webrank.top/list/webrank-latest.csv.gz
```

## How it works
The rank is a data-driven composite of eight public sources, with weights **derived** from
agreement with real-traffic data (not guessed) — it predicts real user traffic ~46% better than
an equal-weighted list. Full method: <https://webrank.top/methodology>.

## License
Data: CC-BY 4.0. This client: BSD.
