📚 博客來書籍查詢 API(FastAPI)

一個基於 Python 的 FastAPI 專案,可查詢博客來書籍的詳細資訊、排行榜與條件式搜尋結果。支援書籍介紹、作者資訊、出版細節與分類樹結構,並可回傳 JSON 格式供前端使用。

前往 API Swagger

🚀 專案特色

📂 API 路徑總覽

方法路徑說明
GET/api/book/{pd_id}查詢單本書籍詳細資料
GET/api/book/introduce/{pd_id}查詢書籍簡介
GET/api/books/search多條件搜尋書籍
GET/api/books/search/stats查詢搜尋結果的統計資料
GET/api/books/rank查詢排行榜(每日、每週)

🏗 專案架構

book_model.py       # 定義所有 API 的 Pydantic 資料模型
book_info.py        # 非同步爬蟲:抓取書籍詳細資訊與簡介
book_searcher.py    # 非同步爬蟲:搜尋書籍與取得排行榜
main.py             # FastAPI 主路由設定

🧪 快速啟動

pip install -r requirements.txt
uvicorn main:app --host 0.0.0.0 --port 8000

☁️ 推薦部署方式

建議使用 Render + GitHub Education,可快速部署此專案並綁定自訂網域。

📝 API 範例

GET /api/book/0011016236
回傳:
{
  "ISBN": "9789573286388",
  "title": "問ChatGPT也不會的Python量化交易聖經",
  "price": 450,
  "authors": ["張峮瑋", "黃子靜"]
}