natura.com.br APInatura.com.br ↗
Access Natura Brasil's product catalog, keyword search, category navigation, pricing, and customer reviews via 5 structured JSON endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/0299d14a-6d4a-4bee-9db9-3e4af231d6cd/list_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the full category navigation hierarchy including main menu categories, subcategories, product counts, footer links, and top navigation elements.
No input parameters required.
{
"type": "object",
"fields": {
"mainMenu": "array of category objects, each containing a categories object with displayName, categoryID, totalProducts, and nested subCategories",
"mainMenuTopWhite": "object with column1 and column2 arrays containing top navigation links"
},
"sample": {
"data": {
"mainMenu": [
{
"categories": {
"categoryID": "promocoes",
"displayName": "promoções",
"subCategories": [],
"totalProducts": 1447
}
}
],
"mainMenuTopWhite": {
"column1": [
{
"contentID": "a-natura",
"displayName": "Natura",
"subCategories": []
}
],
"column2": [
{
"contentID": "login",
"displayName": "Entre"
}
]
}
},
"status": "success"
}
}About the natura.com.br API
The Natura Brasil API exposes 5 endpoints covering the full e-commerce catalog at natura.com.br, including product search, detail retrieval, and customer reviews. Using search_products you can query by keyword or category ID and receive paginated results with pricing, ratings, and faceted refinements. get_product_details returns fields like longDescription, familiaOlfativa (fragrance family), usage, and tiered pricing. All responses are structured JSON.
Product Search and Catalog Browsing
search_products accepts a free-text query (e.g. 'perfume', 'desodorante') or a category_id such as 'perfumaria' or 'promocoes', along with sort, count, and start parameters for pagination and ordering. Responses include a total count, a products array with fields like productId, name, price, rating, images, brand, and availability, plus refinements and sortOptions for building faceted UIs. To enumerate valid category IDs before searching, call list_categories first — it returns a mainMenu hierarchy with categoryID, displayName, totalProducts, and nested subcategories.
Product Detail and Fragrance Data
get_product_details takes a product_id obtained from search results and returns a full product record. Unique fields include familiaOlfativa (fragrance family classification), gender, and longDescription. Pricing is broken into sales, list, and discountAmount sub-objects, making it straightforward to detect promotional markdowns. The images field provides a medium array of image URLs.
Reviews and Sentiment
get_product_reviews returns paginated reviews with individual rating, comment, customerName, createdAt, and optional pictures per review. Aggregate fields include aggregatedRating, reviewsCount, recommendedPercentage, and a composition array showing the distribution of ratings by star level. An aiSummary object provides a text summary and per-topic sentiment analysis derived from the review corpus.
Category Filters and Faceted Navigation
get_category_filters accepts either a query or category_id and returns the refinements array (each with attributeId, label, and values) alongside sortOptions. This is useful for pre-populating filter UI before executing a full search_products call.
- Build a fragrance finder that filters by
familiaOlfativaand price range usingsearch_productsrefinements. - Track promotional pricing by comparing
salesandlistsub-objects fromget_product_detailsover time. - Aggregate customer sentiment by parsing
aiSummarytopics andrecommendedPercentagefromget_product_reviews. - Populate a category navigation menu using the
mainMenuhierarchy andtotalProductscounts fromlist_categories. - Monitor rating trends for specific products by polling
aggregatedRatingandreviewsCountviaget_product_reviews. - Generate faceted search UI options before executing a query by calling
get_category_filterswith acategory_id. - Compare brand availability and product counts across subcategories using the nested category structure in
list_categories.
| 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 Natura Brasil have an official developer API?+
What does `get_product_details` return that `search_products` does not?+
search_products returns summary fields useful for listing views: productId, name, price, rating, images, brand, and availability. get_product_details adds longDescription, usage instructions, gender, familiaOlfativa (fragrance family), and the full tiered pricing object with sales, list, and discountAmount sub-objects.Does the API expose product ingredients or full INCI lists?+
longDescription, usage instructions, and fragrance classification via familiaOlfativa, but does not expose a structured ingredients or INCI field. You can fork the API on Parse and revise it to add an endpoint targeting that data.How does pagination work in `search_products` and `get_product_reviews`?+
search_products uses start (0-based offset) and count (results per page) parameters. get_product_reviews uses page (0-based) and page_size. Both endpoints return a total count field (total or reviewsCount) so you can calculate the number of pages needed.