# Artifact Hub

> Find and track cloud-native packages on Artifact Hub, the CNCF's catalogue of Helm charts, operators, OPA, Kyverno and Gatekeeper policies, Falco rules, plugins and more: search packages and repositories, read a package's versions, changelog, security scan, default values and templates, and start a workflow when a package publishes a new version. No account or API key required.

App · 14 actions. Web page: https://docs.lodol.com/docs/integrations/artifact-hub

## Actions

### Get a Helm chart's default values

Get the values.yaml a Helm chart installs with unless told otherwise, as the file itself (with its comments) and as data a later step can read setting by setting.

**Inputs**

- Chart (`package`, text, required): The Helm chart as repository/name, like bitnami/nginx, or the address of its page on artifacthub.io.
- Version (`version`, text): Which version, picked from the list or typed. Empty for the latest.

**Outputs**

- `kind` (text): The kind's name in package addresses, e.g. helm, kyverno or olm (a number for a kind Lodol does not list yet).
- `line_count` (number): How many lines the file has.
- `name` (text): The package's name.
- `package_id` (text): Artifact Hub's id for the package.
- `repository_name` (text): The repository that publishes it.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `top_level_keys` (list): The file's top-level settings, in order.
- `url` (text): The package's page on artifacthub.io.
- `values` (object): The same settings as data, e.g. values.image.tag.
- `values_yaml` (text): The values.yaml file as published, comments included.
- `version` (text): The chart version read.

**Example output**

```json
{
  "kind": "helm",
  "line_count": 7,
  "name": "artifact-hub",
  "package_id": "75ee6e00-b4d5-429e-9d82-33ab730081ff",
  "repository_name": "artifact-hub",
  "summary": "Default values of artifact-hub/artifact-hub 1.23.0: 7 lines, 3 top-level settings.",
  "top_level_keys": [
    "imageTag",
    "pullPolicy",
    "log"
  ],
  "url": "https://artifacthub.io/packages/helm/artifact-hub/artifact-hub",
  "values": {
    "imageTag": "",
    "log": {
      "level": "info",
      "pretty": false
    },
    "pullPolicy": "IfNotPresent"
  },
  "values_yaml": "# Artifact Hub Chart default configuration values\n\nimageTag: \"\"\npullPolicy: IfNotPresent\nlog:\n  level: info\n  pretty: false\n",
  "version": "1.23.0"
}
```

### Get a Helm chart's templates

Get the template files a Helm chart renders into Kubernetes resources (deployments, services, secrets...), each with its full text.

**Inputs**

- Chart (`package`, text, required): The Helm chart as repository/name, like bitnami/nginx, or the address of its page on artifacthub.io.
- Version (`version`, text): Which version, picked from the list or typed. Empty for the latest.

**Outputs**

- `count` (number): How many templates there are.
- `kind` (text): The kind's name in package addresses, e.g. helm, kyverno or olm (a number for a kind Lodol does not list yet).
- `name` (text): The package's name.
- `package_id` (text): Artifact Hub's id for the package.
- `repository_name` (text): The repository that publishes it.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `templates` (list): The template files, by path.
- `url` (text): The package's page on artifacthub.io.
- `version` (text): The chart version read.

**Example output**

```json
{
  "count": 2,
  "kind": "helm",
  "name": "artifact-hub",
  "package_id": "75ee6e00-b4d5-429e-9d82-33ab730081ff",
  "repository_name": "artifact-hub",
  "summary": "2 templates in artifact-hub/artifact-hub 1.23.0.",
  "templates": [
    {
      "content": "{{/* vim: set filetype=mustache: */}}\n{{/*\nExpand the name of the chart.\n*/}}\n",
      "line_count": 4,
      "name": "templates/_helpers.tpl"
    },
    {
      "content": "apiVersion: batch/v1\nkind: Job\nmetadata:\n{{- if .Release.IsInstall }}\n",
      "line_count": 4,
      "name": "templates/db_migrator_job.yaml"
    }
  ],
  "url": "https://artifacthub.io/packages/helm/artifact-hub/artifact-hub",
  "version": "1.23.0"
}
```

### Get a Helm chart's values schema

Get the JSON schema a Helm chart publishes for its settings, with each top-level setting's type, title, description, default and whether it is required.

**Inputs**

- Chart (`package`, text, required): The Helm chart as repository/name, like bitnami/nginx, or the address of its page on artifacthub.io.
- Version (`version`, text): Which version, picked from the list or typed. Empty for the latest.

**Outputs**

