API

nxdb offered a free-to-use API. You were able to utilize a portion of nxdb's dataset in your own application or website. Please give credit to nxdb if you did.

Please keep in mind that nxdb also offers free-to-use RSS feeds, found at the top of the Games, Recently Updated, Recently Added, and Popular pages. Utilizing these instead may save you time and do not incur usage limtations.

Registration

Key registration is no longer available. All keys previously given will be rendered invalid.

The API is now non-functional. The documentation is kept for posterity. However, the RSS feeds are still available for use.

Limitations
  • No more than 60 requests per minute. If this limit is exceeded, a 429 code will be returned. The key will be frozen for 10 minutes.
  • Limited dataset

It should be noted that requests with different keys emanating from the same IP address will not be answered. In other words, cycling through a bank of keys or randomizing a key for each request is disallowed.

Requests & responses

All requests must be sent using the POST method, have a multipart form, and lack URL parameters.

All responses are in JSON.

Key Default value Description
status ok Status message. Values:
  • bad (failure)
  • invalid id (title ID is nonexistent)
  • timeout (key is temporarily frozen)
  • ok (success)
data [ ] List of returned objects.
POST /api/GetDlc

Returns a list of DLC for a given title ID.

Request
Key Description
id (required, string) title ID
Response
{
  "result": "ok",
  "data": [
    {
      "dlcId": "01007EF00011F001",
      "name": "The Legend of Zelda: \nBreath of the Wild DLC Pack 1"
    },
    ...
  ]
}
POST /api/GetPopular

Returns a list of popular games.

Request

No body

Response
{
  "result": "ok",
  "data": [
    {
      "id": "0100913019170000",
      "name": "MLB® The Show™ 23",
      "iconUrl": "https://img-eshop.cdn.nintendo.net/i/a21931ce83eebd9751e810bd3c6446143862c26c14978e9434e7ef3fc13fd3a5.jpg",
      "publisher": "MLBAM"
    },
    ...
  ]
}
POST /api/GetRecentlyAdded

Returns a list of titles that were recently added to the eShop. Limited to 50 results.

Request
Key Description
japanese (optional, boolean) include Japanese games, value is true or false
limit (optional, integer) limit results, range is between 1-50
Response
{
  "result": "ok",
  "data": [
    {
      "id": "0100A9B0187CA000",
      "name": "ANONYMOUS;CODE",
      "publisher": "Spike Chunsoft US",
      "releaseDate": "2023-09-08",
      "iconUrl": "https://img-eshop.cdn.nintendo.net/i/1b0a6c5657c418427ca3638e8ba21ca941af45810c5110d880fca5aa18a8347b.jpg",
      "size": 4799332352
    },
    ...
  ]
}
POST /api/GetRecentlyUpdated

Returns a list of titles that were recently updated in the eShop. Limited to 50 results.

Request
Key Description
japanese (optional, boolean) include Japanese games, value is true or false
limit (optional, integer) limit results, range is between 1-50
Response
{
  "result": "ok",
  "data": [
    {
      "id": "01007EF00011E000",
      "name": "The Legend of Zelda™: Breath of the Wild",
      "iconUrl": "https://img-eshop.cdn.nintendo.net/i/d3c210e61e8487200fc4c344987243a60257838187a69a6a81c42d7447d5d192.jpg",
      "date": "2019-04-25",
      "version": 786432
    },
    ...
  ]
}
POST /api/GetVersions

Returns a list of versions for a given title ID.

Request
Key Description
id (required, string) title ID
Response
{
  "result": "ok",
  "data": [
    {
      "version": 0,
      "date": null,
      "minSysVer": "1.0.0",
      "size": 14476251648
    },
    ...
  ]
}