allegro.pl APIallegro.pl ↗
Access Allegro.pl product listings, category browsing, offer details, and search suggestions via 4 structured API endpoints. Poland's largest marketplace.
curl -X GET 'https://api.parse.bot/scraper/2741a3d6-d8f9-4e3f-b583-f6b0b22eba82/search_products?query=laptop' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Allegro.pl with optional sorting and pagination.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number to retrieve. |
| sort | string | Sorting order: relevance, price_asc, price_desc, popularity, newest. |
| queryrequired | string | Search keyword. |
{
"type": "object",
"fields": {
"items": "array of product objects",
"total": "integer"
},
"sample": {
"status": "blocked",
"message": "IP address or session has been hard blocked by DataDome",
"block_type": "datadome"
}
}About the allegro.pl API
The Allegro.pl API provides 4 endpoints covering product search, category browsing, individual listing details, and autocomplete suggestions from Poland's largest e-commerce marketplace. The get_product_details endpoint returns title, price, images, seller information, and description for any offer by ID or URL, while search_products supports sorting by relevance, price, popularity, or newest listings.
Endpoints and Data Coverage
The search_products endpoint accepts a required query string plus optional sort and page parameters. Sort options include relevance, price_asc, price_desc, popularity, and newest. Responses return an items array of product objects and a total integer count, making it straightforward to implement paginated result sets or compare listing volumes across keyword variations.
Listing Details
get_product_details accepts either a full Allegro offer URL (url) or a bare offer_id. The response includes title, price, description, an images array of URLs, and a seller object. This makes it suitable for monitoring individual listings, tracking price changes over time, or aggregating seller metadata.
Category Browsing and Autocomplete
browse_category takes a required category_id and optional category_slug and page inputs, returning the same items array shape as search_products. This allows traversal of Allegro's category tree when you already know a category identifier. get_search_suggestions accepts a keyword prefix and returns a suggestions array where each entry includes query, type, url, and optional completion_text, plus a total count — useful for building search-assist features or mapping out how Allegro categorises a topic area.
- Track price movements on specific Allegro listings using
get_product_detailswith a knownoffer_id. - Build a price comparison tool by running
search_productswithsort=price_ascandsort=price_desc. - Discover top product categories and popular queries using
get_search_suggestionswith keyword prefixes. - Aggregate seller profiles across multiple listings to research vendor activity on the platform.
- Monitor new listings in a category by polling
browse_categorywithpagepagination. - Compile product image datasets for a given keyword by extracting the
imagesarray from search results. - Map Allegro's category structure by browsing
category_idvalues and collecting returned item metadata.
| 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 Allegro.pl have an official developer API?+
What does `get_product_details` return, and can I retrieve seller ratings?+
title, price, description, an images array, and a seller object. The seller object exposes seller identity metadata available on the listing page. Detailed seller feedback scores and full review histories are not currently included in the response. You can fork this API on Parse and revise it to add a dedicated seller-ratings endpoint.Does the API cover auction-style listings separately from Buy Now offers?+
get_product_details response covers price and description fields present on the listing. You can fork this API on Parse and revise it to surface the offer format as an explicit response field.How does pagination work in `search_products` and `browse_category`?+
page parameter. The search_products response includes a total integer indicating how many results exist for the query, which you can use to calculate how many pages to iterate. browse_category follows the same pattern using category_id as the primary filter.