- `has_schema` (true/false): False when the chart publishes no values schema.
- `kind` (text): The kind's name in package addresses, e.g. helm, kyverno or olm (a number for a kind Lodol does not list yet).
- `name` (text): The package's name.
- `package_id` (text): Artifact Hub's id for the package.
- `properties` (list): Its top-level settings.
- `property_count` (number): How many top-level settings it describes.
- `repository_name` (text): The repository that publishes it.
- `required` (list): The top-level settings the schema requires.
- `schema` (object): The whole JSON schema. Empty when there is none.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `title` (text): The schema's title.
- `url` (text): The package's page on artifacthub.io.
- `version` (text): The chart version read.

**Example output**

```json
{
  "has_schema": true,
  "kind": "helm",
  "name": "artifact-hub",
  "package_id": "75ee6e00-b4d5-429e-9d82-33ab730081ff",
  "properties": [
    {
      "default_value": "",
      "description": "Defaults to the Chart's appVersion, prefixed with a 'v'.",
      "name": "imageTag",
      "required": false,
      "title": "Tag used when pulling images",
      "type": "string"
    },
    {
      "default_value": "IfNotPresent",
      "description": null,
      "name": "pullPolicy",
      "required": true,
      "title": null,
      "type": "string"
    }
  ],
  "property_count": 2,
  "repository_name": "artifact-hub",
  "required": [
    "pullPolicy"
  ],
  "schema": {
    "properties": {
      "imageTag": {
        "default": "",
        "title": "Tag used when pulling images",
        "type": "string"
      },
      "pullPolicy": {
        "default": "IfNotPresent",
        "enum": [
          "IfNotPresent",
          "Always",
          "Never"
        ],
        "type": "string"
      }
    },
    "required": [
      "pullPolicy"
    ],
    "title": "Artifact Hub Chart JSON Schema",
    "type": "object"
  },
  "summary": "Values schema of artifact-hub/artifact-hub 1.23.0: 2 top-level settings, 1 of them required.",
  "title": "Artifact Hub Chart JSON Schema",
  "url": "https://artifacthub.io/packages/helm/artifact-hub/artifact-hub",
  "version": "1.23.0"
}
```

### Get a package

Get everything Artifact Hub knows about a package, or one version of it: description, versions, licence, maintainers, links, stars, the images it uses, its vulnerability counts and what changed in it.

**Inputs**

- Package (`package`, text, required): The package as repository/name, like bitnami/nginx, or the address of its page on artifacthub.io. Search packages finds both.
- Kind (`package_kind`, text): What sort of package it is. Helm charts unless you pick another; a page address already says. Default: `helm`.
- Version (`version`, text): Which version, picked from the list or typed. Empty for the latest.
- Include README (`include_readme`, true/false): Also return the package's README, in Markdown. Off by default. Default: `false`.

**Outputs**

- `app_version` (text): The version of the software it installs, e.g. 1.31.8.
- `category` (text): Its category, e.g. Networking.
- `changes` (list): What changed in this version, from its changelog.
- `container_images` (list): The container images this version uses.
- `contains_security_updates` (true/false): True when this version fixes security issues.
- `content_url` (text): Where to download this version, e.g. a .tgz or oci:// address.
- `dependencies` (list): The Helm charts this chart depends on.
- `deprecated` (true/false): True when its publisher has deprecated it.
- `description` (text): What it is, in its publisher's words.
- `display_name` (text): Its title, or its name when it has none.
- `has_changelog` (true/false): True when the package publishes a changelog.
- `has_values_schema` (true/false): True when this Helm chart publishes a values schema.
- `home_url` (text): The software's home page.
- `is_latest` (true/false): True when the version described is the newest one.
- `keywords` (list): Keywords its publisher gave it.
- `kind` (text): The kind's name in package addresses, e.g. helm, kyverno or olm (a number for a kind Lodol does not list yet).
- `kind_label` (text): The kind as Artifact Hub's website names it, e.g. Helm charts.
- `latest_version` (text): Its newest version.
- `license` (text): Its licence, as an SPDX id like Apache-2.0.
- `links` (list): Links its publisher gave, such as its source code.
- `logo_url` (text): Its logo.
- `maintainers` (list): Who maintains it.
- `name` (text): Its name, e.g. nginx.
- `official` (true/false): True when the publisher owns the software it packages.
- `package_id` (text): Artifact Hub's id for the package.
- `prerelease` (true/false): True when this version is a pre-release.
- `production_organizations_count` (number): How many organizations say on Artifact Hub that they run it in production.
- `readme` (text): Its README in Markdown, when Include README is on. Empty otherwise.
- `released_at` (text): When this version was released.
- `repository` (object): The repository that publishes it.
- `security` (object): How many known vulnerabilities Artifact Hub's scan found in the images the latest version uses, by severity. Empty when it has not been scanned.
- `security_report_created_at` (text): When Artifact Hub last scanned this version.
- `signatures` (list): How it is signed, e.g. cosign.
- `signed` (true/false): True when this version is signed.
- `stars` (number): How many people have starred it on Artifact Hub.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `url` (text): Its page on artifacthub.io.
- `version` (text): The version described: the one asked for, or the latest.
- `version_count` (number): How many versions it has.
- `version_url` (text): The page of this version on artifacthub.io.

