Amazon APIamazon.se ↗
Search Amazon.se products by keyword, get details by ASIN, fetch autocomplete suggestions, and browse Renewed listings — all in structured JSON.
What is the Amazon API?
The Amazon.se API provides 4 endpoints covering product search, detail lookup, autocomplete, and Renewed-category listings from Amazon Sweden. The search_products endpoint returns up to 48 products per page with ASIN, price in SEK, rating, review count, deal badges, and image URLs. The get_product_details endpoint adds brand, feature bullet points, product overview tables, variant data, high-resolution images, and availability status by ASIN.
curl -X GET 'https://api.parse.bot/scraper/0b36f0a8-b85e-41f6-983a-cc0ba2be41f3/search_products?page=1&limit=5&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-se-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.se Renewed & Product Search — search, details, and autocomplete."""
from parse_apis.Amazon_se_Product_Search_API import AmazonSe, SortBy, ProductNotFound
client = AmazonSe()
# Search renewed listings sorted by price, capped at 3 results.
for item in client.renewed_products.search(query="iphone", sort_by=SortBy.PRICE_ASC, limit=3):
print(item.title, item.renewed_price, item.currency, item.is_prime)
# Drill into full product details from a renewed search result.
hit = client.renewed_products.search(query="laptop", limit=1).first()
if hit:
detail = hit.details()
print(detail.title, detail.price, detail.brand)
if detail.renewed:
print(detail.renewed.condition_tier)
for tier in detail.renewed.condition_tiers:
print(tier.tier, tier.price)
# Direct product lookup by ASIN with typed error handling.
try:
product = client.products.get(asin="B0CVJS2V8B")
print(product.title, product.price, product.availability)
except ProductNotFound as exc:
print(f"Product not found: {exc.asin}")
# Autocomplete suggestions for a prefix.
for suggestion in client.suggestions.search(query="laptop", limit=5):
print(suggestion.value, suggestion.type)
print("exercised: renewed_products.search / details / products.get / suggestions.search")
Full-text search over Amazon.se product listings. Returns up to 48 products per page with pagination support. Each product includes ASIN, title, price, rating, review count, image, and deal badges. Pagination fetches additional pages server-side; limit caps total items returned across all pages.
| Param | Type | Description |
|---|---|---|
| page | integer | Starting page number (48 items per page) |
| limit | integer | Maximum number of results to return. Will fetch multiple pages as needed. |
| queryrequired | string | Search keyword (e.g. 'laptop', 'headphones') |
{
"type": "object",
"fields": {
"page": "integer - starting page number",
"query": "string - the search query",
"products": "array of product objects with asin, title, price, currency, original_price, rating, reviews_count, image_url, product_url, badge, is_prime, is_sponsored",
"pages_fetched": "integer - number of pages actually fetched",
"results_count": "integer - actual number of results returned",
"total_results": "integer or null - estimated total results from Amazon"
},
"sample": {
"data": {
"page": 1,
"query": "laptop",
"products": [
{
"asin": "B09ZY5LM3C",
"badge": null,
"price": 2715.48,
"title": "Lenovo ThinkPad T470s UltraBook 14 Inch Laptop",
"rating": 3.9,
"currency": "SEK",
"is_prime": false,
"image_url": "https://m.media-amazon.com/images/I/61M6IHFOXQL._AC_UL320_.jpg",
"product_url": "https://www.amazon.se/dp/B09ZY5LM3C",
"is_sponsored": false,
"reviews_count": 489,
"original_price": null
}
],
"pages_fetched": 1,
"results_count": 5,
"total_results": 100000
},
"status": "success"
}
}About the Amazon API
Product Search and Pagination
The search_products endpoint accepts a required query string and optional page and limit parameters. Each product object in the products array includes asin, title, price, currency (SEK), original_price, rating, reviews_count, image_url, product_url, and a badge field that surfaces deal labels like "Amazon's Choice" or "Best Seller". The total_results field gives Amazon's estimated total match count, while pages_fetched and results_count reflect what was actually retrieved in the response.
Product Details by ASIN
The get_product_details endpoint takes an asin string and returns a full detail record including brand, features (an array of bullet-point strings), overview (a key-value object drawn from the product specification table), images (an array of high-resolution image URLs), and renewed — an object containing condition_tier and a condition_tiers array with per-tier pricing, populated only when the product is a Renewed listing. availability status and rating out of 5 are also included.
Renewed Listings and Autocomplete
The search_renewed endpoint restricts results to Amazon.se Renewed (refurbished) products. Each result carries renewed_price, rrp_price (the crossed-out new price when present), is_prime, and reviews_count. An optional sort_by parameter controls ordering. The get_suggestions endpoint accepts a query prefix and returns an array of suggestion objects, each with a value (the suggested keyword) and a type field (typically KEYWORD), matching what appears in Amazon's search bar dropdown.
The Amazon API is a managed, monitored endpoint for amazon.se — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when amazon.se 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.se 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 SEK price changes on specific ASINs for Swedish e-commerce price monitoring
- Compare Renewed vs. new prices using
renewed_priceandrrp_pricefromsearch_renewed - Build a product catalog seeder by bulk-searching keywords and collecting ASIN, title, and image data
- Power a search autocomplete feature using
get_suggestionswith a query prefix - Extract feature bullet points and product overview tables for structured product content
- Identify deal-tagged products by filtering the
badgefield insearch_productsresults - Check Prime eligibility on refurbished goods using the
is_primefield insearch_renewed
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Amazon have an official developer API for product data?+
What does `get_product_details` return for Renewed products versus new ones?+
renewed field is populated with a condition_tier string (e.g., "Excellent") and a condition_tiers array showing each tier alongside its price. For standard new products, renewed is null. Both product types return the same core fields: brand, features, overview, images, rating, and availability.Does the API return seller information or third-party marketplace seller details?+
Are customer review texts included in any endpoint?+
rating (numeric average out of 5) and reviews_count across endpoints, but does not return individual review texts, reviewer names, or review dates. You can fork this API on Parse and revise it to add a review-listing endpoint for full review content.How does pagination work in `search_products`?+
page parameter sets the starting page number, and limit controls the maximum total items returned — the endpoint will fetch additional pages automatically to satisfy the limit. pages_fetched in the response tells you how many pages were actually retrieved, and total_results gives Amazon's estimated total match count, which can be null.