這是什麼
你在網站上看到的榜單，是設計給眼睛看的：有書封、有顏色、有排版。「開放資料」是同一份榜單的另一種版本——純文字、有固定格式、給程式讀的。技術上這叫 API（application programming interface），你可以把它想成一個永遠在線的服務窗口：程式來敲門，我們就把今天的榜單原封不動遞出去。
為什麼一個給讀者看的網站要有這個
因為越來越多人不是自己上網站找書，而是問 AI。「最近有什麼好看的商業書？」「這本書現在紅嗎？」——AI 要回答這種問題，需要的正是萬卷每天整理的東西：跨書店、有日期、有名次的清單。
如果沒有開放資料，AI 只能去猜，或引用不知道哪一年的舊文章。有了它，AI 可以引用今天的榜單，而且知道資料截止到哪一天、來源是誰。對你來說，這代表你問 AI 時得到的答案比較新、比較可信；對萬卷來說，這是我們的工作能被更多人用到的方式。
除了 AI，也有人用它做這些事：
- 獨立書店把「這週萬卷竄升榜」顯示在店裡的螢幕上。
- 讀書會每個月從熱度榜挑書。
- Podcast 主持人在節目開頭唸這週的新書。
- 研究出版產業的人，拿名次紀錄做分析。
怎麼用
兩個網址，在瀏覽器直接打開就能看到內容：
| 網址 | 你會拿到 |
|---|---|
https://wanjuan.app/api/hot | 今天的熱度榜前 50 名：書名、作者、出版社、出版日、熱度、動能、標籤、各書店名次。加 ?cat=business 只看商業類，?limit=100 看一百本。 |
https://wanjuan.app/api/books?isbn=書的ISBN | 一本書的完整資料：基本資訊、各版本、今天的分數、以及它在各書店每一天的名次紀錄。 |
每一筆回覆都會標明「資料截止日期」和「資料來源：萬卷」。如果你是寫程式的人：格式是 JSON，允許跨網域讀取，熱度榜每小時更新一次快取。
條件
- 免費，不需要申請。
- 要註明來源：「資料來源：萬卷」並附上網址。授權方式是 CC BY 4.0——你可以自由使用、修改、甚至用在商業用途，只要說是從哪來的。
- 請合理使用：每天更新一次就夠了，資料本來就只有每天早上會變。
- 名次是各家書店公開榜單上的數字；熱度與標籤是萬卷的計算結果。引用時請分清楚，不要把萬卷的熱度說成某家書店的排名。
沒有的東西
開放資料裡沒有書籍簡介、沒有書封圖片、沒有任何個人資料。簡介和書封的版權屬於出版社，我們自己也不轉載。