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.

Base URL
https://mirrornest.com/api/v1
Format
JSON, UTF-8
Authentication
None

List programs

GET/api/v1/software

Published programs, most recently updated first, one page at a time. Combine any of the parameters below.

ParameterTypeDescription
platformANDROID | WINDOWS | LINUX | MACOnly programs for this platform.
categoryslugOnly programs in this category, e.g. developer-tools.
formatstringPackage format, e.g. deb, rpm, dmg, exe, msi, apk.
availabilityhosted | linkouthosted: a file is stored on our servers. linkout: the download is on the official site.
pagenumberPage number, starting at 1. Default 1.
pageSizenumberItems per page. Default 30, maximum 100.
Example request
curl "https://mirrornest.com/api/v1/software?platform=LINUX&format=deb&pageSize=5"

Open this example in the browser →

Example response
{
  "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

GET/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.

Example request
curl "https://mirrornest.com/api/v1/software/mysql-02e79e6d"

Open this example in the browser →

Example response
{
  "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 429 with a Retry-After header and a retryAfterSeconds field. 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 Условия and the Откуда мы берём программы page for where the files come from.

The machine-readable index of endpoints is at https://mirrornest.com/api/v1.