amazon.pl APIamazon.pl ↗
Access Amazon Poland product search, ASIN details, deals, category listings, and search suggestions via a structured JSON API.
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'
Extract all top-level product categories from the Amazon.pl navigation menu. Returns category names and internal menu IDs.
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.pl API
The Amazon.pl API covers 5 endpoints for querying the Polish Amazon marketplace, returning product titles, prices in PLN, ASINs, brand names, ratings, and image URLs. The search_products endpoint accepts a keyword and optional page number to retrieve paginated product listings, while get_product_details resolves a single ASIN to a full detail record including brand, rating, and image URL.
Product Search and Detail Lookup
The search_products endpoint accepts a required query string and an optional page integer for pagination. Each product object in the response includes asin, title, price, and url. To drill into a specific item, pass its ASIN to get_product_details, which returns title, price (formatted in PLN), brand, rating, image_url, url, and the asin itself. Fields that are unavailable on the product page are returned as null rather than omitted.
Deals and Categories
get_deals returns current promotions from the Amazon.pl deals page. Each deal object includes asin, title, and url. No pricing or discount percentage is included in the deals response. get_main_categories retrieves the top-level navigation categories, returning each category's name, menu_id, and url — useful for building browse-style interfaces or seeding category-level search queries.
Search Suggestions
The get_search_suggestions endpoint accepts a query prefix string and returns an array of suggested search terms as plain strings. This mirrors the autocomplete behavior on Amazon.pl and is useful for query expansion, keyword research, or building typeahead UI components targeted at Polish shoppers.
- Monitor PLN price changes on specific ASINs for a price-tracking tool
- Aggregate current Amazon.pl deals into a Polish deal-alert newsletter
- Build a product search interface for the Polish market using keyword results
- Seed a category browser using top-level navigation menu IDs and URLs
- Expand keyword lists for Polish Amazon PPC campaigns using search suggestions
- Validate ASIN availability and retrieve brand and rating data for catalog enrichment
- Compare product titles and prices across paginated search result pages
| 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 | 250 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 Poland have an official developer API?+
What does get_product_details return when a field is not listed on the product page?+
brand, price, rating, and image_url — are returned as null rather than being dropped from the response object. The asin, title, and url fields are always present when the product is found.Does the deals endpoint include discount amounts or original prices?+
get_deals returns asin, title, and url for each deal item; discount percentage and original versus deal price are not included. You can fork this API on Parse and revise it to add a deal-price detail endpoint that fetches those fields.Does the API cover customer reviews or seller information?+
Is pagination supported across all listing endpoints?+
search_products accepts an optional page integer parameter for paginating through result sets. get_deals and get_main_categories do not expose a pagination parameter and return a single page of results per call.