kabum.com.br APIkabum.com.br ↗
Access KaBuM! product listings, prices, specs, categories, and user reviews via API. Search Brazil's top electronics retailer with 6 endpoints.
curl -X GET 'https://api.parse.bot/scraper/5cc2492d-6abb-44cd-bf2d-b94a65173040/search_products?page=1&sort=most_searched&query=notebook&page_size=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on KaBuM!. Returns paginated results with product summaries including prices, availability, ratings, and seller info.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order. Accepted values: 'most_searched', 'price_asc', 'price_desc'. |
| queryrequired | string | Search keyword (e.g. 'notebook', 'RTX 4060'). |
| page_size | integer | Number of items per page. |
{
"type": "object",
"fields": {
"meta": "object with pagination info (cursor, number, size, is_current_page)",
"products": "array of product summaries with id, name, price, old_price, discount_percentage, available, manufacturer, url, image, rating_score, rating_count, is_marketplace, seller",
"total_items": "integer total number of matching products"
},
"sample": {
"data": {
"meta": {
"size": 5,
"cursor": "",
"number": 1,
"is_current_page": true
},
"products": [
{
"id": 955187,
"url": "https://www.kabum.com.br/produto/955187/notebook-lenovo-ideapad-slim-3",
"name": "Notebook Lenovo IdeaPad Slim 3, AMD Ryzen 7 7735HS, 16GB RAM",
"image": "https://images.kabum.com.br/produtos/fotos/955187/example_g.jpg",
"price": 5554.44,
"seller": "KaBuM!",
"available": true,
"old_price": 0,
"manufacturer": "Lenovo",
"rating_count": 110,
"rating_score": 5,
"is_marketplace": false,
"discount_percentage": 10
}
],
"total_items": 10000
},
"status": "success"
}
}About the kabum.com.br API
The KaBuM! API provides 6 endpoints for searching and browsing Brazil's largest electronics retailer, returning structured product data including BRL prices, discount percentages, technical specifications, and customer reviews. Starting with search_products, you can query by keyword and sort by price or popularity, then drill into any result with get_product_details to retrieve full specs, brand info, and payment-aware pricing objects.
Product Search and Catalog Browsing
The search_products endpoint accepts a query string (e.g. 'RTX 4060' or 'notebook') plus optional page, page_size, and sort parameters ('most_searched', 'price_asc', 'price_desc'). Results include an array of product summaries — each with id, name, price, old_price, discount_percentage, available, manufacturer, url, image, and rating_score — alongside a meta pagination object and total_items count. For browsing by department, get_departments_and_categories returns the full category tree with codigo, amigavel (slug), nome, and imagem fields. Pass the amigavel slug into get_category_products to page through any category's listings.
Deep Product Details
get_product_details requires both a numeric product_id and the URL slug, both available from search or category results. The response includes prices (an object with oldPrice, priceWithDiscount, price, discountPercentage), medias (an array of image objects at multiple resolutions), brands (with brand id, name, image, link), about (an HTML string summarizing key features), category breadcrumb, sellerName, and a rating object with score and count. This is the most data-dense endpoint in the API.
Reviews and Search Suggestions
get_product_reviews takes a product_id and returns paginated review objects — each with review_id, customer_name, score, review_date, review_title, description, total_likes, and any attached midia — plus aggregate average_score and total_reviews at the top level. get_search_suggestions accepts a query and returns a richer catalog payload: full product attributes, filter metadata, breadcrumb, SEO fields, promotion flags, and links for first/self/last/next pagination — useful when you need filter facets alongside results.
- Track BRL price changes and
discount_percentagefor specific products over time usingsearch_productsorget_product_details. - Build a price comparison tool for Brazilian electronics by querying multiple keywords and comparing
priceWithDiscountacross results. - Aggregate customer sentiment by collecting
score,description, andtotal_likesfromget_product_reviewsacross competing products. - Populate a product catalog with KaBuM! data by iterating
get_category_productsacross all slugs fromget_departments_and_categories. - Monitor stock availability using the
availablefield returned insearch_productsandget_category_productsfor specific SKUs. - Extract brand and manufacturer data (
brandsobject,manufacturerattribute) to analyze which vendors dominate specific categories. - Use
get_search_suggestionsfilter metadata to understand how KaBuM! facets a category — useful for replicating their taxonomy in a third-party app.
| 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 KaBuM! have an official public developer API?+
What does `get_product_details` return beyond the price?+
get_product_details returns the prices object (covering oldPrice, priceWithDiscount, price, and discountPercentage), a medias array with product images at multiple resolutions, the brands object with brand name and image, an about HTML string with key feature highlights, a category breadcrumb string, sellerName, and a rating object with score and count. Both product_id and slug are required inputs — you can get both from search_products results.Does the API cover seller ratings or storefront-level data beyond `sellerName`?+
sellerName within get_product_details but does not expose seller profiles, seller ratings, or full third-party seller listings separately. You can fork this API on Parse and revise it to add a seller-focused endpoint if your use case requires that data.How does pagination work across endpoints?+
search_products and get_category_products both accept page and page_size parameters and return a meta object with cursor, number, size, is_current_page, and a total_items integer. get_product_reviews uses page and limit and returns total_pages_count and total_items_count in its meta. get_search_suggestions returns links with first, self, last, and next URLs for cursor-style navigation.Does the API return product specs like RAM, storage, or CPU for electronics?+
about field of get_product_details as an HTML string — they are not broken out into structured key-value spec fields. If you need parsed spec attributes (e.g. RAM, storage, GPU model as discrete fields), the current response shape does not provide them. You can fork this API on Parse and revise it to add structured spec parsing for the product detail endpoint.