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 Conditions and the D'où vient notre logiciel page for where the files come from.
The machine-readable index of endpoints is at https://mirrornest.com/api/v1.