# NuGet API
> The NuGet.org registry — the package ecosystem of .NET — as an API. Look up any NuGet package for its description, latest version, total download count, authors, tags, project, license and icon URLs; search the registry by keyword across millions of packages; and list a package's full version history (newest first). Live from the official NuGet APIs. Ideal for package dashboards, dependency and supply-chain tooling, developer portals and .NET ecosystem analytics. Open data from NuGet.org.

## 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/nuget-api/..."
```

## Pricing
- **Free** (Free) — 3,470 calls/Mo, 2 req/s
- **Starter** ($4/Mo) — 48,050 calls/Mo, 8 req/s
- **Pro** ($12/Mo) — 237,600 calls/Mo, 20 req/s
- **Mega** ($33/Mo) — 1,192,500 calls/Mo, 50 req/s

## Endpoints

### NuGet

#### `GET /v1/package` — Full metadata for a package

**Parameters:**
- `id` (query, required, string) — Package id, e.g. Newtonsoft.Json, Serilog Example: `Newtonsoft.Json`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nuget-api/v1/package?id=Newtonsoft.Json"
```

**Response:**
```json
{
    "data": {
        "package": {
            "id": "Newtonsoft.Json",
            "tags": [
                "json"
            ],
            "authors": [
                "James Newton-King"
            ],
            "summary": null,
            "version": "13.0.5-beta1",
            "icon_url": "https://api.nuget.org/v3-flatcontainer/newtonsoft.json/13.0.5-beta1/icon",
            "verified": true,
            "nuget_url": "https://www.nuget.org/packages/Newtonsoft.Json",
            "description": "Json.NET is a popular high-performance JSON framework for .NET",
            "license_url": "https://www.nuget.org/packages/Newtonsoft.Json/13.0.5-beta1/license",
            "project_url": "https://www.newtonsoft.com/json",
            "total_downloads": 8360907153
        }
    },
    "meta": {
        "timestamp": "2026-05-31T10:38:16.456Z",
        "request_id": "f1259cd5-292e-470f-8c66-96162238158b"
    },
    "status": "ok",
    "message": "Package retrieved",
    "success": true
}
```

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

**Parameters:**
- `q` (query, required, string) — Search term Example: `json`
- `prerelease` (query, optional, string) — true = include prerelease packages
- `limit` (query, optional, string) — Results per page (1-100, default 20) Example: `20`
- `skip` (query, optional, string) — Pagination offset Example: `0`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nuget-api/v1/search?q=json&limit=20&skip=0"
```

**Response:**
```json
{
    "data": {
        "skip": 0,
        "count": 20,
        "limit": 20,
        "query": "json",
        "total": 10086,
        "results": [
            {
                "id": "Newtonsoft.Json",
                "tags": [
                    "json"
                ],
                "authors": [
                    "James Newton-King"
                ],
                "summary": null,
                "version": "13.0.4",
                "icon_url": "https://api.nuget.org/v3-flatcontainer/newtonsoft.json/13.0.4/icon",
                "verified": true,
                "nuget_url": "https://www.nuget.org/packages/Newtonsoft.Json",
                "description": "Json.NET is a popular high-performance JSON framework for .NET",
                "license_url": "https://www.nuget.org/packages/Newtonsoft.Json/13.0.4/license",
                "project_url": "https://www.newtonsoft.com/json",
                "total_downloads": 8360907153
            },
            {
                "id": "System.Text.Json",
                "tags": [],
                "authors": [
                    "Microsoft"
                ],
                "summary": null,
                "version": "10.0.8",
                "icon_url": "https://api.nuget.org/v3-flatcontainer/system.text.json/10.0.8/icon",
                "verified": true,
                "nuget_url": "https://www.nuget.org/packages/System.Text.Json",
                "description": "Provides high-performance and low-allocating types that se
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/versions` — Version history of a package

**Parameters:**
- `id` (query, required, string) — Package id, e.g. Serilog Example: `Serilog`
- `limit` (query, optional, string) — Max versions (1-200, default 50) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/nuget-api/v1/versions?id=Serilog&limit=50"
```

**Response:**
```json
{
    "data": {
        "count": 50,
        "total": 595,
        "package": "Serilog",
        "versions": [
            "4.3.2-dev-02433",
            "4.3.2-dev-02430",
            "4.3.2-dev-02419",
            "4.3.2-dev-02418",
            "4.3.1",
            "4.3.1-dev-02415",
            "4.3.1-dev-02406",
            "4.3.1-dev-02404",
            "4.3.1-dev-02395",
            "4.3.1-dev-02390",
            "4.3.1-dev-02387",
            "4.3.1-dev-02385",
            "4.3.1-dev-02383",
            "4.3.1-dev-02373",
            "4.3.0",
            "4.3.0-dev-02364",
            "4.3.0-dev-02363",
            "4.3.0-dev-02361",
            "4.3.0-dev-02360",
            "4.3.0-dev-02358",
            "4.3.0-dev-02357",
            "4.2.1-dev-02356",
            "4.2.1-dev-02355",
            "4.2.1-dev-02352",
            "4.2.1-dev-02340",
            "4.2.1-dev-02337",
            "4.2.0",
            "4.2.0-dev-02332",
            "4.2.0-dev-02331",
            "4.2.0-dev-02330",
            "4.2.0-dev-02328",
            "4.1.1-dev-02320",
            "4.1.1-dev-02318",
            "4.1.1-dev-02314",
            "4.1.0",
            "4.1.0-dev-02312",
            "4.1.0-dev-02311",
            "4.1.0-dev-02302",
            "4.1.0-dev-02301",
            "4.1.0-dev-02238",
            "4.1.0-dev-02235",
            "4.0.2",
            "4.0.2-dev-02232",
            "4.0.2-dev-02226",
            "4.0.2-dev-02224",
            "4.0.2-dev-02220",
            "
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "Live NuGet registry data. /v1/package = full metadata (description, authors, total downloads, project/license/icon URLs, tags) for a package; /v1/search = search the registry by keyword; /v1/versions = the full version list of a package (newest first).",
        "source": "NuGet.org (the .NET package registry)",
        "endpoints": [
            "/v1/package",
            "/v1/search",
            "/v1/versions",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-05-31T10:38:16.999Z",
        "request_id": "8e24ed02-75dd-4edb-9763-c4629f0b09a4"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


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