MetaCPAN

App · 20 actions

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.

Actions

ActionWhat it does
Count ++ votesCount the ++ votes MetaCPAN users have given up to 100 distributions, to compare them, with the names CPAN has no distribution for.
Find a download linkFind 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.
Get a moduleGet 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.
Get a module's documentationGet 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.
Get a releaseGet 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.
Get an authorGet 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.
Get distribution statsGet 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.
Get module permissionsSee 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.
Get the Changes fileRead a release's Changes file: the notes for that release, the newest entries each with its version, date and text, and the whole file.
List a distribution's releasesList 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.
List a release's contributorsList 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.
List a release's dependenciesList 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.
List an author's releasesList a CPAN author's releases: every one, newest first, or the latest release of each of their distributions, by name.
List dependent distributionsList 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.
List recent releasesList 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.
List security advisoriesList the known security advisories for a distribution, most recently reported first, with their CVE IDs, the versions they affect and what the problem is.
List the most ++ voted distributionsList the distributions MetaCPAN users have given the most ++ votes, up to the top 100, with each one's count.
Search authorsFind 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.
Search CPANSearch 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.
Suggest module namesList 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.

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

DistributionsdistributionstextRequired
Up to 100 distributions (or their main modules), one per line or separated by commas, or a list from an earlier step.

Outputs

