# MetaCPAN

> Look up CPAN, Perl's module archive, through MetaCPAN: search modules, get a module's latest version and documentation, a distribution's releases, dependencies, the distributions that depend on it, its Changes file, contributors, ++ votes, issue counts and known security advisories, CPAN authors and their releases, who may upload a module, and what was released recently. Start a workflow when a distribution or an author has a new release. No account or API key required.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/metacpan

## Actions

### Count ++ votes

Count the ++ votes MetaCPAN users have given up to 100 distributions, to compare them, with the names CPAN has no distribution for.

**Inputs**

- Distributions (`distributions`, text, required): Up to 100 distributions (or their main modules), one per line or separated by commas, or a list from an earlier step.

**Outputs**

- `count` (number): How many distributions were counted.
- `distributions` (list): Each distribution's ++ votes, in the order asked.
- `not_found` (list): The names asked about that CPAN has no distribution for.
- `total_favorites` (number): Their ++ votes added together.

**Example output**

```json
{
  "count": 2,
  "distributions": [
    {
      "distribution": "Moose",
      "favorites": 336,
      "url": "https://metacpan.org/dist/Moose"
    },
    {
      "distribution": "Moo",
      "favorites": 306,
      "url": "https://metacpan.org/dist/Moo"
    }
  ],
  "not_found": [],
  "total_favorites": 642
}
```

### Find a download link

Find the release of a module or distribution that best matches a version or a range of versions, as the cpanm installer does, with its download link and checksums.

**Inputs**

- Module or distribution (`name`, text, required): A module such as Try::Tiny, or a distribution such as libwww-perl (a name with a hyphen is read as a distribution).
- Version (`version`, text): A version, or a range such as >=1.0,<2.0 or ==0.32. Leave empty for the latest.
- Include developer releases (`include_developer`, true/false): Also consider developer (trial) releases. Off by default. Default: `false`.

**Outputs**

- `checksum_md5` (text): The archive's MD5 checksum.
- `checksum_sha256` (text): The archive's SHA-256 checksum, to verify it.
- `date` (text): When it was uploaded to CPAN, in UTC, such as '2026-10-01T00:35:44Z'.
- `distribution` (text): The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
- `download_url` (text): The link to download its archive (.tar.gz).
- `name` (text): The module or distribution asked about.
- `release` (text): The release's name: the distribution and its version, such as 'Moose-2.4001'.
- `status` (text): 'latest' for the distribution's current release, 'cpan' for an older one still on CPAN, 'backpan' for one deleted from CPAN (still on BackPAN, CPAN's history).
- `version` (text): The release's version, such as '2.4001'.

**Example output**

```json
{
  "checksum_md5": "3623f7f05aac55e70daa208a42e67228",
  "checksum_sha256": "c4bdcbe4daaeb50dcf40ea17dfb1483db22cb8832287abd8762a44ab98fb561f",
  "date": "2025-07-04T21:24:15Z",
  "distribution": "Moose",
  "download_url": "https://cpan.metacpan.org/authors/id/E/ET/ETHER/Moose-2.4000.tar.gz",
  "name": "Moose",
  "release": "Moose-2.4000",
  "status": "cpan",
  "version": "2.4000"
}
```

### Get a module

Get a module's latest version on CPAN: its version, abstract and description, the distribution and release it is in, who uploaded it and when, whether it is deprecated, its distribution's ++ votes and the download link.

**Inputs**

- Module (`module`, text, required): The module's name, with :: between its parts, such as Try::Tiny or Moose::Role. 'Search CPAN' finds it.

**Outputs**

- `abstract` (text): Its one-line summary, such as 'A postmodern object system'.
- `author` (text): The PAUSE ID of the author who uploaded it, such as 'ETHER'. 'Get an author' takes it.
- `authorized` (true/false): False when the uploader had no permission for this module.
- `date` (text): When it was uploaded to CPAN, in UTC, such as '2026-10-01T00:35:44Z'.
- `deprecated` (true/false): True when its author marked it deprecated.
- `description` (text): The DESCRIPTION section of its documentation, as plain text.
- `distribution` (text): The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
- `documentation` (text): The name its documentation is under, usually the module's own.
- `download_url` (text): The link to download its archive (.tar.gz).
- `favorites` (number): Its distribution's ++ votes on MetaCPAN.
- `indexed` (true/false): False when CPAN's index leaves it out, so clients don't install it by this name.
- `maturity` (text): 'released' for a stable release, 'developer' for a trial release (its name ends in -TRIAL or its version has an underscore).
- `module` (text): The module's name as CPAN writes it, such as 'Try::Tiny'.
- `path` (text): Its file in the release, such as 'lib/Try/Tiny.pm'.
- `release` (text): The release's name: the distribution and its version, such as 'Moose-2.4001'.
- `release_url` (text): The release's page on metacpan.org.
- `release_version` (text): The version of the release that holds it.
- `source_url` (text): Its source code on metacpan.org.
- `status` (text): 'latest' for the distribution's current release, 'cpan' for an older one still on CPAN, 'backpan' for one deleted from CPAN (still on BackPAN, CPAN's history).
- `url` (text): Its documentation on metacpan.org.
- `version` (text): The module's own version, such as '0.32'.

**Example output**

