Amazon APIamazon.se ↗
Search Amazon.se by keyword, get product details by ASIN, and fetch autocomplete suggestions. Returns prices in SEK, ratings, review counts, and deal badges.
What is the Amazon API?
The Amazon Sweden API gives developers access to three endpoints covering product search, product detail lookup, and search autocomplete on amazon.se. search_products returns up to 48 results per page including ASIN, price in SEK, rating, review count, image URL, and deal badges. get_product_details retrieves full product information by ASIN, and get_suggestions returns keyword suggestions matching a query prefix.
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 Product Search — search, autocomplete, and product details."""
from parse_apis.amazon_se_product_search_api import AmazonSe, ProductNotFound
client = AmazonSe()
# Autocomplete: discover popular search terms from a prefix.
for suggestion in client.suggestions.search(query="laptop", limit=5):
print(suggestion.value, suggestion.type)
# Search products by keyword, capped at 3 results.
result = client.productsummaries.search(query="headphones", limit=3).first()
if result:
print(result.title, result.price, result.currency, result.is_prime)
# Drill into full product details from a search result.
detail = result.details()
print(detail.brand, detail.availability, detail.rating)
for feature in detail.features[:2]:
print(feature[:80])
# Direct product lookup by ASIN with typed error handling.
try:
product = client.products.get(asin="B09ZY5LM3C")
print(product.title, product.price, product.currency)
print(product.brand, product.reviews_count, product.product_url)
except ProductNotFound as exc:
print(f"Product not found: {exc.asin}")
print("exercised: suggestions.search / productsummaries.search / details / products.get")
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
search_products accepts a query string and optional page and limit parameters. Each result object includes asin, title, price, currency (SEK), original_price, rating, reviews_count, image_url, product_url, and badge (for deal or promotional labels). When limit exceeds 48, the endpoint fetches multiple pages automatically and reports back pages_fetched and results_count alongside the total_results estimate from Amazon.
Product Detail Lookup
get_product_details takes a single asin string and returns the current price, title, rating, reviews_count, currency, and product_url. When the full product page is accessible, the response also includes brand, feature bullet points, product overview, variant options, and image gallery data. When direct page access is unavailable, the endpoint falls back to search-based results and returns the summary fields only.
Autocomplete Suggestions
get_suggestions accepts a partial query string — even a two-character prefix like 'la' — and returns an array of suggestion objects, each with a value (the suggested keyword) and a type field (typically KEYWORD). The prefix field in the response echoes back your input. This endpoint is useful for building search-ahead UIs or systematically discovering keyword variants on the Swedish Amazon marketplace.
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 market price monitoring.
- Build a product comparison tool using search results with ratings and review counts from amazon.se.
- Populate a deal-finder feed by filtering search results for non-null
badgefields. - Seed a keyword research tool using autocomplete suggestions for Swedish-language product queries.
- Cross-reference ASINs between Amazon.se and other regional Amazon APIs to identify pricing gaps.
- Aggregate product image URLs and titles for a Swedish affiliate product catalogue.
- Validate product availability and current pricing on Amazon Sweden before programmatic ad spend.
| 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 have an official developer API?+
What does `get_product_details` return when the full product page isn't accessible?+
title, price, currency, rating, reviews_count, and product_url. The extended fields — brand, feature bullets, product overview, variants, and image gallery — are only included when the direct product page is accessible.Does the API cover seller information, Buy Box details, or fulfilled-by data?+
Are customer review texts accessible through this API?+
reviews_count and rating as aggregate figures but does not include individual review texts, reviewer names, or per-review ratings. You can fork the API on Parse and revise it to add a reviews endpoint that returns individual review content.How does pagination work in `search_products`?+
page integer and a limit to cap total results. When limit requires more than one page, the endpoint fetches additional pages automatically. The response includes pages_fetched to confirm how many pages were retrieved and total_results for the estimated total available on Amazon (which may be null).