**Example output**

```json
{
  "app_version": "1.23.0",
  "category": null,
  "changes": [
    {
      "description": "Code viewer for large code blocks",
      "kind": "added"
    },
    {
      "description": "Support for mermaid charts in README files",
      "kind": "added"
    }
  ],
  "container_images": [
    {
      "image": "artifacthub/db-migrator:v1.23.0",
      "name": "db-migrator"
    },
    {
      "image": "artifacthub/hub:v1.23.0",
      "name": "hub"
    }
  ],
  "contains_security_updates": true,
  "content_url": "https://artifacthub.github.io/helm-charts/artifact-hub-1.23.0.tgz",
  "dependencies": [
    {
      "name": "postgresql",
      "repository": "https://charts.bitnami.com/bitnami",
      "version": "18.0.15"
    }
  ],
  "deprecated": false,
  "description": "Artifact Hub is a web-based application that enables finding, installing, and publishing Cloud Native packages.",
  "display_name": "artifact-hub",
  "has_changelog": true,
  "has_values_schema": true,
  "home_url": "https://artifacthub.io",
  "is_latest": true,
  "keywords": [
    "kubernetes",
    "helm",
    "falco",
    "opa"
  ],
  "kind": "helm",
  "kind_label": "Helm charts",
  "latest_version": "1.23.0",
  "license": "Apache-2.0",
  "links": [
    {
      "name": "source",
      "url": "https://github.com/artifacthub/hub"
    },
    {
      "name": "support",
      "url": "https://github.com/artifacthub/hub/issues"
    }
  ],
  "logo_url": "https://artifacthub.io/image/35c5d3c7-421e-4b4a-97b0-86f4602a2f59",
  "maintainers": [
    {
      "email": "matt@mattfarina.com",
      "name": "Matt"
    }
  ],
  "name": "artifact-hub",
  "official": true,
  "package_id": "75ee6e00-b4d5-429e-9d82-33ab730081ff",
  "prerelease": false,
  "production_organizations_count": 2,
  "readme": "",
  "released_at": "2026-07-07T14:55:48Z",
  "repository": {
    "cncf": true,
    "display_name": "Artifact Hub",
    "name": "artifact-hub",
    "official": true,
    "organization_name": "artifacthub",
    "publisher": "Artifact Hub",
    "repository_id": "a032a436-3568-4970-804a-2780f5e9d231",
    "url": "https://artifacthub.github.io/helm-charts/",
    "user_alias": null,
    "verified_publisher": true
  },
  "security": {
    "critical": 9,
    "high": 469,
    "low": 229,
    "medium": 527,
    "total": 1249,
    "unknown": 15
  },
  "security_report_created_at": "2026-10-21T08:16:15Z",
  "signatures": [],
  "signed": false,
  "stars": 96,
  "summary": "artifact-hub 1.23.0 (Helm chart by Artifact Hub): 96 stars, 44 versions.",
  "url": "https://artifacthub.io/packages/helm/artifact-hub/artifact-hub",
  "version": "1.23.0",
  "version_count": 44,
  "version_url": "https://artifacthub.io/packages/helm/artifact-hub/artifact-hub/1.23.0"
}
```

### Get a package's changelog

Read what changed in each version of a package (added, changed, fixed, security and so on), newest first, as its publisher recorded it, also written out as Markdown.

**Inputs**

- Package (`package`, text, required): The package as repository/name, like bitnami/nginx, or the address of its page on artifacthub.io. Search packages finds both.
- Kind (`package_kind`, text): What sort of package it is. Helm charts unless you pick another; a page address already says. Default: `helm`.
- Change types (`change_types`, list): Only these kinds of change, such as security fixes. All by default. One or more of: `added`, `changed`, `deprecated`, `removed`, `fixed`, `security`.
- Released since (`released_since`, date): Only versions released on or after this day (UTC).
- Number of versions (`max_versions`, number): The most versions to return, newest first, 1 to 500. 10 by default. From 1 to 500. Default: `10`.

**Outputs**

