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