Kabum APIkabum.com.br ↗
Access KaBuM! product listings, prices, specs, categories, and user reviews via API. Search Brazil's top electronics retailer with 6 endpoints.
What is the Kabum 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.
curl -X GET 'https://api.parse.bot/scraper/5cc2492d-6abb-44cd-bf2d-b94a65173040/search_products?page=1&sort=most_searched&query=notebook&page_size=20' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace kabum-com-br-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.kabum__api import Kabum, Sort, Product, Category, ProductDetail, Review, CatalogProduct
# Initialize the client
kabum = Kabum()
# Search for products using the Sort enum
for product in kabum.products.search(query="notebook", sort=Sort.PRICE_ASC, limit=5):
print(product.name, product.price, product.available, product.seller)
# Navigate from product summary to full details
detail = product.details()
print(detail.title, detail.category, detail.seller_name)
print(detail.prices.price_with_discount, detail.prices.discount_percentage)
print(detail.rating.score, detail.rating.count)
print(detail.brands.name)
# Walk sub-resource: reviews
for review in product.reviews.list(limit=3):
print(review.customer_name, review.score, review.review_title)
# List all categories
for cat in kabum.categories.list(limit=5):
print(cat.nome, cat.amigavel, cat.count_filhos)
# Browse products in a category
for p in cat.products(limit=3):
print(p.name, p.price, p.discount_percentage)
# Search the full catalog with metadata
for result in kabum.catalogproducts.search(query="RTX 4060", limit=3):
print(result.id, result.type)
print(result.attributes.title, result.attributes.price, result.attributes.available)
Full-text search over KaBuM!'s product catalog by keyword. Returns paginated product summaries including prices, availability, ratings, and seller info. Paginates via page number. Each product carries an id and slug usable for get_product_details.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order for results. |
| 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": 1037468,
"url": "https://www.kabum.com.br/produto/1037468/notebook-lenovo-ideapad-slim-3-amd-ryzen-5-7535hs-8gb-amd-radeon-graphics-ssd-512gb-15-3-wuxga-1920x1200-linux-83mms00300",
"name": "Notebook Lenovo IdeaPad Slim 3 AMD Ryzen 5 7535HS, 8GB, AMD Radeon Graphics, SSD 512GB, 15.3\" WUXGA 1920x1200, Linux - 83MMS00300",
"image": "https://images.kabum.com.br/produtos/fotos/1037468/notebook-lenovo-ideapad-slim-3-amd-ryzen-5-7535hs-8gb-amd-radeon-graphics-ssd-512gb-15-3-wuxga-1920x1200-linux-83mms00300_1780426518_g.jpg",
"price": 4940.98,
"seller": "KaBuM!",
"available": true,
"old_price": 0,
"manufacturer": "Lenovo",
"rating_count": 0,
"rating_score": 0,
"is_marketplace": false,
"discount_percentage": 0
}
],
"total_items": 10000
},
"status": "success"
}
}About the Kabum API
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.
The Kabum API is a managed, monitored endpoint for kabum.com.br — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when kabum.com.br changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official kabum.com.br API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.