- `count` (number): How many versions are listed.
- `entries` (list): Each version's changes, newest first.
- `has_changelog` (true/false): False when the package publishes no changelog.
- `kind` (text): The kind's name in package addresses, e.g. helm, kyverno or olm (a number for a kind Lodol does not list yet).
- `markdown` (text): The listed versions' changes as Markdown. Empty when none.
- `name` (text): The package's name.
- `package_id` (text): Artifact Hub's id for the package.
- `repository_name` (text): The repository that publishes it.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total_versions` (number): How many versions match, before Number of versions.
- `url` (text): The package's page on artifacthub.io.

**Example output**

```json
{
  "count": 1,
  "entries": [
    {
      "change_count": 2,
      "changes": [
        {
          "description": "Do not strip underscores from changes descriptions",
          "kind": "fixed",
          "links": []
        },
        {
          "description": "Some issues in router",
          "kind": "fixed",
          "links": []
        }
      ],
      "contains_security_updates": true,
      "prerelease": false,
      "released_at": "2026-07-07T14:55:48Z",
      "version": "1.23.0"
    }
  ],
  "has_changelog": true,
  "kind": "helm",
  "markdown": "# artifact-hub/artifact-hub changelog\n\n## 1.23.0 (2026-07-07)\n- **Fixed:** Do not strip underscores from changes descriptions\n- **Fixed:** Some issues in router",
  "name": "artifact-hub",
  "package_id": "75ee6e00-b4d5-429e-9d82-33ab730081ff",
  "repository_name": "artifact-hub",
  "summary": "2 changes across 1 version of artifact-hub/artifact-hub, newest 1.23.0.",
  "total_versions": 26,
  "url": "https://artifacthub.io/packages/helm/artifact-hub/artifact-hub"
}
```

### Get a package's security report

See the known vulnerabilities Artifact Hub's scanner found in the container images a package version uses: counts by severity, a line per image and the findings themselves, worst first, with the version that fixes each.

**Inputs**

- Package (`package`, text, required): The package as repository/name, like bitnami/nginx, or the address of its page on artifacthub.io. Search packages finds both.
- Kind (`package_kind`, text): What sort of package it is. Helm charts unless you pick another; a page address already says. Default: `helm`.
- Version (`version`, text): Which version, picked from the list or typed. Empty for the latest.
- Lowest severity (`min_severity`, text): Which findings to list. Every severity is counted either way. One of: `critical` (Critical only), `high` (High and critical), `medium` (Medium and above), `low` (Low and above), `all` (Every severity, unknown included). Default: `high`.
- Maximum findings (`max_vulnerabilities`, number): The most findings to list, worst first, 1 to 1,000. 100 by default. From 1 to 1000. Default: `100`.

**Outputs**

- `count` (number): How many findings are listed.
- `counts` (object): Vulnerabilities found, by severity.
- `has_report` (true/false): False when the version has no images to scan.
- `images` (list): One row per scanned image.
- `kind` (text): The kind's name in package addresses, e.g. helm, kyverno or olm (a number for a kind Lodol does not list yet).
- `min_severity` (text): The Lowest severity applied.
- `name` (text): The package's name.
- `package_id` (text): Artifact Hub's id for the package.
- `repository_name` (text): The repository that publishes it.
- `scanned_at` (text): When it was scanned.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total_matching` (number): How many findings are at or above Lowest severity.
- `truncated` (true/false): True when Maximum findings left some out.
- `url` (text): The package's page on artifacthub.io.
- `version` (text): The version whose scan this is.
- `vulnerabilities` (list): The findings at or above Lowest severity, worst first.

**Example output**

```json
{
  "count": 1,
  "counts": {
    "critical": 9,
    "high": 469,
    "low": 229,
    "medium": 527,
    "total": 1249,
    "unknown": 15
  },
  "has_report": true,
  "images": [
    {
      "critical": 3,
      "high": 110,
      "image": "aquasec/trivy:0.69.3",
      "low": 53,
      "medium": 129,
      "os": "alpine 3.23.3",
      "total": 298,
      "unknown": 3
    }
  ],
  "kind": "helm",
  "min_severity": "critical",
  "name": "artifact-hub",
  "package_id": "75ee6e00-b4d5-429e-9d82-33ab730081ff",
  "repository_name": "artifact-hub",
  "scanned_at": "2026-10-21T08:16:15Z",
  "summary": "1,249 vulnerabilities in the 5 images of artifact-hub/artifact-hub 1.23.0: 9 critical, 469 high, 527 medium, 229 low.",
  "total_matching": 9,
  "truncated": true,
  "url": "https://artifacthub.io/packages/helm/artifact-hub/artifact-hub",
  "version": "1.23.0",
  "vulnerabilities": [
    {
      "cvss_score": 10.0,
      "fixed_version": "1.24.13, 1.25.7, 1.26.0-rc.3",
      "id": "CVE-2025-68121",
      "image": "artifacthub/tracker:v1.23.0",
      "installed_version": "v1.24.4",
      "package_name": "stdlib",
      "severity": "critical",
      "status": "fixed",
      "target": "usr/local/bin/opm",
      "title": "crypto/tls: crypto/tls: Incorrect certificate validation during TLS session resumption",
      "url": "https://avd.aquasec.com/nvd/cve-2025-68121"
    }
  ]
}
```

### Get a package's views

See how many times a package's pages were viewed on Artifact Hub in the last 30 days, day by day and version by version.

**Inputs**

