Skip to content

Instantly share code, notes, and snippets.

@Shy07
Last active April 21, 2024 07:19
Show Gist options
  • Star 53 You must be signed in to star a gist
  • Fork 17 You must be signed in to fork a gist
  • Save Shy07/822eff655ec8da2717f269bc21c65976 to your computer and use it in GitHub Desktop.
Save Shy07/822eff655ec8da2717f269bc21c65976 to your computer and use it in GitHub Desktop.
Nintendo Switch eShop API

港区所有游戏列表 Game Full List HK

https://www.nintendo.com.hk/data/json/switch_software.json

日区所有游戏列表 Game Full List JP

https://www.nintendo.co.jp/data/software/xml/switch.xml

美区所有游戏列表 Game Full List US

[POST]https://u3b6gr4ua3-1.algolianet.com/1/indexes/*/queries?x-algolia-agent=Algolia%20for%20JavaScript%20(3.33.0)%3B%20Browser%20(lite)%3B%20JS%20Helper%202.20.1&x-algolia-application-id=U3B6GR4UA3&x-algolia-api-key=c4da8be7fd29f0f5bfa42920b0a99dc7

{
  "requests": [{
  "indexName":"ncom_game_en_us",
  "params": "query=&hitsPerPage=42&maxValuesPerFacet=30&page=1&analytics=false&facets=%5B%22generalFilters%22%2C%22platform%22%2C%22availability%22%2C%22genres%22%2C%22howToShop%22%2C%22virtualConsole%22%2C%22franchises%22%2C%22priceRange%22%2C%22esrbRating%22%2C%22playerFilters%22%5D&tagFilters="
  }]
}

打折游戏列表 Discounting Game List

日区 Japanese:

https://ec.nintendo.com/api/JP/ja/search/sales?count=30&offset=0

英语区 English:

https://ec.nintendo.com/api/US/en/search/sales?count=30&offset=0
https://ec.nintendo.com/api/GB/en/search/sales?count=10&offset=0
https://ec.nintendo.com/api/CA/en/search/sales?count=30&offset=0#Canada
https://ec.nintendo.com/api/AU/en/search/sales?count=10&offset=0#Australia
https://ec.nintendo.com/api/NZ/en/search/sales?count=10&offset=0#NewZealand
https://ec.nintendo.com/api/CZ/en/search/sales?count=10&offset=0#Czech
https://ec.nintendo.com/api/DK/en/search/sales?count=10&offset=0#Denmark
https://ec.nintendo.com/api/FI/en/search/sales?count=10&offset=0#Finland
https://ec.nintendo.com/api/GR/en/search/sales?count=10&offset=0#Greece
https://ec.nintendo.com/api/HU/en/search/sales?count=10&offset=0#Hungary
https://ec.nintendo.com/api/NO/en/search/sales?count=10&offset=0#Norway
https://ec.nintendo.com/api/PL/en/search/sales?count=10&offset=0#Poland
https://ec.nintendo.com/api/ZA/en/search/sales?count=10&offset=0#SouthAfrica
https://ec.nintendo.com/api/SE/en/search/sales?count=10&offset=0#Sweden

德语区 German:

https://ec.nintendo.com/api/DE/de/search/sales?count=10&offset=0
https://ec.nintendo.com/api/CH/de/search/sales?count=10&offset=0#Switzerland

法语区 French:

https://ec.nintendo.com/api/FR/fr/search/sales?count=10&offset=0
https://ec.nintendo.com/api/BE/fr/search/sales?count=10&offset=0#Belgium

意大利 Italian:

https://ec.nintendo.com/api/IT/it/search/sales?count=10&offset=0

荷兰 Dutch:

https://ec.nintendo.com/api/NL/nl/search/sales?count=10&offset=0
https://ec.nintendo.com/api/BE/nl/search/sales?count=10&offset=0#Belgium

俄区 Russian:

https://ec.nintendo.com/api/RU/ru/search/sales?count=30&offset=0

西语区 Spanish:

