# AUR API
> The Arch User Repository (AUR) as an API. Look up any AUR package for its version, description, upstream URL, maintainer and submitter, community votes and popularity score, license, out-of-date flag, keywords and full dependency lists (depends, make-depends, opt-depends), plus its source snapshot and ready-to-run git-clone command; search the whole AUR by name, description, maintainer, dependencies or keywords (results sorted by popularity); and list every package maintained by a given user. Covers the 90,000+ community-maintained packages of Arch Linux, from yay, paru and visual-studio-code-bin to google-chrome and spotify. Live from the official AUR RPC. Ideal for Arch/AUR helpers and dashboards, package and dependency tooling, and Linux developer portals. Open data from the Arch User Repository.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/aur-api/..."
```

## Pricing
- **Free** (Free) — 3,470 calls/Mo, 2 req/s
- **Starter** ($4/Mo) — 46,300 calls/Mo, 8 req/s
- **Pro** ($12/Mo) — 231,000 calls/Mo, 20 req/s
- **Mega** ($33/Mo) — 1,176,000 calls/Mo, 50 req/s

## Endpoints

### AUR

#### `GET /v1/maintainer` — Packages maintained by a user

**Parameters:**
- `name` (query, required, string) — Maintainer username, e.g. jguer Example: `jguer`
- `limit` (query, optional, string) — Results (1-200, default 50)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aur-api/v1/maintainer?name=jguer"
```

**Response:**
```json
{
    "data": {
        "count": 6,
        "total": 6,
        "packages": [
            {
                "url": "https://github.com/Jguer/yay",
                "name": "yay",
                "votes": 2590,
                "license": [],
                "version": "12.5.7-1",
                "submitter": null,
                "maintainer": "jguer",
                "popularity": 48.40602,
                "description": "Yet another yogurt. Pacman wrapper and AUR helper written in go.",
                "out_of_date": null,
                "package_base": "yay",
                "last_modified": "2025-12-14T20:01:41.000Z",
                "first_submitted": "2016-10-05T17:20:04.000Z"
            },
            {
                "url": "https://github.com/Jguer/yay",
                "name": "yay-bin",
                "votes": 365,
                "license": [],
                "version": "12.5.7-1",
                "submitter": null,
                "maintainer": "jguer",
                "popularity": 9.77891,
                "description": "Yet another yogurt. Pacman wrapper and AUR helper written in go. Pre-compiled.",
                "out_of_date": null,
                "package_base": "yay-bin",
                "last_modified": "2025-12-14T20:01:51.000Z",
                "first_submitted": "2016-12-03T15:06:14.000Z"
            },
            {
                "url": "https://github.com/Jguer/yay",
                "name": "yay-git",
                "votes": 55,
             
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/package` — Package metadata + dependencies

**Parameters:**
- `name` (query, required, string) — AUR package name, e.g. yay Example: `yay`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aur-api/v1/package?name=yay"
```

**Response:**
```json
{
    "data": {
        "package": {
            "url": "https://github.com/Jguer/yay",
            "name": "yay",
            "votes": 2590,
            "aur_url": "https://aur.archlinux.org/packages/yay",
            "depends": [
                "pacman>6.1",
                "git"
            ],
            "license": [
                "GPL-3.0-or-later"
            ],
            "version": "12.5.7-1",
            "keywords": [
                "arm",
                "AUR",
                "go",
                "helper",
                "pacman",
                "wrapper",
                "x86"
            ],
            "provides": [],
            "conflicts": [],
            "git_clone": "git clone https://aur.archlinux.org/yay.git",
            "submitter": "jguer",
            "maintainer": "jguer",
            "popularity": 48.40602,
            "description": "Yet another yogurt. Pacman wrapper and AUR helper written in go.",
            "opt_depends": [
                "sudo",
                "doas"
            ],
            "out_of_date": null,
            "make_depends": [
                "go>=1.24"
            ],
            "package_base": "yay",
            "snapshot_url": "https://aur.archlinux.org/cgit/aur.git/snapshot/yay.tar.gz",
            "check_depends": [],
            "last_modified": "2025-12-14T20:01:41.000Z",
            "first_submitted": "2016-10-05T17:20:04.000Z"
        }
    },
    "meta": {
        "timestamp": "2026-05-31T13:58:06.782Z",
   
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search the AUR

**Parameters:**
- `q` (query, required, string) — Search term Example: `docker`
- `by` (query, optional, string) — name | name-desc | desc | maintainer | depends | keywords (default name-desc)
- `limit` (query, optional, string) — Results (1-100, default 20)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aur-api/v1/search?q=docker"
```

**Response:**
```json
{
    "data": {
        "by": "name-desc",
        "count": 20,
        "query": "docker",
        "total": 408,
        "results": [
            {
                "url": "https://docs.docker.com/ai/sandboxes/",
                "name": "docker-sbx",
                "votes": 4,
                "license": [],
                "version": "0.30.0-1",
                "submitter": null,
                "maintainer": "jthurner",
                "popularity": 3.126754,
                "description": "Docker sandboxes - run AI coding agents in isolated microVM sandboxes",
                "out_of_date": null,
                "package_base": "docker-sbx",
                "last_modified": "2026-05-19T13:49:45.000Z",
                "first_submitted": "2026-04-30T14:39:18.000Z"
            },
            {
                "url": "https://docs.docker.com/engine/security/rootless/",
                "name": "docker-rootless-extras",
                "votes": 43,
                "license": [],
                "version": "29.5.2-1",
                "submitter": null,
                "maintainer": "the-k",
                "popularity": 1.528945,
                "description": "Extras to run docker as non-root.",
                "out_of_date": null,
                "package_base": "docker-rootless-extras",
                "last_modified": "2026-05-20T19:14:35.000Z",
                "first_submitted": "2021-04-14T17:58:01.000Z"
            },
            {
                "url": "https://www.docker
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Source & options

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/aur-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Live AUR data. /v1/package = metadata (version, description, maintainer, votes, popularity, dependencies, snapshot + git-clone URL); /v1/search = search the AUR (by=name-desc default; also name/desc/maintainer/depends/keywords); /v1/maintainer = all packages maintained by a user. Results are sorted by popularity.",
        "source": "AUR — the Arch User Repository (aur.archlinux.org)",
        "endpoints": [
            "/v1/package",
            "/v1/search",
            "/v1/maintainer",
            "/v1/meta"
        ],
        "search_by": [
            "name",
            "name-desc",
            "desc",
            "maintainer",
            "depends",
            "makedepends",
            "keywords"
        ]
    },
    "meta": {
        "timestamp": "2026-05-31T13:58:07.055Z",
        "request_id": "0f1fe02d-1bde-406e-b520-564e1c0525b3"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/aur-api
OpenAPI spec: https://www.oanor.com/api/aur-api/openapi.json