```json
{
  "abstract": "Minimal try/catch with proper preservation of $@",
  "author": "ETHER",
  "authorized": true,
  "date": "2024-08-16T22:25:06Z",
  "deprecated": false,
  "description": "This module provides bare bones \"try\"/\"catch\"/\"finally\" statements that are designed to minimize common mistakes with eval blocks, and NOTHING else. This is unlike TryCatch which provides a nice syntax and avoids adding another call stack layer, and supports calling \"return\" from the \"try\" block to return from the parent subroutine. These extra features come at a cost of a few dependencies, ...",
  "distribution": "Try-Tiny",
  "documentation": "Try::Tiny",
  "download_url": "https://cpan.metacpan.org/authors/id/E/ET/ETHER/Try-Tiny-0.32.tar.gz",
  "favorites": 182,
  "indexed": true,
  "maturity": "released",
  "module": "Try::Tiny",
  "path": "lib/Try/Tiny.pm",
  "release": "Try-Tiny-0.32",
  "release_url": "https://metacpan.org/release/ETHER/Try-Tiny-0.32",
  "release_version": "0.32",
  "source_url": "https://metacpan.org/release/ETHER/Try-Tiny-0.32/source/lib/Try/Tiny.pm",
  "status": "latest",
  "url": "https://metacpan.org/pod/Try::Tiny",
  "version": "0.32"
}
```

### Get a module's documentation

Get a module's documentation from its latest release as Markdown, plain text, HTML or POD, ready to save, send or hand to an AI step.

**Inputs**

