Amazon APIamazon.pl ↗
Access Amazon Poland product search, ASIN details, deals, categories, and search suggestions via a structured JSON API. Covers prices in PLN, ratings, and more.
What is the Amazon API?
The Amazon.pl API provides 5 endpoints for querying the Polish Amazon marketplace, covering product search, ASIN-level detail retrieval, category navigation, live deals, and autocomplete suggestions. The get_product_details endpoint returns 7 structured fields per product — including title, brand, PLN-formatted price, rating, and image URL — identified by a 10-character ASIN. Together the endpoints give programmatic access to Amazon.pl's full public product catalog and promotional listings.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/0d297dad-bd55-4711-9742-b86a83b1d37b/get_main_categories' \ -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-pl-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.pl SDK — product discovery, details drill-down, and deals."""
from parse_apis.amazon_pl_api import AmazonPl, ProductNotFound
client = AmazonPl()
# Browse top-level categories to understand the marketplace structure.
for category in client.categories.list(limit=5):
print(category.name, category.menu_id)
# Search for products and drill into the first result's full details.
result = client.productsummaries.search(query="laptop", limit=1).first()
if result:
product = result.details()
print(product.title, product.price, product.brand, product.rating)
# Fetch a product directly by ASIN with typed error handling.
try:
detail = client.products.get(asin="B0D77KFLD5")
print(detail.title, detail.price, detail.image_url)
except ProductNotFound as exc:
print(f"Product not found: {exc.asin}")
# Browse current deals on Amazon.pl.
for deal in client.deals.list(limit=3):
print(deal.title, deal.asin, deal.url)
# Get search autocomplete suggestions for a query prefix.
for suggestion in client.searchsuggestions.list(query="telefon", limit=5):
print(suggestion)
print("exercised: categories.list / productsummaries.search / .details / products.get / deals.list / searchsuggestions.list")
Extract all top-level product categories from the Amazon.pl navigation menu. Returns category names and internal menu IDs. Categories are stable; the list changes only when Amazon restructures its Polish storefront.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "array of category objects with name, menu_id, and url"
},
"sample": {
"data": {
"categories": [
{
"url": null,
"name": "Echo i Alexa",
"menu_id": "2"
},
{
"url": null,
"name": "Fire TV",
"menu_id": "3"
},
{
"url": null,
"name": "Elektronika, komputery i biuro",
"menu_id": "7"
}
]
},
"status": "success"
}
}About the Amazon API
Product Search and Detail Retrieval
The search_products endpoint accepts a required query string and an optional integer page parameter (starting at 1), returning up to ~48 results per page. Each result includes the product's asin, title, price, and url. To fetch deeper data for a specific item, pass that ASIN to get_product_details, which returns the product's brand, rating, image_url, and PLN-formatted price. If the ASIN does not exist on Amazon.pl, the endpoint returns an input_not_found response rather than an empty result.
Categories, Deals, and Suggestions
The get_main_categories endpoint requires no parameters and returns all top-level navigation categories as an array, each with a name, menu_id, and url. This list is stable and only changes when Amazon restructures its Polish storefront. The get_deals endpoint fetches the current goldbox/deals page, returning asin, title, and url for each promotional listing — the content rotates frequently as Amazon updates its active promotions.
Search Suggestions
The get_search_suggestions endpoint takes a partial query string and returns an array of autocomplete suggestion strings. This is useful for discovering popular search terms on Amazon.pl, expanding keyword sets for product research, or powering type-ahead interfaces in catalogue tools. No authentication or session parameters are required for any endpoint.
The Amazon API is a managed, monitored endpoint for amazon.pl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when amazon.pl 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.pl 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 PLN price changes on specific ASINs for a price-tracking dashboard
- Aggregate current Amazon.pl deals daily to populate a deal-alert newsletter
- Build a category browser for the Polish Amazon storefront using
get_main_categoriesmenu IDs - Seed a product database with titles, brands, and image URLs via paginated
search_productscalls - Generate keyword expansion lists from
get_search_suggestionsfor SEO or ad campaign research - Cross-reference ASIN ratings across product categories for comparison shopping tools
- Detect new promotional listings by polling
get_dealsand diffing against a stored snapshot
| 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 for Amazon.pl?+
What does `get_product_details` return when an ASIN doesn't exist on Amazon.pl?+
input_not_found response rather than a null result or an empty product object. This lets callers distinguish between a product with missing optional fields (such as brand or rating, which can be null) and an ASIN that genuinely has no matching listing on the Polish storefront.Does the deals endpoint include discount amounts or original prices?+
get_deals returns asin, title, and url for each deal listing, but does not expose discount percentages, original prices, or deal end times. You can fork this API on Parse and revise it to add an endpoint that fetches those additional deal fields.Are customer reviews or seller information available through this API?+
How does pagination work in `search_products`, and are there known limits?+
page parameter starting at 1, with each page returning up to approximately 48 results. The page parameter is optional; omitting it returns the first page. Amazon.pl typically surfaces results up to around page 20–25 for most queries, consistent with what the storefront exposes to users browsing search results.