- Package (`package`, text, required): The package as repository/name, like bitnami/nginx, or the address of its page on artifacthub.io. Search packages finds both.
- Kind (`package_kind`, text): What sort of package it is. Helm charts unless you pick another; a page address already says. Default: `helm`.

**Outputs**

- `days` (list): Views per day, oldest first.
- `first_date` (text): The first day counted.
- `kind` (text): The kind's name in package addresses, e.g. helm, kyverno or olm (a number for a kind Lodol does not list yet).
- `last_date` (text): The last day counted.
- `name` (text): The package's name.
- `package_id` (text): Artifact Hub's id for the package.
- `repository_name` (text): The repository that publishes it.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total_views` (number): Views in the last 30 days.
- `url` (text): The package's page on artifacthub.io.
- `versions` (list): Views per version, most viewed first.

**Example output**

```json
{
  "days": [
    {
      "date": "2026-09-22",
      "views": 57
    },
    {
      "date": "2026-09-23",
      "views": 53
    }
  ],
  "first_date": "2026-09-22",
  "kind": "helm",
  "last_date": "2026-09-23",
  "name": "artifact-hub",
  "package_id": "75ee6e00-b4d5-429e-9d82-33ab730081ff",
  "repository_name": "artifact-hub",
  "summary": "artifact-hub/artifact-hub was viewed 110 times on Artifact Hub between 2026-09-22 and 2026-09-23, across 1 version.",
  "total_views": 110,
  "url": "https://artifacthub.io/packages/helm/artifact-hub/artifact-hub",
  "versions": [
    {
      "version": "1.23.0",
      "views": 110
    }
  ]
}
```

### Get a repository

Get one repository by its name: where Artifact Hub reads it from, who publishes it, its badges, how many packages it holds and any errors from the last time it was read.

**Inputs**

- Repository (`repository`, text, required): Its name, like bitnami (the first part of repository/name), or the link to its packages on artifacthub.io.

**Outputs**

- `branch` (text): The Git branch read, for a Git repository.
- `cncf` (true/false): True when it belongs to a CNCF project.
- `disabled` (true/false): True when Artifact Hub no longer reads it.
- `display_name` (text): Its title, or its name when it has none.
- `kind` (text): The kind's name in package addresses, e.g. helm, kyverno or olm (a number for a kind Lodol does not list yet).
- `kind_label` (text): The kind as Artifact Hub's website names it, e.g. Helm charts.
- `last_scanned_at` (text): When its packages were last scanned.
- `last_tracked_at` (text): When Artifact Hub last read it.
- `name` (text): Its name, e.g. bitnami. Package addresses use it.
- `official` (true/false): True when the publisher owns the software it packages.
- `organization_display_name` (text): That organization's title.
- `organization_name` (text): The organization that owns it.
- `package_count` (number): How many packages it holds, deprecated ones included.
- `packages_url` (text): Its packages on artifacthub.io.
- `publisher` (text): Who publishes it: the organization's title or the user's alias.
- `repository_id` (text): Artifact Hub's id for the repository.
- `scanner_disabled` (true/false): True when its packages are not scanned for vulnerabilities.
- `scanning_errors` (text): What went wrong the last time its packages were scanned. Empty when nothing did.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `tracking_errors` (text): What went wrong the last time Artifact Hub read it. Empty when nothing did.
- `url` (text): Where Artifact Hub reads it from.
- `user_alias` (text): The user who owns it, when no organization does.
- `verified_publisher` (true/false): True when Artifact Hub has verified the publisher.

**Example output**

```json
{
  "branch": null,
  "cncf": false,
  "disabled": false,
  "display_name": "Bitnami",
  "kind": "helm",
  "kind_label": "Helm charts",
  "last_scanned_at": "2026-10-22T00:15:55Z",
  "last_tracked_at": "2026-10-22T00:17:04Z",
  "name": "bitnami",
  "official": false,
  "organization_display_name": "Bitnami",
  "organization_name": "bitnami",
  "package_count": 144,
  "packages_url": "https://artifacthub.io/packages/search?repo=bitnami",
  "publisher": "Bitnami",
  "repository_id": "64117528-d525-41d6-862c-41a43207c431",
  "scanner_disabled": false,
  "scanning_errors": null,
  "summary": "Bitnami (Helm charts) by Bitnami: 144 packages, tracked, verified publisher.",
  "tracking_errors": null,
  "url": "https://charts.bitnami.com/bitnami",
  "user_alias": null,
  "verified_publisher": true
}
```

### Get an organization

Get an organization that publishes on Artifact Hub, with its description, website and how many repositories and packages it has.

**Inputs**

- Organization (`organization`, text, required): Its name, as in the link to its packages, like bitnami, or that link itself.

**Outputs**

- `description` (text): What it says about itself.
- `display_name` (text): Its title.
- `home_url` (text): Its website.
- `logo_url` (text): Its logo.
- `name` (text): Its name, as in its links.
- `package_count` (number): How many packages it publishes, deprecated ones included.
- `repository_count` (number): How many repositories it has.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `url` (text): Its packages on artifacthub.io.

**Example output**

```json
{
  "description": "Popular applications, provided by Bitnami, ready to launch on Kubernetes using Kubernetes Helm.",
  "display_name": "Bitnami",
  "home_url": "https://bitnami.com/",
  "logo_url": "https://artifacthub.io/image/960479e8-9c70-4292-b9ca-aceaa0f419f0",
  "name": "bitnami",
  "package_count": 146,
  "repository_count": 3,
  "summary": "Bitnami publishes 146 packages from 3 repositories on Artifact Hub.",
  "url": "https://artifacthub.io/packages/search?org=bitnami"
}
```

### Get random packages

Get a handful of packages picked at random, as Artifact Hub's home page shows them: a different set each time, for discovering something new.

**Inputs**: None.

**Outputs**

- `count` (number): How many were picked.
- `packages` (list): The packages picked.
- `summary` (text): One sentence saying what came back, for a message or a log.

**Example output**

```json
{
  "count": 1,
  "packages": [
    {
      "app_version": null,
      "category": null,
      "cncf": false,
      "deprecated": false,
      "description": "A simple Kubernetes web application architecture using a Kubernetes Deployment to manage and run the web application workload. The design uses the default namespace and provides a basic foundation for deploying a web application on Kubernetes.",
      "display_name": "Kubernetes Web App Architecture",
      "kind": "meshery",
      "kind_label": "Meshery designs",
      "license": "Apache-2.0",
      "logo_url": "https://artifacthub.io/image/710943dd-3fc2-447b-9ec3-74cc42444377",
      "name": "kubernetes-web-app-architecture",
      "official": false,
      "organization_name": "meshery",
      "package_id": "50d2448e-5759-4aba-bb49-db24037c18dc",
      "production_organizations_count": 0,
      "publisher": "Meshery",
      "repository_display_name": "Meshery Catalog",
      "repository_name": "meshery-catalog",
      "security": null,
      "signed": false,
      "stars": 0,
      "updated_at": "2026-08-19T06:41:42Z",
      "url": "https://artifacthub.io/packages/meshery/meshery-catalog/kubernetes-web-app-architecture",
      "user_alias": null,
      "verified_publisher": true,
      "version": "0.0.2"
    }
  ],
  "summary": "1 package picked at random: Kubernetes Web App Architecture."
}
```

### Get stats

Get Artifact Hub's own numbers: packages, releases, repositories, organizations and users, packages by kind and category, packages added and page views per month, and the most viewed packages today and this month.

**Inputs**

- Months (`months`, number): How many recent months the monthly figures cover, 1 to 120. 12 by default. From 1 to 120. Default: `12`.

**Outputs**

- `generated_at` (text): When Artifact Hub worked these out.
- `organizations_total` (number): Organizations.
- `packages_added_monthly` (list): Packages added per month, oldest first.
- `packages_by_category` (list): Packages per category, most first.
- `packages_by_kind` (list): Packages per kind, most first.
- `packages_total` (number): Packages listed.
- `releases_total` (number): Package versions listed.
- `repositories_total` (number): Repositories.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `top_viewed_this_month` (list): The most viewed packages this month.
- `top_viewed_today` (list): The most viewed packages today.
- `users_total` (number): Registered users.
- `views_daily` (list): Package page views per day over the last month, oldest first.
- `views_monthly` (list): Package page views per month, oldest first.

**Example output**

```json
{
  "generated_at": "2026-10-22T01:29:55Z",
  "organizations_total": 3735,
  "packages_added_monthly": [
    {
      "month": "2026-09",
      "packages": 437
    },
    {
      "month": "2026-10",
      "packages": 447
    }
  ],
  "packages_by_category": [
    {
      "category": "Monitoring and logging",
      "packages": 1666
    },
    {
      "category": "Integration and delivery",
      "packages": 1565
    }
  ],
  "packages_by_kind": [
    {
      "kind": "helm",
      "kind_label": "Helm charts",
      "packages": 18337
    },
    {
      "kind": "olm",
      "kind_label": "OLM operators",
      "packages": 470
    }
  ],
  "packages_total": 21882,
  "releases_total": 506230,
  "repositories_total": 7082,
  "summary": "Artifact Hub lists 21,882 packages (506,230 releases) from 7,082 repositories and 3,735 organizations.",
  "top_viewed_this_month": [
    {
      "display_name": "kube-prometheus-stack",
      "kind": "helm",
      "name": "kube-prometheus-stack",
      "publisher": "Prometheus",
      "rank": 1,
      "repository_name": "prometheus-community",
      "url": "https://artifacthub.io/packages/helm/prometheus-community/kube-prometheus-stack",
      "views": 21753
    },
    {
      "display_name": "argo-cd",
      "kind": "helm",
      "name": "argo-cd",
      "publisher": "Argo Project",
      "rank": 2,
      "repository_name": "argo",
      "url": "https://artifacthub.io/packages/helm/argo/argo-cd",
      "views": 17175
    }
  ],
  "top_viewed_today": [
    {
      "display_name": "teleport-cluster",
      "kind": "helm",
      "name": "teleport-cluster",
      "publisher": "jlucidar",
      "rank": 1,
      "repository_name": "teleport-agent-kube",
      "url": "https://artifacthub.io/packages/helm/teleport-agent-kube/teleport-cluster",
      "views": 212
    },
    {
      "display_name": "crossplane",
      "kind": "helm",
      "name": "crossplane",
      "publisher": "Helm",
      "rank": 2,
      "repository_name": "crossplane",
      "url": "https://artifacthub.io/packages/helm/crossplane/crossplane",
      "views": 128
    }
  ],
  "users_total": 44138,
  "views_daily": [
    {
      "date": "2026-09-22",
      "views": 64571
    },
    {
      "date": "2026-09-23",
      "views": 66347
    }
  ],
  "views_monthly": [
    {
      "month": "2026-09",
      "views": 1150578
    },
    {
      "month": "2026-10",
      "views": 1187433
    }
  ]
}
```

### List a package's versions

List the versions a package has published, newest first, with when each was released and whether it is a pre-release or fixes security issues.

**Inputs**

- Package (`package`, text, required): The package as repository/name, like bitnami/nginx, or the address of its page on artifacthub.io. Search packages finds both.
- Kind (`package_kind`, text): What sort of package it is. Helm charts unless you pick another; a page address already says. Default: `helm`.
- Released since (`released_since`, date): Only versions released on or after this day (UTC).
- Include pre-releases (`include_prereleases`, true/false): Also list versions marked as pre-releases. On by default. Default: `true`.
- Number of versions (`limit`, number): The most to return, newest first, 1 to 1,000. 100 by default. From 1 to 1000. Default: `100`.

**Outputs**

- `count` (number): How many versions are listed.
- `kind` (text): The kind's name in package addresses, e.g. helm, kyverno or olm (a number for a kind Lodol does not list yet).
- `latest_version` (text): The package's newest version.
- `name` (text): The package's name.
- `package_id` (text): Artifact Hub's id for the package.
- `repository_name` (text): The repository that publishes it.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total` (number): How many versions match, before Number of versions.
- `url` (text): The package's page on artifacthub.io.
- `versions` (list): The versions, newest first.