https://ec.nintendo.com/api/ES/es/search/sales?count=30&offset=0
https://ec.nintendo.com/api/MX/es/search/sales?count=30&offset=0#Mexico
https://ec.nintendo.com/api/CO/es/search/sales?count=10&offset=0#Columbia
https://ec.nintendo.com/api/AR/es/search/sales?count=10&offset=0#Argentina
https://ec.nintendo.com/api/CL/es/search/sales?count=10&offset=0#Chile
https://ec.nintendo.com/api/PE/es/search/sales?count=10&offset=0#Peru

葡语区 Portuguese:

https://ec.nintendo.com/api/PT/pt/search/sales?count=30&offset=0
https://ec.nintendo.com/api/BR/pt/search/sales?count=10&offset=0

亚洲区 Asian:

https://ec.nintendo.com/api/HK/zh/search/sales?count=10&offset=0
https://ec.nintendo.com/api/KR/ko/search/sales?count=10&offset=0

Return

  • contents: array
    • content_type: string
    • disclaimer: string
    • dominant_colors: string[]
    • formal_name: string
    • hero_banner_url: string
    • id: number
    • is_new: boolean
    • public_status: string
    • release_date_on_eshop: string
    • strong_disclaimer: string
    • tags: array
    • target_titles: array
  • length: number
  • offset: number
  • total: number

游戏价格查询 Game Price Query

https://api.ec.nintendo.com/v1/price?country=JP&ids=70010000009922&lang=jp

Return

  • personalized: boolean
  • country: string
  • prices: array
    • title_id: number,
    • sales_status: string
    • regular_price:
      • amount: string
      • currency: string
      • raw_value: string
    • discount_price:
      • amount: string
      • currency: string
      • raw_value: string
      • start_datetime: date
      • end_datetime: date

最新发售游戏列表 Latest Released Game List

https://ec.nintendo.com/api/JP/ja/search/new?count=30&offset=0

下载游戏排行 Downloading Game Ranking

https://ec.nintendo.com/api/JP/ja/search/ranking?count=10&offset=0

@LukeLandWalker
Copy link

你好,想请问下,因为同一个游戏在各个区游戏的 id 都不一样,有没有相关的 api 能够拉到各个区「游戏-id」对应信息呢

@Shy07
Copy link
Author

Shy07 commented May 30, 2020

你好,想请问下,因为同一个游戏在各个区游戏的 id 都不一样,有没有相关的 api 能够拉到各个区「游戏-id」对应信息呢

你好,老任官方并没有这样的 api,所以除了通过游戏名关联起来没有太好的办法

@LukeLandWalker
Copy link

LukeLandWalker commented May 30, 2020

哦,好的,谢谢!看来只有通过 ID 号最后几位从 0 开始暴力遍历,才能拉到例如澳区所有游戏信息了。

@deadbird503
Copy link

请问现在有比较好的方法,把不同区同一个游戏关联起来吗

@Shy07
Copy link
Author

Shy07 commented Jul 16, 2020

请问现在有比较好的方法,把不同区同一个游戏关联起来吗

任天堂Switch游戏列表

可以尝试抓取这个列表的游戏名

@hungwei0331
Copy link

請問Game Details�的範例url是不是有錯誤呢?
https://ec.nintendo.com/JP/ja/titles/70010000012325

@Shy07
Copy link
Author

Shy07 commented Oct 1, 2020

請問Game Details�的範例url是不是有錯誤呢?
https://ec.nintendo.com/JP/ja/titles/70010000012325

这个不是 api,但是可以通过 http get 请求到数据,然后通过正则或者其他手段取得数据

可以带上 view-source 或者右键源代码看到
view-source:https://ec.nintendo.com/JP/ja/titles/70010000012325

搜索 NXSTORE.titleDetail.jsonData

@ougula
Copy link

ougula commented Nov 26, 2020

請問Game Details�的範例url是不是有錯誤呢?
https://ec.nintendo.com/JP/ja/titles/70010000012325

这个不是 api,但是可以通过 http get 请求到数据,然后通过正则或者其他手段取得数据

