# KDPTop

> KDPTop (https://kdptop.com) tracks the Amazon.com book market for Kindle Direct Publishing (KDP) research:
> the full Amazon Books and Kindle eBooks category tree (English + Simplified Chinese names), daily snapshots of
> each category's Best Sellers, New Releases and Top 100 Free (Kindle) lists, per-book (ASIN) ranking history,
> sales estimates, keyword search volume, author catalogs and per-category opportunity metrics (median reviews,
> median price, list turnover, new-release ratio, 0-100 score).

## Pages

- [Home](https://kdptop.com/): what KDPTop does, decision cards, recent breakout books, FAQ
- [Pricing](https://kdptop.com/pricing): Free, Creator, Pro and Team plans, monthly or yearly
- [KDP category finder](https://kdptop.com/tools/kdp-category): free tool, which KDP categories fit a book
- [Chrome extension](https://kdptop.com/extension): sales estimates and BSR history on Amazon pages
- [User guide](https://kdptop.com/help): every feature and metric explained
- Chinese versions: add `?lang=zh` to any page URL

All data endpoints require an API key (create one at https://kdptop.com/developer), sent as
`Authorization: Bearer kdp_...`, `X-API-Key: kdp_...`, or `?key=kdp_...` for clients that cannot set headers.
Daily call quotas depend on the account plan.

## Access

- [MCP endpoint](https://kdptop.com/api/mcp): Streamable HTTP, stateless JSON. Read-only tools: search, fetch, search_categories, get_category, get_bestseller_list, search_books, get_book, find_opportunities, get_breakouts, get_stats
- [REST API base](https://kdptop.com/api/v1): JSON, GET only
- [OpenAPI 3.1 schema](https://kdptop.com/api/v1/openapi.json): import into ChatGPT GPT Actions, Postman, SDK generators
- [Interactive REST docs](https://kdptop.com/api/v1/docs)
- [Integration guide](https://kdptop.com/docs/api): ChatGPT, Grok (xAI), Claude, Cursor setup

## REST endpoints

- GET /api/v1/categories/search?q=&store=books|kindle: fuzzy category search, English or Chinese
- GET /api/v1/categories/{node_id}: breadcrumb, latest metrics per list, sub-categories ranked by score
- GET /api/v1/lists/{node_id}/{best|new|free}?date=YYYY-MM-DD: ranked books with previous-day rank
- GET /api/v1/books/search?q=: books by ASIN, title or author
- GET /api/v1/books/{asin}?days=30: book metadata and daily rank history per list
- GET /api/v1/opportunities?store=&q=&leaf_only=&max_median_reviews=&min_median_price=&sort=: niche ranking
- GET /api/v1/breakouts?days=30: new releases that reached a Best Sellers list
- GET /api/v1/stats: coverage and freshness

## Notes

- Prices are USD from amazon.com. review_count is the Amazon rating count shown on list cards.
- opportunity_score: higher means lower review barrier, faster list turnover and more room for new releases.
- Data comes from public Amazon list pages; KDPTop is not affiliated with Amazon.