netshoes.com APInetshoes.com ↗
Access Netshoes.com.br product listings, details, reviews, and delivery estimates via API. Search by keyword or browse by category path.
curl -X GET 'https://api.parse.bot/scraper/5dc525c9-09fc-479f-b88d-3e7e25d78043/search_products?page=1&query=tenis' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword on Netshoes. Returns paginated product listings. Note: single brand-name queries (e.g. 'nike') may be redirected by the site to a brand landing page and return upstream_error; use more specific queries (e.g. 'nike tenis') for reliable results.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| queryrequired | string | Search keyword (e.g. 'tenis', 'adidas running') |
{
"type": "object",
"fields": {
"items": "array of product summaries with id, name, url, brand, price, oldPrice, discount, rating, reviewCount, image, isAvailable, department, productType, sizes",
"total": "integer total number of matching products",
"totalPages": "integer total number of pages",
"currentPage": "integer current page number"
},
"sample": {
"data": {
"items": [
{
"id": "FBA-0905-006",
"url": "https://www.netshoes.com.br/p/tenis-adidas-ultimashow-20-masculino-FBA-0905-006",
"name": "Tênis Adidas Ultimashow 2.0 Masculino",
"brand": "Adidas",
"image": "https://static.netshoes.com.br/produtos/tenis-adidas-ultimashow-20-masculino/06/FBA-0905-006/FBA-0905-006_zoom1.jpg",
"price": 349.99,
"sizes": [
"37",
"42",
"41",
"38",
"39",
"40"
],
"rating": 4.71,
"discount": null,
"oldPrice": 349.99,
"department": "Running",
"isAvailable": true,
"productType": "Tênis",
"reviewCount": 1532
}
],
"total": 7744,
"totalPages": 81,
"currentPage": 1
},
"status": "success"
}
}About the netshoes.com API
The Netshoes API gives developers structured access to Netshoes.com.br product data across 5 endpoints, covering search, category browsing, full product details, customer reviews, and ZIP code address lookups. The get_product_details endpoint alone returns over 10 fields per SKU including price in BRL, size variants, color variants, and zoom-quality images — enough to build a product feed or price tracker without manual browsing.
Search and Category Browsing
The search_products endpoint accepts a query string and an optional page integer, returning paginated arrays of product summaries. Each item includes id, name, brand, price, oldPrice, discount, rating, reviewCount, image, isAvailable, and department. One practical note: single-word brand queries like nike may trigger a brand landing redirect on the site and return an upstream error; more specific queries like nike tenis return reliable paginated results. The get_product_listings_by_category endpoint takes a path parameter (e.g. /tenis/masculino) and returns the same product summary shape plus a filters array listing available refinements for that category.
Product Details and Variants
get_product_details takes a slug parameter — the product SKU code in ABC-1234-567 format — and returns the full record for that item. Response fields include sizes (each with size, sku, available, price), colors (each with color, slug, sku, available, image), a images array of zoom-resolution URLs, oldPrice, available, and department. Prices are denominated in BRL.
Reviews and Ratings
get_product_reviews retrieves customer review data for a given SKU. Reviews are aggregated across color variants of the same product line. The response includes a rating object with stars and average, the full reviews array (each entry carrying reviewId, rating, comments, name, userRecommends, photos, and createdAt), a histogram array with per-star vote counts and percentages, a surveys array of attribute-level ratings, summaryAI (an AI-generated review summary), numberOfReviews, and percentRecommended.
Delivery and Address Lookup
check_delivery_estimate accepts a sku and an 8-digit Brazilian zipcode (CEP). It returns an address object with postalCode, street, neighborhood, city, state, and ibgeCode. A note field in the response provides context about the scope of the estimate. This endpoint is useful for validating Brazilian addresses or geo-qualifying users in checkout workflows.
- Build a Netshoes price tracker that monitors
priceandoldPricechanges across SKUs over time. - Aggregate review sentiment using
summaryAI,percentRecommended, andhistogramdata fromget_product_reviews. - Populate a product comparison tool with size and color variant availability from
get_product_details. - Index category pages via
get_product_listings_by_categorywith iteratingpathandpageparameters to build a catalog. - Validate or geocode Brazilian shipping addresses using CEP lookups in
check_delivery_estimate. - Monitor discount depth by comparing
pricevsoldPricefrom search results across sporting goods categories. - Feed an affiliate site with product images, ratings, and URLs returned by
search_products.
| 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 Netshoes offer an official public developer API?+
Why do some keyword searches return an upstream error?+
nike can cause the site to redirect to a brand landing page rather than a standard search results page, which results in an upstream error from the API. Using more specific queries — for example nike tenis or adidas running — bypasses this behavior and returns the expected paginated product listing.What does `get_product_reviews` return beyond the review text?+
reviews array (which includes rating, comments, userRecommends, photos, and createdAt per review), the endpoint returns a histogram of star distribution, surveys with attribute-level ratings, percentRecommended, numberOfReviews, and a summaryAI string containing an AI-generated synthesis of the review set.Does the API support filtering search results by size, color, or price range?+
search_products are returned without filter parameters; the endpoint supports only query and page. The get_product_listings_by_category endpoint returns a filters array showing available filter options for a category, but applying those filters as query parameters is not currently supported. You can fork this API on Parse and revise it to add filter-parameter support to the category endpoint.