可以带上 view-source 或者右键源代码看到
view-source:https://ec.nintendo.com/JP/ja/titles/70010000012325

搜索 NXSTORE.titleDetail.jsonData

您好,请问这个怎么获取到英文的游戏名呢,我没找到您说的 NXSTORE.titleDetail.jsonData

@Shy07
Copy link
Author

Shy07 commented Feb 4, 2021

請問Game Details�的範例url是不是有錯誤呢?
https://ec.nintendo.com/JP/ja/titles/70010000012325

这个不是 api,但是可以通过 http get 请求到数据,然后通过正则或者其他手段取得数据
可以带上 view-source 或者右键源代码看到
view-source:https://ec.nintendo.com/JP/ja/titles/70010000012325
搜索 NXSTORE.titleDetail.jsonData

您好,请问这个怎么获取到英文的游戏名呢,我没找到您说的 NXSTORE.titleDetail.jsonData

你好,老任已经把游戏详情部分改成后端渲染,所以 api 化的数据已经获取不到了:(

@Bpleo
Copy link

Bpleo commented Apr 28, 2021

您好,想请问一下现在是不是没法儿获取美区的所有游戏列表了?

@Shy07
Copy link
Author

Shy07 commented May 10, 2021

您好,想请问一下现在是不是没法儿获取美区的所有游戏列表了?

你好,美区的 API 用的是第三方服务,不太想打广告,姑且先更新出来,使用与否可自判自研

@zoligit
Copy link

zoligit commented May 12, 2021

冒昧的问一下 这是老任提供全部官方接口吗 是否有详细的文档,我在官网怎么没找到

@Shy07
Copy link
Author

Shy07 commented May 12, 2021

冒昧的问一下 这是老任提供全部官方接口吗 是否有详细的文档,我在官网怎么没找到

老任并未提供开放型 API,这些都是网页版 eshop 使用的 API,用浏览器 DevTools 分析得到的

@zoligit
Copy link

zoligit commented May 17, 2021

https://ec.nintendo.com/api/HK/zh/search/sales?count=30&offset=0

count最大30 大于30报错 是什么情况

@Shy07
Copy link
Author

Shy07 commented May 17, 2021

https://ec.nintendo.com/api/HK/zh/search/sales?count=30&offset=0

count最大30 大于30报错 是什么情况

这个 count 是分页数据上限,大于 30 报错说明每页最多三十条数据,要获取后面的数据可修改 offset

@Shy07
Copy link
Author

Shy07 commented May 17, 2021

https://ec.nintendo.com/api/HK/zh/search/sales?count=30&offset=0
count最大30 大于30报错 是什么情况

这个 count 是分页数据上限,大于 30 报错说明每页最多三十条数据,要获取后面的数据可修改 offset
offset 能传什么参数 传1试了以下不行

offset 应该是 count 的倍数,比如 count=5&offset=5,count=5&offset=15,count=30&offset=60
offset = count * page

@zoligit
Copy link

zoligit commented May 17, 2021

https://ec.nintendo.com/api/HK/zh/search/sales?count=30&offset=0
count最大30 大于30报错 是什么情况

这个 count 是分页数据上限,大于 30 报错说明每页最多三十条数据,要获取后面的数据可修改 offset
offset 能传什么参数 传1试了以下不行

offset 应该是 count 的倍数,比如 count=5&offset=5,count=5&offset=15,count=30&offset=60
offset = count * page

回复好块 已经知道了 所以删了问题

@zoligit
Copy link

zoligit commented May 17, 2021

请问你对switch研究的多吗,我看获取折扣 应该不是从网页版分析的, 应该是从switch机器里的那个eshop分析的

@Shy07
Copy link
Author

Shy07 commented May 17, 2021

请问你对switch研究的多吗,我看获取折扣 应该不是从网页版分析的, 应该是从switch机器里的那个eshop分析的

无,都是从网页版获取的,只是网页经常改版,以前的 api 现在看不到了很正常

@willmao8
Copy link

willmao8 commented Jan 2, 2024

2024年了 似乎有一些接口已经失效了

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment