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
| Action | What it does |
|---|---|
| Count ++ votes | Count the ++ votes MetaCPAN users have given up to 100 distributions, to compare them, with the names CPAN has no distribution for. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
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
distributionstextRequired - 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 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
nametextRequired - A module such as Try::Tiny, or a distribution such as libwww-perl (a name with a hyphen is read as a distribution).
- Version
versiontext - A version, or a range such as >=1.0,<2.0 or ==0.32. Leave empty for the latest.
- Include developer releases
include_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
- Module
moduletextRequired - 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
- Module
moduletextRequired - The module's name, with :: between its parts, such as Try::Tiny or Moose::Role. 'Search CPAN' finds it.
- Format
output_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
- Distribution
distributiontextRequired - The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.
- Version
versiontext - 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 ID
pause_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
- Distribution
distributiontextRequired - 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
- Modules
modulestextRequired - 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
- Distribution
distributiontextRequired - The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.
- Version
versiontext - Which release, such as 2.4000. Leave empty for the latest release.
- Entries
entriesnumber - 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
- Distribution
distributiontextRequired - The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.
- Maturity
maturitytext - 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
pagenumber - Which page to return, from 1.From 1 to 500. Default:
1. - Per page
per_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
- Distribution
distributiontextRequired - The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.
- Version
versiontext - 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
- Distribution
distributiontextRequired - The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.
- Version
versiontext - Which release, such as 2.4000. Leave empty for the latest release.
- Phases
phaseslist - Only these phases. Leave empty for every phase.One or more of:
runtime,configure,build,test,develop. - Kinds
relationshipslist - 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 ID
pause_idtextRequired - The author's PAUSE ID, the name they upload to CPAN under, such as ETHER. 'Search authors' finds it.
- Which releases
scopetext - 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
pagenumber - Which page to return, from 1.From 1 to 500. Default:
1. - Per page
per_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 module
nametextRequired - A distribution such as Try-Tiny, or a module such as Moose::Role for the distributions that require that module alone.
- Order
sorttext - Newest release first, or by name.One of:
date:desc(Newest release first),distribution:asc(Distribution name, A to Z). Default:date:desc. - Page
pagenumber - Which page to return, from 1.From 1 to 500. Default:
1. - Per page
per_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 releases
scopetext - 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
maturitytext - 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_afterdate - Only releases uploaded on this day (UTC) or later.
- Uploaded on or before
released_beforedate - Only releases uploaded on this day (UTC) or earlier.
- Page
pagenumber - Which page to return, from 1.From 1 to 500. Default:
1. - Per page
per_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
- Distribution
distributiontextRequired - The distribution, such as Moose or Try-Tiny. Its main module's name (Try::Tiny) or its metacpan.org link works too.
- Version
versiontext - 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 many
limitnumber - 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 ID
querytextRequired - A name, a PAUSE ID, or a GitHub username.
- Page
pagenumber - 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 text
querytextRequired - Words to look for in module names, abstracts and documentation. Add author:PAUSEID to search one author's modules.
- Page
pagenumber - Which page to return, from 1.From 1 to 500. Default:
1. - Per page
per_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 with
querytextRequired - The first part of a module's name, such as Moose:: or DBIx::Class::.
- How many
limitnumber - 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"
}