Amazon APIamazon.it ↗
Access Amazon.it product search, details, categories, and best-seller rankings via a structured API. Returns prices, ratings, ASINs, specs, and images.
What is the Amazon API?
The Amazon Italy API covers 5 endpoints for querying product data from amazon.it, returning fields like ASIN, price in EUR, rating, bullet points, and image URLs. The get_product_details endpoint delivers brand, specs, description, and median price for any ASIN. get_best_sellers ranks top products by department. get_categories exposes the full category hierarchy with slugs you can pass directly into other endpoints.
curl -X GET 'https://api.parse.bot/scraper/18564612-8aa3-47b4-a88b-4bc5ba70f945/search_products?sort=price-asc-rank&query=laptop' \ -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-it-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.
"""Walkthrough: Amazon Italy SDK — search products, get details, browse categories and best sellers."""
from parse_apis.amazon_italy_scraper_api import AmazonItaly, Sort, ProductNotFound
client = AmazonItaly()
# Search for products sorted by price ascending
for product in client.productsummaries.search(query="cuffie bluetooth", sort=Sort.PRICE_ASC, limit=5):
print(product.title, product.price, product.prime)
# Get full details for a single product by ASIN
try:
detail = client.products.get(asin="B0DSGDJLG4")
print(detail.title, detail.brand, detail.price, detail.rating)
except ProductNotFound as exc:
print(f"Product not found: {exc.asin}")
# Browse categories and list best sellers for the first one
category = client.categories.list(limit=1).first()
if category:
print(category.name, category.slug)
for item in category.best_sellers.list(limit=3):
print(item.rank, item.title, item.price, item.rating)
# Search by price (pre-sorted ascending) for cheapest options
cheapest = client.productsummaries.search_by_price(query="smartphone", limit=3).first()
if cheapest:
print(cheapest.title, cheapest.price, cheapest.asin)
print("exercised: productsummaries.search / products.get / categories.list / best_sellers.list / productsummaries.search_by_price")
Full-text search over Amazon Italy product listings. Returns products matching the keyword with title, price, rating, and ASIN. Optionally sort by price ascending. Results are from the first page of search (up to ~48 products). Sponsored listings are excluded.
| Param | Type | Description |
|---|---|---|
| sort | string | Sort order for results. |
| queryrequired | string | Search keyword (e.g. 'laptop', 'cuffie bluetooth'). |
{
"type": "object",
"fields": {
"products": "array of product objects with asin, title, product_url, price, original_price, rating, ratings_count, prime, image_url"
},
"sample": {
"data": {
"products": [
{
"asin": "B0CF1NDW5W",
"price": 212.03,
"prime": true,
"title": "HP Laptop 2023, Touch Screen da 15.6\"",
"rating": 4.5,
"image_url": "https://m.media-amazon.com/images/I/71mqBFsVQ-L._AC_UL320_.jpg",
"product_url": "https://www.amazon.it/dp/B0CF1NDW5W",
"ratings_count": 120,
"original_price": null
}
]
},
"status": "success"
}
}About the Amazon API
Search and Product Lookup
search_products accepts a query string (e.g. 'cuffie bluetooth') and an optional sort parameter ('price-asc-rank') to order results by ascending price. Each result in the products array includes asin, title, product_url, price, original_price, rating, ratings_count, a prime boolean, and image_url. get_search_results_csv mirrors this field set but always sorts by price ascending, making it convenient for tabular workflows.
Product Details
get_product_details takes a 10-character asin and returns a detailed record: brand, current price (EUR), median_price, rating, a bullets array of feature points, a specs object of key-value specification pairs, a description string, and an image_urls array. Fields such as price and rating are nullable when the product listing does not carry that data.
Categories and Best Sellers
get_categories requires no input and returns an array of top-level department objects, each with name, slug, and url. Those slugs feed directly into get_best_sellers via the department parameter (e.g. 'electronics', 'books', 'pc'). Omitting department returns the site-wide best-seller list. Each entry in best_sellers includes rank, asin, title, price, and rating, with up to 30 products per call.
The Amazon API is a managed, monitored endpoint for amazon.it — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when amazon.it 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.it 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 price changes on amazon.it by polling
get_product_detailsfor a set of ASINs and comparingpriceover time. - Build a department-level trend report using
get_best_sellerswith slugs fromget_categoriesto surface top-ranked products. - Compare
pricevsoriginal_priceacrosssearch_productsresults to identify discounted listings. - Populate a product catalog with Italian-market titles, specs, images, and bullet points from
get_product_details. - Export price-sorted product tables using
get_search_results_csvfor spreadsheet-based analysis. - Monitor category structure changes by periodically calling
get_categoriesto detect new or removed department slugs. - Cross-reference
ratings_countandratingfrom search results to rank products by review volume for a given keyword.
| 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 Italy have an official developer API?+
What does `get_product_details` return that `search_products` does not?+
get_product_details includes brand, bullets (feature bullet points), specs (a key-value object of technical specifications), description, median_price, and multiple image_urls. The search endpoint returns only a single image_url and omits those fields entirely.Does the API return seller information or third-party offers?+
prime flag, or multiple offer prices for a single ASIN. You can fork this API on Parse and revise it to add a seller-offers endpoint.Are customer reviews or review text included in any endpoint?+
rating (out of 5) and ratings_count only. You can fork this API on Parse and revise it to add a reviews endpoint that returns individual review content.How many best-seller products does `get_best_sellers` return per department?+
rank, asin, title, price, and rating. Pagination is not supported, so the response is capped at that count per request.