rokomari.com APIrokomari.com ↗
Access Rokomari.com book data via API: search titles, get book details, browse categories, fetch quick deals, and retrieve bestseller award winners.
curl -X GET 'https://api.parse.bot/scraper/4bcf1cd4-c566-4d3a-a1f0-dc54e658ea15/search_books?page=1&query=python' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for books by keyword with pagination. Returns a list of books with title, author, prices, and URLs. Results are paginated server-side with 60 items per page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| queryrequired | string | Search keyword (supports English and Bengali text) |
{
"type": "object",
"fields": {
"page": "integer - current page number",
"items": "array of book objects with id, slug, title, author, offer_price, regular_price, url",
"query": "string - the search query used",
"total_results": "integer - total number of matching results"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"id": "127980",
"url": "https://www.rokomari.com/book/127980/shohoz-vashay-python-3",
"slug": "shohoz-vashay-python-3",
"title": "সহজ ভাষায় পাইথন ৩",
"author": "মাকসুদুর রহমান মাটিন",
"offer_price": "654",
"regular_price": "760"
}
],
"query": "python",
"total_results": 136
},
"status": "success"
}
}About the rokomari.com API
The Rokomari.com API provides 6 endpoints for querying Bangladesh's largest online bookstore, covering book search, detailed metadata, category browsing, quick deals, and bestseller award winners. The search_books endpoint returns up to 60 results per page with title, author, offer price, regular price, and a slug you can pass directly into get_book_details for full specifications, ratings, and a text summary.
Search and Book Detail
The search_books endpoint accepts a query string (English or Bengali) and an optional page integer, returning paginated results of 60 items per page. Each item in the items array carries an id, slug, title, author, offer_price, regular_price, and a direct url. Pass any id and slug pair to get_book_details to retrieve the full record: a specifications object with key-value pairs covering Publisher, ISBN, Edition, Pages, and more; a summary text block; a rating object with average and total fields; and both price fields alongside a discount string.
Categories and Browse
The list_categories endpoint returns all available categories, each with an id, slug, name, and url. Use the category_id (required) and optionally the slug with get_books_by_category to page through titles in that category. The response mirrors the search shape — id, slug, title, author, offer_price, regular_price, and url — alongside the category_id and current page.
Deals and Awards
The get_quick_deals endpoint returns the active promotions on Rokomari, including price, mrp, discount_percentage, deal_price, deal_quantity, and sold_quantity for each deal item, plus an image URL and a link to the full deals page. The get_bestseller_award_page endpoint returns the page title and a winners array where each entry includes the author name, author_id, author_slug, and a profile url — useful for building curated author lists or award tracking features.
- Build a Bengali-language book discovery app using
search_bookswith native Bengali query strings. - Track price differences between
offer_priceandregular_priceacross categories to surface the deepest discounts. - Aggregate book
specificationsfields (ISBN, Publisher, Pages) into a structured library catalog. - Monitor
get_quick_dealson a schedule to alert users when new time-limited promotions appear. - Compile a bestseller author directory from
get_bestseller_award_pagewinners with links to their profiles. - Build a category-level reading list browser using
list_categoriesandget_books_by_categorywith pagination. - Enrich a book recommendation engine with
rating.averageandrating.totalfields fromget_book_details.
| 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 Rokomari.com have an official public developer API?+
What does `get_book_details` return beyond what `search_books` includes?+
get_book_details endpoint adds a specifications object (Publisher, ISBN, Edition, Pages, and similar fields), a summary text description, and a rating object with average score and total count — none of which appear in the search_books response. Both endpoints share offer_price, regular_price, title, author, id, and slug.Does `search_books` return all results at once?+
total_results integer so you can calculate how many pages to request. Use the page parameter to walk through subsequent pages.Does the API expose customer reviews or individual user review text?+
rating.average and rating.total) from get_book_details, but individual review text, reviewer names, and review dates are not included in any endpoint response. You can fork this API on Parse and revise it to add an endpoint that retrieves individual review content.Can I look up an author's full profile or bibliography directly?+
get_bestseller_award_page endpoint returns award-winning author names, IDs, slugs, and profile URLs, but there is no dedicated author-profile or author-bibliography endpoint. You can fork this API on Parse and revise it to add an author detail endpoint using those slugs.