bookwalker.jp APIbookwalker.jp ↗
Access BookWalker Japan's ebook catalog via API. Search manga and light novels, get book details, browse rankings, and fetch autocomplete suggestions.
curl -X GET 'https://api.parse.bot/scraper/7391038e-a864-4d2a-9539-7962430edce2/search_books?page=1&query=%E3%83%8A%E3%83%AB%E3%83%88' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for books by keyword with optional filters and pagination. Returns a list of book results with title, author, price, and links.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| order | string | Sort order for results (e.g. 'new', 'popular'). |
| queryrequired | string | Search keyword (Japanese or English). |
| category | string | Category filter code passed as 'ct' parameter to the site search. |
{
"type": "object",
"fields": {
"books": "array of book objects with title, uuid, series_id, author, label, price, image_url, url",
"total_pages": "integer, total number of available pages",
"current_page": "integer, the requested page number"
},
"sample": {
"data": {
"books": [
{
"url": "https://bookwalker.jp/series/16740/list/",
"uuid": "80d6b8bf-3eae-416b-9a0b-33a5aff632d1",
"label": "ジャンプコミックスDIGITAL",
"price": "0 ~ 100",
"title": "双星の陰陽師（ジャンプコミックスDIGITAL）",
"author": "",
"image_url": "https://rimg.bookwalker.jp/689858/eUnObgIVNjRTJtVUNQrbaQ__.jpg",
"series_id": "16740"
}
],
"total_pages": 1,
"current_page": 1
},
"status": "success"
}
}About the bookwalker.jp API
The BookWalker.jp API exposes 5 endpoints covering Japan's largest ebook store, giving developers structured access to book metadata, search results, and category rankings. The get_book_details endpoint returns 10 fields per book including UUID, price in JPY, average rating, series linkage, and author URLs. Companion endpoints handle keyword search with pagination, daily/weekly/monthly rankings by category, autocomplete suggestions, and category landing page sections.
Search and Book Metadata
The search_books endpoint accepts a required query parameter (Japanese or English text) alongside optional filters: category (a category code such as ct2 for manga), order (e.g. new or popular), and page for pagination. Results return an array of book objects each containing title, uuid, author, label, price, image_url, and a canonical url, plus total_pages and current_page for cursor management.
The get_book_details endpoint takes a single uuid and returns the full record for that title: title, authors (array of objects with name and url), price, currency (typically JPY), rating, category, label, series (object with name and url, or null), and the canonical url. This is the primary endpoint for building book pages or enriching catalog data.
Rankings and Discovery
get_rankings returns a ranked list of books filtered by period (daily, weekly, or monthly) and category (total for overall, or codes like ct2 for manga and ct3 for light novels). Each ranked entry includes rank, title, uuid, author, price, image_url, rating, and url — enough to render a full rankings widget without a second request.
autocomplete accepts a term string and returns suggestion objects with label, value, type, typeId, categoryId, and a subscription flag — matching the behavior of BookWalker's live search suggestions. get_category_books takes a category_id slug (e.g. manga, new) and returns the sections displayed on that category landing page, each section carrying a section_title and an array of book objects with the same fields as search_books.
- Track daily and weekly manga sales rankings to identify trending titles for a recommendation engine.
- Build a BookWalker price monitor by polling
get_book_detailsforpriceandcurrencychanges on a watchlist of UUIDs. - Populate a series tracker by extracting the
seriesobject fromget_book_detailsacross a set of followed titles. - Implement Japanese ebook autocomplete in a reading app using the
autocompleteendpoint'slabelandcategoryIdfields. - Aggregate category landing page content via
get_category_booksto surface curated sections in a third-party storefront. - Compare author output by collecting
authorsarrays fromsearch_booksresults filtered by category code. - Seed a light-novel database by iterating
get_rankingswithct3over weekly and monthly periods.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does BookWalker have an official developer API?+
What does `get_rankings` return and how do I filter by category?+
rankings array where each entry has rank, title, uuid, author, price, image_url, rating, and url. Pass period as daily, weekly, or monthly, and category as total for overall rankings or a code like ct2 (manga) or ct3 (light novel) to narrow results.Does the API return book reviews or individual user review text?+
get_book_details exposes an aggregate rating value (number or null) but does not include review counts, review bodies, or reviewer profiles. You can fork this API on Parse and revise it to add an endpoint that fetches per-book review listings if that data is accessible on the book page.Is BookWalker Global (English storefront) covered by this API?+
Are there pagination limits on `search_books`?+
total_pages alongside current_page, so you can iterate pages programmatically. However, BookWalker's site caps how deep pagination can go for any given query, and requesting a page beyond the available range will return an empty books array rather than an error.