# Artifact Hub API
> Artifact Hub — the CNCF registry for cloud-native packages — as an API. Look up any Helm chart, OLM operator, Falco rule, OPA / Kyverno / Gatekeeper policy, Krew kubectl plugin, Tekton task and more for its version and app version, description, license, maintainers, keywords, repository (with verified-publisher and official flags), home and source links, and its full version history. Search the registry across any package kind. Covers the Kubernetes / cloud-native ecosystem from the Bitnami, Prometheus and Grafana Helm charts to Krew plugins and security policies. Live from the official artifacthub.io API. Ideal for GitOps and DevOps dashboards, supply-chain and update tooling, internal chart catalogs and Kubernetes platform engineering. Open data from Artifact Hub.

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

## Pricing
- **Free** (Free) — 3,710 calls/Mo, 2 req/s
- **Starter** ($5/Mo) — 50,200 calls/Mo, 8 req/s
- **Pro** ($14/Mo) — 246,000 calls/Mo, 20 req/s
- **Mega** ($36/Mo) — 1,218,000 calls/Mo, 50 req/s

## Endpoints

### Artifact Hub

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

**Parameters:**
- `repo` (query, required, string) — Repository name, e.g. bitnami Example: `bitnami`
- `name` (query, required, string) — Package name, e.g. nginx Example: `nginx`
- `kind` (query, optional, string) — Package kind (default helm): olm/krew/falco/kyverno/gatekeeper/tekton-task/...

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/artifacthub-api/v1/package?repo=bitnami&name=nginx"
```

**Response:**
```json
{
    "data": {
        "package": {
            "kind": "Helm chart",
            "name": "nginx",
            "links": [
                {
                    "url": "https://github.com/bitnami/charts/tree/main/bitnami/nginx",
                    "name": "source"
                }
            ],
            "signed": true,
            "license": null,
            "version": "24.0.4",
            "home_url": "https://bitnami.com",
            "keywords": [
                "nginx",
                "http",
                "web",
                "www",
                "reverse proxy"
            ],
            "official": false,
            "created_at": "2026-05-30T15:32:17.000Z",
            "deprecated": false,
            "repository": {
                "url": "https://charts.bitnami.com/bitnami",
                "name": "bitnami",
                "official": false,
                "display_name": "Bitnami",
                "organization": "bitnami",
                "verified_publisher": true
            },
            "app_version": "1.31.1",
            "content_url": "oci://registry-1.docker.io/bitnamicharts/nginx:24.0.4",
            "description": "NGINX Open Source is a web server that can be also used as a reverse proxy, load balancer, and HTTP cache. Recommended for high-demanding sites due to its ability to provide faster content.",
            "maintainers": [],
            "display_name": "nginx",
            "version_count": 240,
            "artifacthub_url": "
…(truncated, see openapi.json for full schema)
```

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

**Parameters:**
- `q` (query, required, string) — Search term Example: `postgres`
- `kind` (query, optional, string) — Package kind (default helm)
- `limit` (query, optional, string) — Results (1-60, default 20)

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

**Response:**
```json
{
    "data": {
        "kind": "helm",
        "count": 20,
        "query": "postgres",
        "results": [
            {
                "name": "postgresql",
                "repo": "bitnami",
                "stars": 418,
                "version": "18.6.10",
                "official": false,
                "app_version": "18.4.0",
                "description": "PostgreSQL (Postgres) is an open source object-relational database known for reliability and data integrity. ACID-compliant, it supports foreign keys, joins, views, triggers and stored procedures.",
                "display_name": "postgresql",
                "artifacthub_url": "https://artifacthub.io/packages/helm/bitnami/postgresql"
            },
            {
                "name": "postgres",
                "repo": "cloudpirates-postgres",
                "stars": 23,
                "version": "0.19.5",
                "official": false,
                "app_version": "18.4.0",
                "description": "The World's Most Advanced Open Source Relational Database",
                "display_name": "postgres",
                "artifacthub_url": "https://artifacthub.io/packages/helm/cloudpirates-postgres/postgres"
            },
            {
                "name": "postgres",
                "repo": "groundhog2k",
                "stars": 16,
                "version": "1.6.4",
                "official": false,
                "app_version": "18.4",
                "description": "A Helm chart for
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/versions` — Version history

**Parameters:**
- `repo` (query, required, string) — Repository name, e.g. bitnami Example: `bitnami`
- `name` (query, required, string) — Package name, e.g. postgresql Example: `postgresql`
- `kind` (query, optional, string) — Package kind (default helm)
- `limit` (query, optional, string) — Max versions (1-500, default 50)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/artifacthub-api/v1/versions?repo=bitnami&name=postgresql"
```

**Response:**
```json
{
    "data": {
        "kind": "helm",
        "count": 50,
        "total": 392,
        "latest": "18.6.10",
        "package": "bitnami/postgresql",
        "versions": [
            {
                "version": "18.6.10",
                "released": "2026-05-30T17:28:32.000Z",
                "app_version": "18.4.0"
            },
            {
                "version": "18.6.9",
                "released": "2026-05-30T02:47:26.000Z",
                "app_version": "18.4.0"
            },
            {
                "version": "18.6.8",
                "released": "2026-05-28T09:49:59.000Z",
                "app_version": "18.4.0"
            },
            {
                "version": "18.6.7",
                "released": "2026-05-18T09:22:57.000Z",
                "app_version": "18.4.0"
            },
            {
                "version": "18.6.6",
                "released": "2026-05-13T18:46:50.000Z",
                "app_version": "18.4.0"
            },
            {
                "version": "18.6.5",
                "released": "2026-05-13T08:03:38.000Z",
                "app_version": "18.3.0"
            },
            {
                "version": "18.6.4",
                "released": "2026-05-08T19:35:58.000Z",
                "app_version": "18.3.0"
            },
            {
                "version": "18.6.3",
                "released": "2026-05-07T14:18:37.000Z",
                "app_version": "18.3.0"
            },
            {
              
…(truncated, see openapi.json for full schema)
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "Live Artifact Hub data. /v1/package = package metadata (version, app version, license, maintainers, repository, links); /v1/versions = version history; /v1/search = search the registry. Default kind is helm; pass kind=olm/krew/falco/gatekeeper/kyverno/tekton-task/etc. Packages are addressed by repo + name (e.g. repo=bitnami&name=nginx).",
        "kinds": [
            "helm",
            "falco",
            "opa",
            "olm",
            "operator",
            "tbaction",
            "krew",
            "helm-plugin",
            "tekton-task",
            "keda",
            "coredns",
            "keptn",
            "tekton-pipeline",
            "container",
            "kubewarden-policy",
            "gatekeeper",
            "kyverno",
            "knative-client-plugin",
            "backstage",
            "argo-template",
            "kubearmor",
            "kcl",
            "headlamp",
            "inspektor-gadget",
            "tekton-stepaction",
            "meshery-design"
        ],
        "source": "Artifact Hub — the CNCF registry for cloud-native packages (artifacthub.io)",
        "endpoints": [
            "/v1/package",
            "/v1/versions",
            "/v1/search",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-05-31T14:41:26.190Z",
        "request_id": "da0f3faf-1c0b-44aa-a53a-7373bdded0e4"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success"
…(truncated, see openapi.json for full schema)
```


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