Amazon APIamazon.com.br ↗
Search products, fetch details, retrieve bestsellers, deals, and price analytics from Amazon Brazil (amazon.com.br) via a structured REST API.
What is the Amazon API?
This API exposes 6 endpoints for querying Amazon Brazil (amazon.com.br), returning product data including prices in BRL, Prime eligibility, ratings, and review counts. The search_products endpoint accepts keyword queries with optional category node filtering and four sort modes. Complementary endpoints cover product details by ASIN, bestseller rankings by category, live deals with discount percentages, and aggregate price statistics across a search result page.
curl -X GET 'https://api.parse.bot/scraper/1e3016b1-c517-4412-a8fb-e27f98358908/search_products?page=1&sort=relevanceblender&query=fone+bluetooth' \ -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 amazon-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.
"""Amazon Brazil product search, details, and price analysis."""
from parse_apis.amazon_brazil_product_api import AmazonBrazil, Sort, Category, ProductNotFound
client = AmazonBrazil()
# Search for bluetooth earphones sorted by price, capped at 5 items.
for product in client.products.search(query="fone bluetooth", sort=Sort.PRICE_LOW_TO_HIGH, limit=5):
print(product.name, product.price, product.rating)
# Drill into one product's review summary.
product = client.products.search(query="notebook", limit=1).first()
if product:
review = product.reviews.get()
print(review.product_name, review.rating, review.review_count)
# Browse bestsellers in electronics.
for item in client.products.bestsellers(category=Category.ELECTRONICS, limit=3):
print(item.name, item.price)
# Fetch a known product by ASIN with typed-error handling.
try:
detail = client.products.get(asin="B0DVMQVVDY")
print(detail.name, detail.price, detail.prime)
except ProductNotFound as exc:
print(f"Product not found: {exc.asin}")
# Analyze pricing for a query.
stats = client.products.price_stats(query="smartphone")
print(stats.average_price, stats.min_price, stats.max_price, stats.total_products)
print("exercised: products.search / products.bestsellers / products.get / products.price_stats / product.reviews.get")
Full-text search over Amazon Brazil products. Returns up to ~48 results per page with pricing, ratings, and Prime eligibility. Pagination via integer page counter; some products may have null prices when Amazon hides pricing behind a click-through. Sort controls result ordering; node_id restricts to a category subtree.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order for results. |
| queryrequired | string | Search keyword (e.g. 'notebook', 'fone bluetooth'). |
| node_id | string | Category node ID to filter results (e.g. '16209062011' for electronics). |
{
"type": "object",
"fields": {
"items": "array of product objects with asin, name, url, price, original_price, rating, review_count, prime"
},
"sample": {
"data": {
"items": [
{
"url": "https://www.amazon.com.br/dp/B0DVMQVVDY",
"asin": "B0DVMQVVDY",
"name": "PHILIPS Fone de Ouvido Sem Fio TWS, TAT1109BK/00, Bluetooth",
"price": 128.04,
"prime": false,
"rating": 4.6,
"review_count": 68,
"original_price": 144
}
]
},
"status": "success"
}
}About the Amazon API
Product Search and Details
The search_products endpoint accepts a required query string (e.g. 'notebook' or 'fone bluetooth') and optional parameters including page for pagination, sort for ordering (relevanceblender, price-asc-rank, price-desc-rank, review-rank), and node_id to filter by a specific Amazon Brazil category tree. Each item in the response carries asin, name, url, price, original_price, rating, review_count, and a prime boolean. The get_product_details endpoint targets a single asin and returns the same field set with prices denominated in BRL.
Bestsellers, Deals, and Price Analytics
The get_bestsellers endpoint accepts a category string (e.g. electronics, books, games, or their Portuguese equivalents) and returns a ranked list where each item includes a rank field alongside the standard product fields. The get_deals endpoint requires no inputs and returns current promotions from Amazon Brazil; where both price and original_price are present, the response also includes a discount_percent field. The calculate_category_average_price endpoint takes a query string and analyzes the first page of matching results, returning average_price, min_price, max_price, and total_products — all prices in BRL.
Review Data
The get_product_reviews endpoint accepts an asin and returns rating, review_count, and product_name. Individual review text, reviewer names, and per-review metadata are not available — the reviews array in the response is always empty. This endpoint is useful for tracking aggregate sentiment signals (star rating and volume) without needing individual review content.
The Amazon API is a managed, monitored endpoint for amazon.com.br — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when amazon.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 amazon.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?+
- Monitor BRL price fluctuations on specific ASINs for currency-adjusted international pricing research
- Build a bestseller tracker across Amazon Brazil categories using
get_bestsellersrank fields - Aggregate daily deal data with
discount_percentfor a deals newsletter or price alert service - Compare average category prices across multiple queries using
calculate_category_average_pricefor market positioning - Filter Prime-eligible products within a keyword search to surface fast-shipping inventory for Brazilian customers
- Track rating and review count trends over time for a product ASIN using
get_product_reviews - Scope a product catalog for a specific Amazon Brazil category node using the
node_idparameter insearch_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 | 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 Amazon Brazil have an official developer API?+
What does `get_product_reviews` actually return?+
rating (average stars out of 5), review_count (total number of reviews), and product_name. The reviews array is always empty — individual review text, reviewer identities, and per-review ratings are not included in the response.Are seller information or third-party listings available?+
How fresh is the deals data returned by `get_deals`?+
get_deals endpoint reflects current promotions at the time of the API call. Amazon Brazil's deals inventory changes throughout the day (Lightning Deals have fixed windows), so repeated calls at different times may return different items and discount percentages. There is no historical deals archive in this API.