**Example output**

```json
{
  "count": 2,
  "kind": "helm",
  "latest_version": "1.23.0",
  "name": "artifact-hub",
  "package_id": "75ee6e00-b4d5-429e-9d82-33ab730081ff",
  "repository_name": "artifact-hub",
  "summary": "artifact-hub/artifact-hub has 44 versions; showing the newest 2. Latest: 1.23.0.",
  "total": 44,
  "url": "https://artifacthub.io/packages/helm/artifact-hub/artifact-hub",
  "versions": [
    {
      "app_version": "1.23.0",
      "contains_security_updates": true,
      "is_latest": true,
      "prerelease": false,
      "released_at": "2026-07-07T14:55:48Z",
      "url": "https://artifacthub.io/packages/helm/artifact-hub/artifact-hub/1.23.0",
      "version": "1.23.0"
    },
    {
      "app_version": "1.22.0",
      "contains_security_updates": true,
      "is_latest": false,
      "prerelease": false,
      "released_at": "2025-10-21T10:35:14Z",
      "url": "https://artifacthub.io/packages/helm/artifact-hub/artifact-hub/1.22.0",
      "version": "1.22.0"
    }
  ]
}
```

### Search packages

Find Helm charts, operators, policies, plugins and other cloud-native packages on Artifact Hub by words, kind, category and publisher, with each one's latest version, stars, badges and vulnerability counts.