- Module (`module`, text, required): The module's name, with :: between its parts, such as Try::Tiny or Moose::Role. 'Search CPAN' finds it.
- Format (`output_format`, text): The format to return it in. Markdown by default. One of: `markdown`, `text` (Plain text), `html`, `pod` (POD (Perl's own markup)). Default: `markdown`.

**Outputs**

- `characters` (number): How long the documentation is, in characters.
- `content` (text): The whole documentation, in that format.
- `content_type` (text): The format's media type, such as text/x-markdown.
- `format` (text): markdown, text, html or pod.
- `module` (text): The module's name as CPAN writes it.
- `url` (text): The documentation on metacpan.org.

**Example output**

```json
{
  "characters": 400,
  "content": "# NAME\n\nTry::Tiny - Minimal try/catch with proper preservation of $@\n\n# VERSION\n\nversion 0.32\n\n# SYNOPSIS\n\nYou can use Try::Tiny's `try` and `catch` to expect and handle exceptional\nconditions, avoiding quirks in Perl and common mistakes:\n\n    # handle errors with a catch handler\n    try {\n      die \"foo\";\n    } catch {\n      warn \"caught error: $_\"; # not $@\n    };\n\nYou can also use it like a ...",
  "content_type": "text/x-markdown",
  "format": "markdown",
  "module": "Try::Tiny",
  "url": "https://metacpan.org/pod/Try::Tiny"
}
```

### Get a release

Get a distribution's latest release, or one version of it, in full: version, date, author, license, the oldest perl it runs on, its repository and bug tracker, the modules it provides, how many dependencies it has, its CPAN Testers results, checksums and download link.

**Inputs**

- Distribution (`distribution`, text, required): The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.
- Version (`version`, text): Which release, such as 2.4000. Leave empty for the latest release.

**Outputs**

- `abstract` (text): Its one-line summary, such as 'A postmodern object system'.
- `archive` (text): Its archive's file name.
- `author` (text): The PAUSE ID of the author who uploaded it, such as 'ETHER'. 'Get an author' takes it.
- `authorized` (true/false): False when the uploader had no permission for the modules it holds, so CPAN clients don't install it.
- `authors` (list): The authors its metadata names, with their emails.
- `bugtracker_email` (text): The email address for bug reports, when it has one.
- `bugtracker_url` (text): Where to report bugs, when it says.
- `changes_file` (text): Its Changes file's name, such as 'Changes'.
- `checksum_md5` (text): The archive's MD5 checksum.
- `checksum_sha256` (text): The archive's SHA-256 checksum, to verify it.
- `date` (text): When it was uploaded to CPAN, in UTC, such as '2026-10-01T00:35:44Z'.
- `dependency_count` (number): How many dependencies it declares, of every phase and kind.
- `deprecated` (true/false): True when its author marked it deprecated.
- `distribution` (text): The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
- `distribution_url` (text): The distribution's page on metacpan.org.
- `download_url` (text): The link to download its archive (.tar.gz).
- `first` (true/false): True when this was the distribution's first release.
- `homepage` (text): Its homepage, when it names one.
- `license` (list): Its licenses, such as 'perl_5' or 'mit'.
- `main_module` (text): The distribution's main module, such as 'Moose'.
- `maturity` (text): 'released' for a stable release, 'developer' for a trial release (its name ends in -TRIAL or its version has an underscore).
- `name` (text): The release's name: the distribution and its version, such as 'Moose-2.4001'.
- `perl_version` (text): The oldest perl it runs on, such as '5.008003', when it says.
- `provides` (list): The modules it provides, such as 'Moose::Role'.
- `provides_count` (number): How many modules it provides.
- `repository_url` (text): Its source repository, to clone.
- `repository_web` (text): Its source repository's web page.
- `size_bytes` (number): Its archive's size, in bytes.
- `status` (text): 'latest' for the distribution's current release, 'cpan' for an older one still on CPAN, 'backpan' for one deleted from CPAN (still on BackPAN, CPAN's history).
- `tests_fail` (number): CPAN Testers reports that failed.
- `tests_na` (number): CPAN Testers reports where it could not be tested.
- `tests_pass` (number): CPAN Testers reports that passed.
- `tests_unknown` (number): CPAN Testers reports with no result (no tests ran).
- `url` (text): The release's page on metacpan.org.
- `version` (text): The release's version, such as '2.4001'.

**Example output**

```json
{
  "abstract": "Minimal try/catch with proper preservation of $@",
  "archive": "Try-Tiny-0.31.tar.gz",
  "author": "ETHER",
  "authorized": true,
  "authors": [
    "\u05d9\u05d5\u05d1\u05dc \u05e7\u05d5\u05d2'\u05de\u05df (Yuval Kogman) <nothingmuch@woobling.org>",
    "Jesse Luehrs <doy@tozt.net>"
  ],
  "bugtracker_email": "bug-Try-Tiny@rt.cpan.org",
  "bugtracker_url": "https://rt.cpan.org/Public/Dist/Display.html?Name=Try-Tiny",
  "changes_file": "Changes",
  "checksum_md5": "993a29ee8a03c9bd9c2f7c53d1082a03",
  "checksum_sha256": "3300d31d8a4075b26d8f46ce864a1d913e0e8467ceeba6655d5d2b2e206c11be",
  "date": "2021-11-23T20:30:31Z",
  "dependency_count": 121,
  "deprecated": false,
  "distribution": "Try-Tiny",
  "distribution_url": "https://metacpan.org/dist/Try-Tiny",
  "download_url": "https://cpan.metacpan.org/authors/id/E/ET/ETHER/Try-Tiny-0.31.tar.gz",
  "first": false,
  "homepage": "https://github.com/p5sagit/Try-Tiny",
  "license": [
    "mit"
  ],
  "main_module": "Try::Tiny",
  "maturity": "released",
  "name": "Try-Tiny-0.31",
  "perl_version": "5.006",
  "provides": [
    "Try::Tiny"
  ],
  "provides_count": 1,
  "repository_url": "https://github.com/p5sagit/Try-Tiny.git",
  "repository_web": "https://github.com/p5sagit/Try-Tiny",
  "size_bytes": 35784,
  "status": "backpan",
  "tests_fail": 0,
  "tests_na": 0,
  "tests_pass": 6765,
  "tests_unknown": 2,
  "url": "https://metacpan.org/release/ETHER/Try-Tiny-0.31",
  "version": "0.31"
}
```

### Get an author

Get a CPAN author's profile by PAUSE ID: name, email addresses, websites, city and country, accounts elsewhere (GitHub and others) and how many releases they have on CPAN.

**Inputs**

- PAUSE ID (`pause_id`, text, required): The author's PAUSE ID, the name they upload to CPAN under, such as ETHER. 'Search authors' finds it.

**Outputs**

- `ascii_name` (text): Their name in plain letters, when it has others.
- `backpan_releases` (number): How many of their releases were deleted from CPAN (kept on BackPAN).
- `city` (text): The city they gave, such as 'Vancouver'.
- `country` (text): Their country, such as 'Canada'.
- `country_code` (text): Their country's two-letter code, such as 'CA'.
- `cpan_directory` (text): Their folder of uploads on CPAN.
- `cpantesters_reports` (text): Their CPAN Testers results.
- `current_releases` (number): How many distributions have their current release by them.
- `email` (text): Their first public email address.
- `emails` (list): Every public email address.
- `gravatar_url` (text): Their picture (Gravatar).
- `name` (text): Their name, such as 'Karen Etheridge'.
- `older_releases` (number): How many of their older releases are still on CPAN.
- `pause_id` (text): Their PAUSE ID, such as 'ETHER'.
- `profiles` (list): Their accounts elsewhere.
- `region` (text): Their region or state, as they wrote it.
- `updated` (text): When they last changed their profile, in UTC.
- `url` (text): Their page on metacpan.org.
- `website` (text): Their first website.
- `websites` (list): Every website they list.

**Example output**

```json
{
  "ascii_name": null,
  "backpan_releases": 2484,
  "city": "Vancouver",
  "country": "Canada",
  "country_code": "CA",
  "cpan_directory": "https://www.cpan.org/authors/id/E/ET/ETHER",
  "cpantesters_reports": "https://www.cpantesters.org/author/E/ETHER.html",
  "current_releases": 279,
  "email": "ether@cpan.org",
  "emails": [
    "ether@cpan.org"
  ],
  "gravatar_url": "https://secure.gravatar.com/avatar/bdc5cd06679e732e262f6c1b450a0237?s=130&d=identicon",
  "name": "Karen Etheridge",
  "older_releases": 112,
  "pause_id": "ETHER",
  "profiles": [
    {
      "id": "karenetheridge",
      "site": "github"
    },
    {
      "id": "ETHER",
      "site": "github-meets-cpan"
    },
    {
      "id": "ether",
      "site": "irc.perl.org"
    }
  ],
  "region": "best coast",
  "updated": "2026-09-16T17:51:37Z",
  "url": "https://metacpan.org/author/ETHER",
  "website": "https://github.com/karenetheridge",
  "websites": [
    "https://github.com/karenetheridge"
  ]
}
```

### Get distribution stats

Get a distribution's health: how many distributions depend on it directly and in all, its bus factor, its open and closed issues in RT and GitHub, its GitHub stars and the operating system packages that ship it.

**Inputs**

- Distribution (`distribution`, text, required): The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.

**Outputs**

- `all_dependents` (number): How many depend on it directly or through others: its place in CPAN's river.
- `bus_factor` (number): How many people have released it recently: how many could keep it going.
- `dependents` (number): How many distributions require it directly.
- `distribution` (text): The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
- `github_closed` (number): Closed GitHub issues.
- `github_open` (number): Open GitHub issues, when it uses GitHub for bugs.
- `github_repository` (text): Its GitHub repository, when it has one.
- `github_stars` (number): Its GitHub stars.
- `github_watchers` (number): Its GitHub watchers.
- `packages` (list): The operating system packages that ship it.
- `river_bucket` (number): Its place in the river from 0 (nothing depends on it) to 5 (much of CPAN does).
- `rt_active` (number): Active tickets in RT: new, open and stalled.
- `rt_closed` (number): Closed tickets in RT: resolved and rejected.
- `rt_new` (number): New tickets in RT nobody has picked up.
- `rt_open` (number): Open tickets in RT, CPAN's bug tracker.
- `rt_rejected` (number): Rejected tickets in RT.
- `rt_resolved` (number): Resolved tickets in RT.
- `rt_stalled` (number): Stalled tickets in RT.
- `rt_url` (text): Its tickets in RT.
- `url` (text): Its page on metacpan.org.

**Example output**

```json
{
  "all_dependents": 1294,
  "bus_factor": 5,
  "dependents": 1142,
  "distribution": "Mojolicious",
  "github_closed": 1831,
  "github_open": 92,
  "github_repository": "https://github.com/mojolicious/mojo",
  "github_stars": 2674,
  "github_watchers": 213,
  "packages": [
    {
      "package": "perl-Mojolicious",
      "system": "cygwin"
    },
    {
      "package": "libmojolicious-perl",
      "system": "debian"
    }
  ],
  "river_bucket": 4,
  "rt_active": 0,
  "rt_closed": 7,
  "rt_new": 0,
  "rt_open": 0,
  "rt_rejected": 0,
  "rt_resolved": 7,
  "rt_stalled": 0,
  "rt_url": "https://rt.cpan.org/Public/Dist/Display.html?Name=Mojolicious",
  "url": "https://metacpan.org/dist/Mojolicious"
}
```

### Get module permissions

See who may upload new versions of up to 100 modules: each one's owner and co-maintainers, by PAUSE ID, and the names CPAN has no permissions for.

**Inputs**

- Modules (`modules`, text, required): Up to 100 module names, one per line or separated by commas, or a list from an earlier step.

**Outputs**

- `count` (number): How many of them CPAN has permissions for.
- `not_found` (list): The names asked about that CPAN has no permissions for.
- `permissions` (list): Each module's permissions, in the order asked.
- `requested` (number): How many modules were asked about.

**Example output**

```json
{
  "count": 2,
  "not_found": [
    "Not::A::Real::Module"
  ],
  "permissions": [
    {
      "co_maintainers": [
        "DOY",
        "FLORA",
        "NUFFIN",
        "PERIGRIN",
        "RJBS",
        "SARTAK",
        "STEVAN"
      ],
      "maintainers": [
        "ETHER",
        "DOY",
        "FLORA",
        "NUFFIN",
        "PERIGRIN",
        "RJBS",
        "SARTAK",
        "STEVAN"
      ],
      "module": "Try::Tiny",
      "owner": "ETHER",
      "url": "https://metacpan.org/pod/Try::Tiny"
    },
    {
      "co_maintainers": [
        "DOY",
        "DROLSKY",
        "ETHER",
        "FLORA",
        "GRODITI",
        "HDP",
        "PERIGRIN",
        "SARTAK"
      ],
      "maintainers": [
        "STEVAN",
        "DOY",
        "DROLSKY",
        "ETHER",
        "FLORA",
        "GRODITI",
        "HDP",
        "PERIGRIN",
        "SARTAK"
      ],
      "module": "Moose",
      "owner": "STEVAN",
      "url": "https://metacpan.org/pod/Moose"
    }
  ],
  "requested": 3
}
```

### Get the Changes file

Read a release's Changes file: the notes for that release, the newest entries each with its version, date and text, and the whole file. Good for posting release notes.

**Inputs**

- Distribution (`distribution`, text, required): The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.
- Version (`version`, text): Which release, such as 2.4000. Leave empty for the latest release.
- Entries (`entries`, number): How many of the newest entries to list, up to 100. From 1 to 100. Default: `5`.

**Outputs**

- `author` (text): The PAUSE ID of the author who uploaded it, such as 'ETHER'. 'Get an author' takes it.
- `content` (text): The whole file, as written.
- `count` (number): How many entries are listed.
- `date` (text): When it was uploaded to CPAN, in UTC, such as '2026-10-01T00:35:44Z'.
- `distribution` (text): The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
- `entries` (list): The newest entries, in the file's order.
- `entry_count` (number): How many entries the file has in all.
- `file` (text): The file's name in the release, such as 'Changes'.
- `release` (text): The release's name: the distribution and its version, such as 'Moose-2.4001'.
- `release_notes` (text): The entry for this release's own version: what changed in it. Empty when the file has no entry for that version.
- `url` (text): The file on metacpan.org.
- `version` (text): The release's version, such as '2.4001'.

**Example output**

```json
{
  "author": "ETHER",
  "content": "Revision history for Try-Tiny\n\n0.32      2024-08-16 22:23:44Z\n  - skip given, when tests on perls >= 5.41.3 which removed these constructs\n\n0.31      2021-11-23 20:29:12Z\n  - plug Syntax::Keyword::Try and Feature::Compat::Try in the docs\n\n0.30      2017-12-21 07:23:03Z\n  - expand \"when\" test skippage to more perl versions\n\n0.29      2017-12-19 03:51:26Z\n  - skip tests of \"when\" and \"given/when\" ...",
  "count": 2,
  "date": "2024-08-16T22:25:06Z",
  "distribution": "Try-Tiny",
  "entries": [
    {
      "date": "2024-08-16",
      "heading": "0.32      2024-08-16 22:23:44Z",
      "text": "- skip given, when tests on perls >= 5.41.3 which removed these constructs",
      "version": "0.32"
    },
    {
      "date": "2021-11-23",
      "heading": "0.31      2021-11-23 20:29:12Z",
      "text": "- plug Syntax::Keyword::Try and Feature::Compat::Try in the docs",
      "version": "0.31"
    }
  ],
  "entry_count": 32,
  "file": "Changes",
  "release": "Try-Tiny-0.32",
  "release_notes": "- skip given, when tests on perls >= 5.41.3 which removed these constructs",
  "url": "https://metacpan.org/release/ETHER/Try-Tiny-0.32/source/Changes",
  "version": "0.32"
}
```

### List a distribution's releases

List every release of a distribution, newest first, with its version, date, author, maturity and whether it is still on CPAN, optionally stable or developer releases only.

**Inputs**

- Distribution (`distribution`, text, required): The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.
- Maturity (`maturity`, text): Stable releases, developer (trial) releases, or both. Both by default. One of: `any` (Stable and developer releases), `released` (Stable releases only), `developer` (Developer releases only). Default: `any`.
- Page (`page`, number): Which page to return, from 1. From 1 to 500. Default: `1`.
- Per page (`per_page`, number): How many to return on a page, up to 100. From 1 to 100. Default: `50`.

**Outputs**

- `count` (number): How many are on this page.
- `distribution` (text): The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
- `maturity` (text): any, released or developer: which were listed.
- `more_available` (true/false): True when there are more on later pages: raise 'Page' to read them.
- `page` (number): The page returned, from 1.
- `releases` (list): Its releases, newest first.
- `total` (number): How many match in all.

**Example output**

```json
{
  "count": 2,
  "distribution": "Try-Tiny",
  "maturity": "any",
  "more_available": true,
  "page": 1,
  "releases": [
    {
      "abstract": "Minimal try/catch with proper preservation of $@",
      "author": "ETHER",
      "authorized": true,
      "date": "2024-08-16T22:25:06Z",
      "distribution": "Try-Tiny",
      "download_url": "https://cpan.metacpan.org/authors/id/E/ET/ETHER/Try-Tiny-0.32.tar.gz",
      "first": false,
      "main_module": "Try::Tiny",
      "maturity": "released",
      "name": "Try-Tiny-0.32",
      "status": "latest",
      "url": "https://metacpan.org/release/ETHER/Try-Tiny-0.32",
      "version": "0.32"
    },
    {
      "abstract": "Minimal try/catch with proper preservation of $@",
      "author": "ETHER",
      "authorized": true,
      "date": "2021-11-23T20:30:31Z",
      "distribution": "Try-Tiny",
      "download_url": "https://cpan.metacpan.org/authors/id/E/ET/ETHER/Try-Tiny-0.31.tar.gz",
      "first": false,
      "main_module": "Try::Tiny",
      "maturity": "released",
      "name": "Try-Tiny-0.31",
      "status": "backpan",
      "url": "https://metacpan.org/release/ETHER/Try-Tiny-0.31",
      "version": "0.31"
    }
  ],
  "total": 32
}
```

### List a release's contributors

List everyone a release credits as an author or contributor, with their PAUSE ID when they are a CPAN author and the email address the release gives.

**Inputs**

- Distribution (`distribution`, text, required): The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.
- Version (`version`, text): Which release, such as 2.4000. Leave empty for the latest release.

**Outputs**

- `author` (text): The PAUSE ID of the author who uploaded it, such as 'ETHER'. 'Get an author' takes it.
- `contributors` (list): Everyone it credits, by name.
- `count` (number): How many people it credits.
- `distribution` (text): The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
- `release` (text): The release's name: the distribution and its version, such as 'Moose-2.4001'.
- `version` (text): The release's version, such as '2.4001'.
- `with_pause_id` (number): How many of them are CPAN authors.

**Example output**

```json
{
  "author": "ETHER",
  "contributors": [
    {
      "email": "doy@cpan.org",
      "emails": [
        "doy@cpan.org"
      ],
      "name": "Jesse Luehrs",
      "pause_id": "DOY",
      "url": "https://metacpan.org/author/DOY"
    },
    {
      "email": "ether@cpan.org",
      "emails": [
        "ether@cpan.org"
      ],
      "name": "Karen Etheridge",
      "pause_id": "ETHER",
      "url": "https://metacpan.org/author/ETHER"
    },
    {
      "email": "nothingmuch@woobling.org",
      "emails": [
        "nothingmuch@woobling.org"
      ],
      "name": "Yuval Kogman",
      "pause_id": "NUFFIN",
      "url": "https://metacpan.org/author/NUFFIN"
    }
  ],
  "count": 3,
  "distribution": "Try-Tiny",
  "release": "Try-Tiny-0.32",
  "version": "0.32",
  "with_pause_id": 3
}
```

### List a release's dependencies

List the modules a release needs, with the version of each, when (runtime, configure, build, test, develop) and how much (requires, recommends, suggests, conflicts), plus the oldest perl it runs on.

**Inputs**

- Distribution (`distribution`, text, required): The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.
- Version (`version`, text): Which release, such as 2.4000. Leave empty for the latest release.
- Phases (`phases`, list): Only these phases. Leave empty for every phase. One or more of: `runtime`, `configure`, `build`, `test`, `develop`.
- Kinds (`relationships`, list): Only these kinds, such as requires for what it can't run without. Leave empty for every kind. One or more of: `requires`, `recommends`, `suggests`, `conflicts`.

**Outputs**

- `author` (text): The PAUSE ID of the author who uploaded it, such as 'ETHER'. 'Get an author' takes it.
- `count` (number): How many are listed, after the phase and kind filters.
- `dependencies` (list): What it needs: runtime first, then configure, build, test and develop.
- `distribution` (text): The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
- `modules` (list): The modules listed, each once and without perl itself: a list to hand to another step.
- `perl_version` (text): The oldest perl it runs on, such as '5.008003', when it says.
- `release` (text): The release's name: the distribution and its version, such as 'Moose-2.4001'.
- `total` (number): How many dependencies it declares in all.
- `version` (text): The release's version, such as '2.4001'.

**Example output**

```json
{
  "author": "ETHER",
  "count": 3,
  "dependencies": [
    {
      "module": "Carp",
      "phase": "runtime",
      "relationship": "requires",
      "version": "0"
    },
    {
      "module": "constant",
      "phase": "runtime",
      "relationship": "requires",
      "version": "0"
    },
    {
      "module": "Exporter",
      "phase": "runtime",
      "relationship": "requires",
      "version": "5.57"
    }
  ],
  "distribution": "Try-Tiny",
  "modules": [
    "Carp",
    "constant",
    "Exporter"
  ],
  "perl_version": "5.006",
  "release": "Try-Tiny-0.32",
  "total": 121,
  "version": "0.32"
}
```

### List an author's releases

List a CPAN author's releases: every one, newest first, or the latest release of each of their distributions, by name.

**Inputs**

- PAUSE ID (`pause_id`, text, required): The author's PAUSE ID, the name they upload to CPAN under, such as ETHER. 'Search authors' finds it.
- Which releases (`scope`, text): Every release, newest first, or the latest of each distribution. Every release by default. One of: `all` (Every release, newest first), `latest` (The latest release of each distribution, by name). Default: `all`.
- Page (`page`, number): Which page to return, from 1. From 1 to 500. Default: `1`.
- Per page (`per_page`, number): How many to return on a page, up to 100. From 1 to 100. Default: `50`.

**Outputs**

- `count` (number): How many are on this page.
- `more_available` (true/false): True when there are more on later pages: raise 'Page' to read them.
- `page` (number): The page returned, from 1.
- `pause_id` (text): The author's PAUSE ID.
- `releases` (list): Their releases: newest first, or by distribution name for the latest of each.
- `scope` (text): all or latest: which releases were listed.
- `total` (number): How many match in all.

**Example output**

```json
{
  "count": 2,
  "more_available": true,
  "page": 1,
  "pause_id": "ETHER",
  "releases": [
    {
      "abstract": "Validate data against a schema using a JSON Schema",
      "author": "ETHER",
      "authorized": true,
      "date": "2026-10-23T20:28:09Z",
      "distribution": "JSON-Schema-Modern",
      "download_url": "https://cpan.metacpan.org/authors/id/E/ET/ETHER/JSON-Schema-Modern-0.652.tar.gz",
      "first": false,
      "main_module": "JSON::Schema::Modern",
      "maturity": "released",
      "name": "JSON-Schema-Modern-0.652",
      "status": "latest",
      "url": "https://metacpan.org/release/ETHER/JSON-Schema-Modern-0.652",
      "version": "0.652"
    },
    {
      "abstract": "A quick and easy way to build simple web applications",
      "author": "ETHER",
      "authorized": true,
      "date": "2026-10-23T19:49:49Z",
      "distribution": "Web-Simple",
      "download_url": "https://cpan.metacpan.org/authors/id/E/ET/ETHER/Web-Simple-0.035.tar.gz",
      "first": false,
      "main_module": "Web::Simple",
      "maturity": "released",
      "name": "Web-Simple-0.035",
      "status": "latest",
      "url": "https://metacpan.org/release/ETHER/Web-Simple-0.035",
      "version": "0.035"
    }
  ],
  "scope": "all",
  "total": 2875
}
```

### List dependent distributions

List the distributions whose current release requires a distribution (any of its modules) or one module, newest release first or by name, with how many there are in all.

**Inputs**

- Distribution or module (`name`, text, required): A distribution such as Try-Tiny, or a module such as Moose::Role for the distributions that require that module alone.
- Order (`sort`, text): Newest release first, or by name. One of: `date:desc` (Newest release first), `distribution:asc` (Distribution name, A to Z). Default: `date:desc`.
- Page (`page`, number): Which page to return, from 1. From 1 to 500. Default: `1`.
- Per page (`per_page`, number): How many to return on a page, up to 100. From 1 to 100. Default: `20`.

**Outputs**

- `count` (number): How many are on this page.
- `dependents` (list): The current release of each distribution that requires it.
- `looked_up_as` (text): distribution or module: what the name was read as.
- `more_available` (true/false): True when there are more on later pages: raise 'Page' to read them.
- `name` (text): The distribution or module asked about.
- `page` (number): The page returned, from 1.
- `sort` (text): The order: date:desc or distribution:asc.
- `total` (number): How many match in all.

**Example output**

```json
{
  "count": 2,
  "dependents": [
    {
      "abstract": "Top level namespace for the Business::GoCardless set of modules",
      "author": "LEEJO",
      "date": "2026-10-22T11:04:56Z",
      "distribution": "Business-GoCardless",
      "download_url": "https://cpan.metacpan.org/authors/id/L/LE/LEEJO/Business-GoCardless-1.00.tar.gz",
      "maturity": "released",
      "name": "Business-GoCardless-1.00",
      "url": "https://metacpan.org/release/LEEJO/Business-GoCardless-1.00",
      "version": "1.00"
    },
    {
      "abstract": "Geocoding using free, locally-hosted databases",
      "author": "NHORNE",
      "date": "2026-10-22T01:07:28Z",
      "distribution": "Geo-Coder-Free",
      "download_url": "https://cpan.metacpan.org/authors/id/N/NH/NHORNE/Geo-Coder-Free-0.51.tar.gz",
      "maturity": "released",
      "name": "Geo-Coder-Free-0.51",
      "url": "https://metacpan.org/release/NHORNE/Geo-Coder-Free-0.51",
      "version": "0.51"
    }
  ],
  "looked_up_as": "distribution",
  "more_available": true,
  "name": "Try-Tiny",
  "page": 1,
  "sort": "date:desc",
  "total": 1317
}
```

### List recent releases

List the newest releases on CPAN, newest first, optionally only first releases of new distributions, stable or developer releases only, or those uploaded between two dates.

**Inputs**

- Which releases (`scope`, text): Every new release, or only the first release of each new distribution. One of: `all` (Every new release), `new` (First releases of new distributions only). Default: `all`.
- Maturity (`maturity`, text): Stable releases, developer (trial) releases, or both. Both by default. One of: `any` (Stable and developer releases), `released` (Stable releases only), `developer` (Developer releases only). Default: `any`.
- Uploaded on or after (`released_after`, date): Only releases uploaded on this day (UTC) or later.
- Uploaded on or before (`released_before`, date): Only releases uploaded on this day (UTC) or earlier.
- Page (`page`, number): Which page to return, from 1. From 1 to 500. Default: `1`.
- Per page (`per_page`, number): How many to return on a page, up to 100. From 1 to 100. Default: `20`.

**Outputs**

- `count` (number): How many are on this page.
- `maturity` (text): any, released or developer.
- `more_available` (true/false): True when there are more on later pages: raise 'Page' to read them.
- `page` (number): The page returned, from 1.
- `releases` (list): Releases on CPAN, newest first.
- `scope` (text): all or new: which releases were listed.
- `total` (number): How many match in all.

**Example output**

```json
{
  "count": 2,
  "maturity": "any",
  "more_available": true,
  "page": 1,
  "releases": [
    {
      "abstract": "Give software without a conf.d one anyway.",
      "author": "TEODESIAN",
      "authorized": true,
      "date": "2026-10-24T00:03:39Z",
      "distribution": "Configd",
      "download_url": "https://cpan.metacpan.org/authors/id/T/TE/TEODESIAN/Configd-0.004.tar.gz",
      "first": false,
      "main_module": "Configd",
      "maturity": "released",
      "name": "Configd-0.004",
      "status": "latest",
      "url": "https://metacpan.org/release/TEODESIAN/Configd-0.004",
      "version": "0.004"
    },
    {
      "abstract": "Unicode CLDR Rule-Based Number Format, ported from ICU4C",
      "author": "JDEGUEST",
      "authorized": true,
      "date": "2026-10-24T00:03:28Z",
      "distribution": "Locale-Unicode-RBNF",
      "download_url": "https://cpan.metacpan.org/authors/id/J/JD/JDEGUEST/Locale-Unicode-RBNF-v0.1.0.tar.gz",
      "first": true,
      "main_module": "Locale::Unicode::RBNF",
      "maturity": "released",
      "name": "Locale-Unicode-RBNF-v0.1.0",
      "status": "latest",
      "url": "https://metacpan.org/release/JDEGUEST/Locale-Unicode-RBNF-v0.1.0",
      "version": "v0.1.0"
    }
  ],
  "scope": "all",
  "total": 164190
}
```

### List security advisories

List the known security advisories for a distribution, most recently reported first, with their CVE IDs, the versions they affect and what the problem is. Give a version to see only those that affect it.

**Inputs**

- Distribution (`distribution`, text, required): The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.
- Version (`version`, text): Only advisories that affect this version, such as the one you run. Leave empty for every advisory.

**Outputs**

- `advisories` (list): Known security advisories, most recently reported first.
- `count` (number): How many advisories are listed.
- `distribution` (text): The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
- `total` (number): How many match in all.
- `version` (text): The version the list was narrowed to, when one was given.

**Example output**

```json
{
  "advisories": [
    {
      "affected_versions": [
        "<9.47"
      ],
      "cve_id": "CVE-2026-68914",
      "cve_ids": [
        "CVE-2026-68914"
      ],
      "description": "Mojolicious is a real-time web framework for Perl. Prior to 9.47, the pure-Perl implementation of Mojo::JSON does not limit nesting depth when Cpanel::JSON::XS is unavailable or MOJO_NO_JSON_XS is enabled. An attacker who can supply untrusted JSON to decode_json, from_json, or j can submit deeply nested arrays or objects, causing unbounded recursion, memory exhaustion, and a process crash. ...",
      "id": "CPANSA-Mojolicious-2026-68914",
      "references": [
        "https://github.com/mojolicious/mojo/commit/cc38b0554275c4d84f6b8b49bcbbc1bec2068fe1",
        "https://github.com/mojolicious/mojo/security/advisories/GHSA-p5qf-qvw8-xgvg"
      ],
      "reported": "2026-09-18",
      "severity": null,
      "url": "https://www.cve.org/CVERecord?id=CVE-2026-68914"
    },
    {
      "affected_versions": [
        "<9.48"
      ],
      "cve_id": "CVE-2026-77568",
      "cve_ids": [
        "CVE-2026-77568"
      ],
      "description": "Mojolicious is a real-time web framework for Perl. Prior to 9.48, the Mojolicious CSRF helpers csrf_field, csrf_token, and csrf_protect reuse an unchanged per-session token in rendered HTML. When response compression is enabled and attacker-influenced content is reflected in the same response, an unauthenticated attacker who can induce many victim requests and observe response sizes can use a ...",
      "id": "CPANSA-Mojolicious-2026-77568",
      "references": [
        "https://github.com/mojolicious/mojo/commit/01921fbbbbeca2d1397e082d4a647f9b84c24e27",
        "https://github.com/mojolicious/mojo/security/advisories/GHSA-cf46-h6jw-mj3r"
      ],
      "reported": "2026-09-18",
      "severity": "medium",
      "url": "https://www.cve.org/CVERecord?id=CVE-2026-77568"
    },
    {
      "affected_versions": [
        ">=4.59,<9.48"
      ],
      "cve_id": "CVE-2026-15747",
      "cve_ids": [
        "CVE-2026-15747"
      ],
      "description": "Mojolicious versions from 4.59 before 9.48 for Perl expose a stable representation of the session CSRF token to a BREACH compression oracle.\n\n_csrf_token generates and caches one token per session and returns the same value on every call, and _csrf_field places that value in a hidden `csrf_token` input. When a response carrying the token also echoes attacker-controlled input and is ...",
      "id": "CPANSA-Mojolicious-2026-15747",
      "references": [
        "https://github.com/mojolicious/mojo/commit/01921fbbbbeca2d1397e082d4a647f9b84c24e27.patch",
        "https://metacpan.org/release/SRI/Mojolicious-9.48/changes"
      ],
      "reported": "2026-07-14",
      "severity": "critical",
      "url": "https://www.cve.org/CVERecord?id=CVE-2026-15747"
    }
  ],
  "count": 3,
  "distribution": "Mojolicious",
  "total": 7,
  "version": "9.30"
}
```

### List the most ++ voted distributions

List the distributions MetaCPAN users have given the most ++ votes, up to the top 100, with each one's count.

**Inputs**

- How many (`limit`, number): How many to list, up to 100. From 1 to 100. Default: `25`.

**Outputs**

- `count` (number): How many are listed.
- `distributions` (list): The most ++'d distributions, most first.
- `distributions_with_favorites` (number): How many distributions have at least one ++.

**Example output**

```json
{
  "count": 3,
  "distributions": [
    {
      "distribution": "Mojolicious",
      "favorites": 516,
      "rank": 1,
      "url": "https://metacpan.org/dist/Mojolicious"
    },
    {
      "distribution": "perl",
      "favorites": 447,
      "rank": 2,
      "url": "https://metacpan.org/dist/perl"
    },
    {
      "distribution": "Moose",
      "favorites": 336,
      "rank": 3,
      "url": "https://metacpan.org/dist/Moose"
    }
  ],
  "distributions_with_favorites": 10983
}
```

### Search authors

Find CPAN authors by name, PAUSE ID or the name of an account elsewhere (such as GitHub), 10 a page, each with their PAUSE ID, email, website and country.

**Inputs**

- Name or PAUSE ID (`query`, text, required): A name, a PAUSE ID, or a GitHub username.
- Page (`page`, number): Which page to return, from 1 to 10. MetaCPAN lists the first 100. From 1 to 10. Default: `1`.

**Outputs**

- `authors` (list): Matching authors, 10 a page.
- `count` (number): How many are on this page.
- `more_available` (true/false): True when there are more on later pages: raise 'Page' to read them.
- `page` (number): The page returned, from 1.
- `query` (text): What was searched for.
- `total` (number): How many match in all.

**Example output**

```json
{
  "authors": [
    {
      "ascii_name": null,
      "city": null,
      "country": null,
      "country_code": null,
      "email": "phasefx@cpan.org",
      "gravatar_url": "https://secure.gravatar.com/avatar/dc850cf077cc5ef0541f4c30b68bd310?s=130&d=identicon",
      "name": "Jason Etheridge",
      "pause_id": "PHASEFX",
      "url": "https://metacpan.org/author/PHASEFX",
      "website": null
    },
    {
      "ascii_name": null,
      "city": "Vancouver",
      "country": "Canada",
      "country_code": "CA",
      "email": "ether@cpan.org",
      "gravatar_url": "https://secure.gravatar.com/avatar/bdc5cd06679e732e262f6c1b450a0237?s=130&d=identicon",
      "name": "Karen Etheridge",
      "pause_id": "ETHER",
      "url": "https://metacpan.org/author/ETHER",
      "website": "https://github.com/karenetheridge"
    }
  ],
  "count": 2,
  "more_available": false,
  "page": 1,
  "query": "Etheridge",
  "total": 2
}
```

### Search CPAN

Search CPAN the way metacpan.org does: modules and their documentation, best match first, one result per distribution, each with its best matching module, abstract, author, version and ++ votes. Start the text with author:ETHER, dist:Moose or module:Try::Tiny to narrow it.

**Inputs**

- Search text (`query`, text, required): Words to look for in module names, abstracts and documentation. Add author:PAUSEID to search one author's modules.
- Page (`page`, number): Which page to return, from 1. From 1 to 500. Default: `1`.
- Per page (`per_page`, number): How many to return on a page, up to 100. From 1 to 100. Default: `20`.

**Outputs**

- `count` (number): How many are on this page.
- `more_available` (true/false): True when there are more on later pages: raise 'Page' to read them.
- `page` (number): The page returned, from 1.
- `query` (text): What was searched for.
- `results` (list): One per distribution, best match first.
- `total` (number): How many distributions match in all.

**Example output**

```json
{
  "count": 2,
  "more_available": true,
  "page": 1,
  "query": "json schema",
  "results": [
    {
      "abstract": "validate JSON against a schema",
      "author": "TOBYINK",
      "date": "2014-09-11T21:57:06Z",
      "distribution": "JSON-Schema",
      "favorites": 10,
      "matching_files": 6,
      "module": "JSON::Schema",
      "release": "JSON-Schema-0.016",
      "release_url": "https://metacpan.org/release/TOBYINK/JSON-Schema-0.016",
      "url": "https://metacpan.org/pod/JSON::Schema",
      "version": "0.016"
    },
    {
      "abstract": null,
      "author": "MWADAMS",
      "date": "2026-10-20T13:01:48Z",
      "distribution": "JSON-Schema-Corvus",
      "favorites": 0,
      "matching_files": 20,
      "module": null,
      "release": "JSON-Schema-Corvus-v0.1.0",
      "release_url": "https://metacpan.org/release/MWADAMS/JSON-Schema-Corvus-v0.1.0",
      "url": "https://metacpan.org/dist/JSON-Schema-Corvus",
      "version": "v0.1.0"
    }
  ],
  "total": 480
}
```

### Suggest module names

List the modules whose names start with some text, as metacpan.org suggests them while you type: up to 100, each with its distribution, latest release and author.

**Inputs**

- Name starts with (`query`, text, required): The first part of a module's name, such as Moose:: or DBIx::Class::.
- How many (`limit`, number): How many names to return, up to 100. From 1 to 100. Default: `20`.

**Outputs**

- `count` (number): How many names were suggested.
- `modules` (list): Modules whose names start with the text, in their latest release.
- `query` (text): The text the names start with.

**Example output**

```json
{
  "count": 1,
  "modules": [
    {
      "author": "ETHER",
      "date": "2026-10-01T00:35:44Z",
      "deprecated": false,
      "distribution": "Moose",
      "module": "Moose::Role",
      "release": "Moose-2.4001",
      "url": "https://metacpan.org/pod/Moose::Role"
    }
  ],
  "query": "Moose::R"
}
```
