Public API
Read-only, free, no key needed. Returns the same published catalog entries you see on MirrorNest.
Use the API to check for new versions from a script, build a dashboard, or look up a program without scraping pages. Every response is JSON and every endpoint allows cross-origin requests (CORS), so it also works from a browser.
https://mirrornest.com/api/v1List programs
/api/v1/softwarePublished programs, most recently updated first, one page at a time. Combine any of the parameters below.
| Parameter | Type | Description |
|---|---|---|
| platform | ANDROID | WINDOWS | LINUX | MAC | Only programs for this platform. |
| category | slug | Only programs in this category, e.g. developer-tools. |
| format | string | Package format, e.g. deb, rpm, dmg, exe, msi, apk. |
| availability | hosted | linkout | hosted: a file is stored on our servers. linkout: the download is on the official site. |
| page | number | Page number, starting at 1. Default 1. |
| pageSize | number | Items per page. Default 30, maximum 100. |
curl "https://mirrornest.com/api/v1/software?platform=LINUX&format=deb&pageSize=5"Open this example in the browser →
{
"data": [
{
"slug": "example-app-1a2b3c4d",
"name": "Example App",
"summary": "A short description of the program.",
"platform": "LINUX",
"category": "Developer Tools",
"iconUrl": "https://mirrornest.com/files/icons/example-app.webp",
"homepageUrl": "https://example.org",
"licenseType": "OPEN_SOURCE",
"mirrorable": true,
"fileFormat": "deb",
"latestVersion": "2.4.1",
"fileSizeBytes": "18432000",
"updatedAt": "2026-11-01T09:30:00.000Z",
"url": "https://mirrornest.com/software/example-app-1a2b3c4d"
}
],
"page": 1,
"pageSize": 30,
"total": 412,
"totalPages": 14
}Get one program
/api/v1/software/{slug}One program with its latest version, SHA-256 hash, release notes and earlier versions. The slug is the last part of the program's page address.
curl "https://mirrornest.com/api/v1/software/mysql-02e79e6d"Open this example in the browser →
{
"slug": "example-app-1a2b3c4d",
"name": "Example App",
"summary": "A short description of the program.",
"description": "The full description shown on the program's page.",
"platform": "LINUX",
"category": "Developer Tools",
"authorName": "Example Team",
"licenseType": "OPEN_SOURCE",
"fileFormat": "deb",
"architecture": "x64",
"minOsVersion": "Ubuntu 22.04",
"url": "https://mirrornest.com/software/example-app-1a2b3c4d",
"latestVersion": {
"version": "2.4.1",
"publishedAt": "2026-11-01T09:30:00.000Z",
"fileSizeBytes": "18432000",
"sha256": "9f2c…e41a",
"releaseNotes": "Bug fixes and performance improvements.",
"downloadUrl": "https://mirrornest.com/dl/clx0example",
"officialUrl": "https://example.org/download"
},
"versionHistory": [
{ "version": "2.4.0", "publishedAt": "2026-10-12T08:00:00.000Z", "fileSizeBytes": "18300000", "downloadUrl": "https://mirrornest.com/dl/clx0older", "officialUrl": null }
]
}downloadUrl is the same download link the website uses; it is null when the file is not stored on our servers, and then officialUrl points to the official download. Sizes are strings because they can be larger than a JavaScript number holds exactly.
Rate limits
- List: 60 requests per minute per IP address.
- One program: 120 requests per minute per IP address.
- Above the limit the answer is
429with aRetry-Afterheader and aretryAfterSecondsfield. Wait that long and try again.
Errors
404{ "error": "not_found" }: no published program with this slug.429{ "error": "rate_limited", "retryAfterSeconds": 12 }: too many requests.
Fair use
Cache what you can and poll no more often than you need: list answers are cached for a minute, the API index for an hour. Downloads are for the people using your tool, not for mirroring the catalog. See the Termos de Utilização and the De onde vem o nosso software page for where the files come from.
The machine-readable index of endpoints is at https://mirrornest.com/api/v1.