**Inputs**

- Search for (`query`, text): Words to look for in names, descriptions and keywords, e.g. postgresql. Quote a phrase, or put - before a word to leave it out.
- Kinds (`kinds`, list): Only these kinds of package, such as Helm charts or Kyverno policies.
- Categories (`categories`, list): Only packages in these categories. One or more of: `ai_machine_learning` (AI / Machine learning), `database`, `integration_delivery` (Integration and delivery), `monitoring_logging` (Monitoring and logging), `networking`, `security`, `storage`, `streaming_messaging` (Streaming and messaging).
- Organizations (`organization`, text): Only packages from these organizations, by the name in their links, like bitnami. Separate several with commas.
- Repositories (`repository`, text): Only packages from these repositories, like bitnami. Separate several with commas.
- Verified publishers only (`verified_publisher`, true/false): Only packages whose publisher Artifact Hub has verified. Default: `false`.
- Official only (`official`, true/false): Only packages published by the people who make the software. Default: `false`.
- CNCF projects only (`cncf`, true/false): Only packages published by CNCF projects. Default: `false`.
- Operators only (`operators`, true/false): Only Kubernetes operators, whatever their kind. Default: `false`.
- Include deprecated (`include_deprecated`, true/false): Also return packages their publishers have deprecated. Default: `false`.
- Order (`sort`, text): Most relevant first by default. One of: `relevance` (Most relevant first), `stars` (Most starred first), `last_updated` (Most recently updated first). Default: `relevance`.
- Number of packages (`limit`, number): How many to return, 1 to 60 (Artifact Hub's page size). 20 by default. From 1 to 60. Default: `20`.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the last one. At least 0. Default: `0`.

**Outputs**

- `count` (number): How many are on this page.
- `next_offset` (number): The Skip value for the next page. Empty on the last page.
- `offset` (number): How many were skipped.
- `packages` (list): The packages on this page.
- `query` (text): The words searched for, if any.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total` (number): How many match in all.

**Example output**

```json
{
  "count": 1,
  "next_offset": 1,
  "offset": 0,
  "packages": [
    {
      "app_version": "1.31.8",
      "category": "Networking",
      "cncf": false,
      "deprecated": false,
      "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.",
      "display_name": "nginx",
      "kind": "helm",
      "kind_label": "Helm charts",
      "license": null,
      "logo_url": "https://artifacthub.io/image/df8b0c56-3686-47ad-b3cf-44ab4c2ef096",
      "name": "nginx",
      "official": false,
      "organization_name": "bitnami",
      "package_id": "bec45f52-fe90-46a1-b6eb-a3dcd9bb203f",
      "production_organizations_count": 2,
      "publisher": "Bitnami",
      "repository_display_name": "Bitnami",
      "repository_name": "bitnami",
      "security": {
        "critical": 0,
        "high": 0,
        "low": 0,
        "medium": 0,
        "total": 0,
        "unknown": 0
      },
      "signed": true,
      "stars": 107,
      "updated_at": "2026-10-21T18:20:17Z",
      "url": "https://artifacthub.io/packages/helm/bitnami/nginx",
      "user_alias": null,
      "verified_publisher": true,
      "version": "25.2.8"
    }
  ],
  "query": "nginx",
  "summary": "Found 106 packages matching \"nginx\"; showing 1 to 1, most starred first.",
  "total": 106
}
```

### Search repositories

Find the repositories packages are published from, by name, kind, organization, user or address, with who publishes each, its badges and whether Artifact Hub could read it last time.

**Inputs**

- Name contains (`name`, text): Only repositories whose name contains this, e.g. prometheus.
- Kinds (`kinds`, list): Only these kinds of package, such as Helm charts or Kyverno policies.
- Organizations (`organization`, text): Only repositories of these organizations, like bitnami. Separate several with commas; with Users too, either may match.
- Users (`user`, text): Only repositories these Artifact Hub users publish, by their alias. Separate several with commas.
- Address (`url`, text): Only the repository read from this address, e.g. https://charts.bitnami.com/bitnami.
- Number of repositories (`limit`, number): How many to return, 1 to 60 (Artifact Hub's page size). 20 by default. From 1 to 60. Default: `20`.
- Skip (`offset`, number): How many to skip, for the next page: use next_offset from the last one. At least 0. Default: `0`.

**Outputs**

- `count` (number): How many are on this page.
- `next_offset` (number): The Skip value for the next page. Empty on the last page.
- `offset` (number): How many were skipped.
- `repositories` (list): The repositories on this page.
- `summary` (text): One sentence saying what came back, for a message or a log.
- `total` (number): How many match in all.

**Example output**

```json
{
  "count": 1,
  "next_offset": 1,
  "offset": 0,
  "repositories": [
    {
      "branch": null,
      "cncf": false,
      "disabled": false,
      "display_name": "Bitnami",
      "kind": "helm",
      "kind_label": "Helm charts",
      "last_scanned_at": "2026-10-22T00:15:55Z",
      "last_tracked_at": "2026-10-22T00:17:04Z",
      "name": "bitnami",
      "official": false,
      "organization_display_name": "Bitnami",
      "organization_name": "bitnami",
      "packages_url": "https://artifacthub.io/packages/search?repo=bitnami",
      "publisher": "Bitnami",
      "repository_id": "64117528-d525-41d6-862c-41a43207c431",
      "scanner_disabled": false,
      "tracking_errors": null,
      "url": "https://charts.bitnami.com/bitnami",
      "user_alias": null,
      "verified_publisher": true
    }
  ],
  "summary": "Found 3 repositories; showing 1 to 1.",
  "total": 3
}
```