countnumber
How many distributions were counted.
distributionslist
Each distribution's ++ votes, in the order asked.
not_foundlist
The names asked about that CPAN has no distribution for.
total_favoritesnumber
Their ++ votes added together.
Example output
{
  "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 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 distributionnametextRequired
A module such as Try::Tiny, or a distribution such as libwww-perl (a name with a hyphen is read as a distribution).
Versionversiontext
A version, or a range such as >=1.0,<2.0 or ==0.32. Leave empty for the latest.
Include developer releasesinclude_developertrue/false
Also consider developer (trial) releases. Off by default.Default: false.

Outputs

checksum_md5text
The archive's MD5 checksum.
checksum_sha256text
The archive's SHA-256 checksum, to verify it.
datetext
When it was uploaded to CPAN, in UTC, such as '2026-10-01T00:35:44Z'.
distributiontext
The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
download_urltext
The link to download its archive (.tar.gz).
nametext
The module or distribution asked about.
releasetext
The release's name: the distribution and its version, such as 'Moose-2.4001'.
statustext
'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).
versiontext
The release's version, such as '2.4001'.
Example output
{
  "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

ModulemoduletextRequired
The module's name, with :: between its parts, such as Try::Tiny or Moose::Role. 'Search CPAN' finds it.

Outputs

abstracttext
Its one-line summary, such as 'A postmodern object system'.
authortext
The PAUSE ID of the author who uploaded it, such as 'ETHER'. 'Get an author' takes it.
authorizedtrue/false
False when the uploader had no permission for this module.
datetext
When it was uploaded to CPAN, in UTC, such as '2026-10-01T00:35:44Z'.
deprecatedtrue/false
True when its author marked it deprecated.
descriptiontext
The DESCRIPTION section of its documentation, as plain text.
distributiontext
The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
documentationtext
The name its documentation is under, usually the module's own.
download_urltext
The link to download its archive (.tar.gz).
favoritesnumber
Its distribution's ++ votes on MetaCPAN.
indexedtrue/false
False when CPAN's index leaves it out, so clients don't install it by this name.
maturitytext
'released' for a stable release, 'developer' for a trial release (its name ends in -TRIAL or its version has an underscore).
moduletext
The module's name as CPAN writes it, such as 'Try::Tiny'.
pathtext
Its file in the release, such as 'lib/Try/Tiny.pm'.
releasetext
The release's name: the distribution and its version, such as 'Moose-2.4001'.
release_urltext
The release's page on metacpan.org.
release_versiontext
The version of the release that holds it.
source_urltext
Its source code on metacpan.org.
statustext
'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).
urltext
Its documentation on metacpan.org.
versiontext
The module's own version, such as '0.32'.
Example output
{
  "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

ModulemoduletextRequired
The module's name, with :: between its parts, such as Try::Tiny or Moose::Role. 'Search CPAN' finds it.
Formatoutput_formattext
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

charactersnumber
How long the documentation is, in characters.
contenttext
The whole documentation, in that format.
content_typetext
The format's media type, such as text/x-markdown.
formattext
markdown, text, html or pod.
moduletext
The module's name as CPAN writes it.
urltext
The documentation on metacpan.org.
Example output
{
  "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

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

Outputs

abstracttext
Its one-line summary, such as 'A postmodern object system'.
archivetext
Its archive's file name.
authortext
The PAUSE ID of the author who uploaded it, such as 'ETHER'. 'Get an author' takes it.
authorizedtrue/false
False when the uploader had no permission for the modules it holds, so CPAN clients don't install it.
authorslist
The authors its metadata names, with their emails.
bugtracker_emailtext
The email address for bug reports, when it has one.
bugtracker_urltext
Where to report bugs, when it says.
changes_filetext
Its Changes file's name, such as 'Changes'.
checksum_md5text
The archive's MD5 checksum.
checksum_sha256text
The archive's SHA-256 checksum, to verify it.
datetext
When it was uploaded to CPAN, in UTC, such as '2026-10-01T00:35:44Z'.
dependency_countnumber
How many dependencies it declares, of every phase and kind.
deprecatedtrue/false
True when its author marked it deprecated.
distributiontext
The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
distribution_urltext
The distribution's page on metacpan.org.
download_urltext
The link to download its archive (.tar.gz).
firsttrue/false
True when this was the distribution's first release.
homepagetext
Its homepage, when it names one.
licenselist
Its licenses, such as 'perl_5' or 'mit'.
main_moduletext
The distribution's main module, such as 'Moose'.
maturitytext
'released' for a stable release, 'developer' for a trial release (its name ends in -TRIAL or its version has an underscore).
nametext
The release's name: the distribution and its version, such as 'Moose-2.4001'.
perl_versiontext
The oldest perl it runs on, such as '5.008003', when it says.
provideslist
The modules it provides, such as 'Moose::Role'.
provides_countnumber
How many modules it provides.
repository_urltext
Its source repository, to clone.
repository_webtext
Its source repository's web page.
size_bytesnumber
Its archive's size, in bytes.
statustext
'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_failnumber
CPAN Testers reports that failed.
tests_nanumber
CPAN Testers reports where it could not be tested.
tests_passnumber
CPAN Testers reports that passed.
tests_unknownnumber
CPAN Testers reports with no result (no tests ran).
urltext
The release's page on metacpan.org.
versiontext
The release's version, such as '2.4001'.
Example output
{
  "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 IDpause_idtextRequired
The author's PAUSE ID, the name they upload to CPAN under, such as ETHER. 'Search authors' finds it.

Outputs

ascii_nametext
Their name in plain letters, when it has others.
backpan_releasesnumber
How many of their releases were deleted from CPAN (kept on BackPAN).
citytext
The city they gave, such as 'Vancouver'.
countrytext
Their country, such as 'Canada'.
country_codetext
Their country's two-letter code, such as 'CA'.
cpan_directorytext
Their folder of uploads on CPAN.
cpantesters_reportstext
Their CPAN Testers results.
current_releasesnumber
How many distributions have their current release by them.
emailtext
Their first public email address.
emailslist
Every public email address.
gravatar_urltext
Their picture (Gravatar).
nametext
Their name, such as 'Karen Etheridge'.
older_releasesnumber
How many of their older releases are still on CPAN.
pause_idtext
Their PAUSE ID, such as 'ETHER'.
profileslist
Their accounts elsewhere.
regiontext
Their region or state, as they wrote it.
updatedtext
When they last changed their profile, in UTC.
urltext
Their page on metacpan.org.
websitetext
Their first website.
websiteslist
Every website they list.
Example output
{
  "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

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

Outputs

all_dependentsnumber
How many depend on it directly or through others: its place in CPAN's river.
bus_factornumber
How many people have released it recently: how many could keep it going.
dependentsnumber
How many distributions require it directly.
distributiontext
The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
github_closednumber
Closed GitHub issues.
github_opennumber
Open GitHub issues, when it uses GitHub for bugs.
github_repositorytext
Its GitHub repository, when it has one.
github_starsnumber
Its GitHub stars.
github_watchersnumber
Its GitHub watchers.
packageslist
The operating system packages that ship it.
river_bucketnumber
Its place in the river from 0 (nothing depends on it) to 5 (much of CPAN does).
rt_activenumber
Active tickets in RT: new, open and stalled.
rt_closednumber
Closed tickets in RT: resolved and rejected.
rt_newnumber
New tickets in RT nobody has picked up.
rt_opennumber
Open tickets in RT, CPAN's bug tracker.
rt_rejectednumber
Rejected tickets in RT.
rt_resolvednumber
Resolved tickets in RT.
rt_stallednumber
Stalled tickets in RT.
rt_urltext
Its tickets in RT.
urltext
Its page on metacpan.org.
Example output
{
  "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

ModulesmodulestextRequired
Up to 100 module names, one per line or separated by commas, or a list from an earlier step.

Outputs

countnumber
How many of them CPAN has permissions for.
not_foundlist
The names asked about that CPAN has no permissions for.
permissionslist
Each module's permissions, in the order asked.
requestednumber
How many modules were asked about.
Example output
{
  "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

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

Outputs

authortext
The PAUSE ID of the author who uploaded it, such as 'ETHER'. 'Get an author' takes it.
contenttext
The whole file, as written.
countnumber
How many entries are listed.
datetext
When it was uploaded to CPAN, in UTC, such as '2026-10-01T00:35:44Z'.
distributiontext
The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
entrieslist
The newest entries, in the file's order.
entry_countnumber
How many entries the file has in all.
filetext
The file's name in the release, such as 'Changes'.
releasetext
The release's name: the distribution and its version, such as 'Moose-2.4001'.
release_notestext
The entry for this release's own version: what changed in it. Empty when the file has no entry for that version.
urltext
The file on metacpan.org.
versiontext
The release's version, such as '2.4001'.
Example output
{
  "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

DistributiondistributiontextRequired
The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.
Maturitymaturitytext
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.
Pagepagenumber
Which page to return, from 1.From 1 to 500. Default: 1.
Per pageper_pagenumber
How many to return on a page, up to 100.From 1 to 100. Default: 50.

Outputs

countnumber
How many are on this page.
distributiontext
The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
maturitytext
any, released or developer: which were listed.
more_availabletrue/false
True when there are more on later pages: raise 'Page' to read them.
pagenumber
The page returned, from 1.
releaseslist
Its releases, newest first.
totalnumber
How many match in all.
Example output
{
  "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

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

Outputs

authortext
The PAUSE ID of the author who uploaded it, such as 'ETHER'. 'Get an author' takes it.
contributorslist
Everyone it credits, by name.
countnumber
How many people it credits.
distributiontext
The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
releasetext
The release's name: the distribution and its version, such as 'Moose-2.4001'.
versiontext
The release's version, such as '2.4001'.
with_pause_idnumber
How many of them are CPAN authors.
Example output
{
  "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

DistributiondistributiontextRequired
The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.
Versionversiontext
Which release, such as 2.4000. Leave empty for the latest release.
Phasesphaseslist
Only these phases. Leave empty for every phase.One or more of: runtime, configure, build, test, develop.
Kindsrelationshipslist
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

authortext
The PAUSE ID of the author who uploaded it, such as 'ETHER'. 'Get an author' takes it.
countnumber
How many are listed, after the phase and kind filters.
dependencieslist
What it needs: runtime first, then configure, build, test and develop.
distributiontext
The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
moduleslist
The modules listed, each once and without perl itself: a list to hand to another step.
perl_versiontext
The oldest perl it runs on, such as '5.008003', when it says.
releasetext
The release's name: the distribution and its version, such as 'Moose-2.4001'.
totalnumber
How many dependencies it declares in all.
versiontext
The release's version, such as '2.4001'.
Example output
{
  "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 IDpause_idtextRequired
The author's PAUSE ID, the name they upload to CPAN under, such as ETHER. 'Search authors' finds it.
Which releasesscopetext
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.
Pagepagenumber
Which page to return, from 1.From 1 to 500. Default: 1.
Per pageper_pagenumber
How many to return on a page, up to 100.From 1 to 100. Default: 50.

Outputs

countnumber
How many are on this page.
more_availabletrue/false
True when there are more on later pages: raise 'Page' to read them.
pagenumber
The page returned, from 1.
pause_idtext
The author's PAUSE ID.
releaseslist
Their releases: newest first, or by distribution name for the latest of each.
scopetext
all or latest: which releases were listed.
totalnumber
How many match in all.
Example output
{
  "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 modulenametextRequired
A distribution such as Try-Tiny, or a module such as Moose::Role for the distributions that require that module alone.
Ordersorttext
Newest release first, or by name.One of: date:desc (Newest release first), distribution:asc (Distribution name, A to Z). Default: date:desc.
Pagepagenumber
Which page to return, from 1.From 1 to 500. Default: 1.
Per pageper_pagenumber
How many to return on a page, up to 100.From 1 to 100. Default: 20.

Outputs

countnumber
How many are on this page.
dependentslist
The current release of each distribution that requires it.
looked_up_astext
distribution or module: what the name was read as.
more_availabletrue/false
True when there are more on later pages: raise 'Page' to read them.
nametext
The distribution or module asked about.
pagenumber
The page returned, from 1.
sorttext
The order: date:desc or distribution:asc.
totalnumber
How many match in all.
Example output
{
  "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 releasesscopetext
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.
Maturitymaturitytext
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 afterreleased_afterdate
Only releases uploaded on this day (UTC) or later.
Uploaded on or beforereleased_beforedate
Only releases uploaded on this day (UTC) or earlier.
Pagepagenumber
Which page to return, from 1.From 1 to 500. Default: 1.
Per pageper_pagenumber
How many to return on a page, up to 100.From 1 to 100. Default: 20.

Outputs

countnumber
How many are on this page.
maturitytext
any, released or developer.
more_availabletrue/false
True when there are more on later pages: raise 'Page' to read them.
pagenumber
The page returned, from 1.
releaseslist
Releases on CPAN, newest first.
scopetext
all or new: which releases were listed.
totalnumber
How many match in all.
Example output
{
  "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

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

Outputs

advisorieslist
Known security advisories, most recently reported first.
countnumber
How many advisories are listed.
distributiontext
The distribution's name, such as 'Moose' or 'Try-Tiny': the package CPAN installs. Every action that takes a distribution accepts it.
totalnumber
How many match in all.
versiontext
The version the list was narrowed to, when one was given.
Example output
{
  "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 manylimitnumber
How many to list, up to 100.From 1 to 100. Default: 25.

Outputs

countnumber
How many are listed.
distributionslist
The most ++'d distributions, most first.
distributions_with_favoritesnumber
How many distributions have at least one ++.
Example output
{
  "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 IDquerytextRequired
A name, a PAUSE ID, or a GitHub username.
Pagepagenumber
Which page to return, from 1 to 10. MetaCPAN lists the first 100.From 1 to 10. Default: 1.

Outputs

authorslist
Matching authors, 10 a page.
countnumber
How many are on this page.
more_availabletrue/false
True when there are more on later pages: raise 'Page' to read them.
pagenumber
The page returned, from 1.
querytext
What was searched for.
totalnumber
How many match in all.
Example output
{
  "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 textquerytextRequired
Words to look for in module names, abstracts and documentation. Add author:PAUSEID to search one author's modules.
Pagepagenumber
Which page to return, from 1.From 1 to 500. Default: 1.
Per pageper_pagenumber
How many to return on a page, up to 100.From 1 to 100. Default: 20.

Outputs

countnumber
How many are on this page.
more_availabletrue/false
True when there are more on later pages: raise 'Page' to read them.
pagenumber
The page returned, from 1.
querytext
What was searched for.
resultslist
One per distribution, best match first.
totalnumber
How many distributions match in all.
Example output
{
  "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 withquerytextRequired
The first part of a module's name, such as Moose:: or DBIx::Class::.
How manylimitnumber
How many names to return, up to 100.From 1 to 100. Default: 20.

Outputs

countnumber
How many names were suggested.
moduleslist
Modules whose names start with the text, in their latest release.
querytext
The text the names start with.
Example output
{
  "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"
}

On this page