Metadata-Version: 2.4
Name: getdr
Version: 0.3.0
Summary: Check Ahrefs Domain Rating (DR) for domains from the command line – one, a list, a file or stdin
Keywords: ahrefs,domain-rating,dr,seo,cli
Author-email: Index Pages <mail@index-pages.com>
License-Expression: MIT
License-File: LICENSE
Project-URL: Homepage, https://index-pages.com/getdr/
Project-URL: Source, https://github.com/index-pages/getdr
Project-URL: Changelog, https://github.com/index-pages/getdr/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/index-pages/getdr/issues
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Go
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown

# getdr

`getdr` is a small open-source command-line tool by [Index Pages](https://index-pages.com) that checks
Ahrefs Domain Rating (DR) for one domain, a list, a file or stdin. It uses only the official free Ahrefs
endpoint, keeps a local history of every check in SQLite, and can run as a tiny HTTP API (`getdr serve`)
so every machine and agent on your network shares one cache and one key.

Docs: [index-pages.com/getdr/](https://index-pages.com/getdr/) · Source: [github.com/index-pages/getdr](https://github.com/index-pages/getdr)

## Install

```sh
pipx install getdr
uv tool install getdr
pip install getdr
```

The wheels hold the prebuilt static binary for your platform and no Python code; nothing runs at install
time. Linux (glibc and musl), macOS 11+ and Windows on x86_64 and arm64 are covered.

Homebrew: `brew install index-pages/tap/getdr`. Docker: `ghcr.io/index-pages/getdr`.

## Get a free Ahrefs API key

Requests to the Domain Rating endpoint are free, but need an API key: sign up for a free
[Ahrefs](https://ahrefs.com/) account, open Account settings → API keys, create a key and export it:

```sh
export AHREFS_KEY=your-key
getdr key check
```

## Quick start

```sh
getdr index-pages.com                   # card on a terminal
getdr a.com b.com c.com                 # several targets, sorted by DR
getdr -f domains.txt --format json      # NDJSON, one object per line
cat domains.txt | getdr > dr.tsv        # pipe: tab-separated domain and DR
getdr index-pages.com --version dr3     # the previous DR formula
```

All flags, output formats, the config file and the HTTP API: [index-pages.com/getdr/](https://index-pages.com/getdr/).

Domain Rating data comes from [Ahrefs](https://ahrefs.com/) and is subject to the
[Domain Rating License](https://ahrefs.com/legal/domain-rating-license). getdr is not affiliated with Ahrefs.

MIT license. Made by [Index Pages](https://index-pages.com).
