# Allegro Search API Documentation

Allegro Search API Documentation Search Allegro, the largest marketplace in Poland, Czechia and Slovakia. Filter by category, price range, condition, seller and delivery program, and sort by price, popularity or newest. Every offer has the price as a number with currency, the regular price and discount when Allegro shows one, the condition, the seller with rating and super seller flag, delivery cost, parameters, full size photos, the product rating and the product id for the reviews route. Filters are always honoured: no returned item breaks the price or condition you sent, and a page past the last page returns an empty list, never page 1. Country PL, CZ and SK. Cost: 20 credits per request, only for successful requests with results. Failed and empty requests are not billed.

- **Documentation:** [https://scrappa.co/docs/allegro-api/allegro_search](https://scrappa.co/docs/allegro-api/allegro_search) - **API group:** Allegro API - **Endpoint:** `GET https://scrappa.co/api/allegro/search` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `query` | string | Yes | Search text, for example iphone 13. | | `category` | string | No | Category id or alias from the categories route, for example 165 or smartfony-i-telefony-komorkowe-165. Returns only offers of this category. An unknown category returns 422. | | `price_from` | number | No | Lowest price in the currency of the country. No returned item is cheaper. | | `price_to` | number | No | Highest price in the currency of the country. No returned item is more expensive. | | `condition` | string | No | new, used, damaged or refurbished. CZ and SK support new and used. No returned item has another condition. | | `sort` | string | No | relevance (default), price_asc, price_desc, price_with_delivery_asc, price_with_delivery_desc, popularity, newest or time_left. | | `page` | integer | No | Page number from 1. Allegro shows at most 100 pages. A page past the last page returns an empty list, never page 1. | | `buy_now` | boolean | No | true lists fixed price offers only. Country PL only. | | `smart` | boolean | No | true lists offers with Allegro Smart delivery only. Country PL only. | | `super_seller` | boolean | No | true lists offers of super sellers only. Country PL only. | | `seller_id` | string | No | Numeric seller id from a result. Lists only that seller. Country PL only. | | `country` | string | No | Allegro storefront: PL (allegro.pl, PLN), CZ (allegro.cz, CZK) or SK (allegro.sk, EUR). Default PL. | ## Example response ```json { "data": { "items": [ { "url": "https://allegro.pl/oferta/19092486054", "price": { "amount": 1628, "currency": "PLN" }, "title": "Smartfon Apple iPhone 13 4 GB / 128 GB 5G niebieski", "images": [ "https://a.allegroimg.com/original/295d2b/f1335c204ea4abbaa4a6f5c59d67/Apple-iPhone-13-128GB-Niebieski", "https://a.allegroimg.com/original/11300d/67fab13b4f17a0d1e6a3d9915d3e/Apple-iPhone-13-128GB-Niebieski-Marka-Apple", "https://a.allegroimg.com/original/115426/595025964aa3a2b6033226fde2fa/Apple-iPhone-13-128GB-Niebieski-Wbudowana-pamiec-128-GB" ], "seller": { "id": "120463582", "login": "Elektroshock_EU", "is_company": true, "super_seller": true, "positive_feedback_percent": 96.5 }, "is_smart": true, "offer_id": "19092486054", "quantity": null, "shipping": { "lowest": { "amount": 0, "currency": "PLN" }, "free_return": false, "delivery_text": "dostawa pt. 13 lis.", "free_delivery": true, "price_with_delivery": { "amount": 1628, "currency": "PLN" } }, "condition": null, "sold_text": "51 os\u00f3b kupi\u0142o ostatnio", "parameters": [ { "name": "Kolor", "values": [ "niebieski" ] }, { "name": "Przek\u0105tna ekranu", "values": [ "6.1\"" ] }, { "name": "Wbudowana pami\u0119\u0107", "values": [ "128 GB" ] }, { "name": "Pami\u0119\u0107 RAM", "values": [ "4 GB" ] } ], "product_id": "9e8deda3-e7e4-470e-8238-531161ff3272", "sold_count": 51, "category_id": "320536", "is_sponsored": false, "original_price": { "amount": 1824.16, "currency": "PLN" }, "product_rating": { "count": 664, "average": 4.83 }, "discount_percent": 10, "best_price_guarantee": true, "product_offers_count": 81 }, { "url": "https://allegro.pl/oferta/18907224122", "price": { "amount": 2119.35, "currency": "PLN" }, "title": "Smartfon Apple iPhone 13 4 GB / 512 GB 5G bia\u0142y", "images": [ "https://a.allegroimg.com/original/11448b/f1cdbf30411089386073b7b46240/nowy-ORYG-Apple-iPhone-13-White-512-GB-nano-SIM-eSIM-Lightning", "https://a.allegroimg.com/original/296bd2/30c63c3340b1bf246961d170e0b7/nowy-ORYG-Apple-iPhone-13-White-512-GB-nano-SIM-eSIM-Lightning-Stan-opakowania-oryginalne", "https://a.allegroimg.com/original/11b5ff/88aefdad4f60ab586ada455895fe/nowy-ORYG-Apple-iPhone-13-White-512-GB-nano-SIM-eSIM-Lightning-Kod-producenta-MLQD3PM-A" ], "seller": { "id": "19772085", "login": "FirmaStarex", "is_company": true, "super_seller": false, "positive_feedback_percent": 99.8 }, "is_smart": true, "offer_id": "18907224122", "quantity": null, "shipping": { "lowest": { "amount": 10.49, "currency": "PLN" }, "free_return": false, "delivery_text": "dostawa we wtorek", "free_delivery": false, "price_with_delivery": { "amount": 2129.84, "currency": "PLN" } }, "condition": null, "sold_text": "7 os\u00f3b kupi\u0142o ostatnio", "parameters": [ { "name": "Kolor", "values": [ "bia\u0142y" ] }, { "name": "Przek\u0105tna ekranu", "values": [ "6.1\"" ] }, { "name": "Wbudowana pami\u0119\u0107", "values": [ "512 GB" ] }, { "name": "Pami\u0119\u0107 RAM", "values": [ "4 GB" ] } ], "product_id": "f4e8247d-e2d0-45fa-a8da-a03e75b5a568", "sold_count": 7, "category_id": "320536", "is_sponsored": false, "original_price": { "amount": 2184.9, "currency": "PLN" }, "product_rating": { "count": 6, "average": 5 }, "discount_percent": 3, "best_price_guarantee": false, "product_offers_count": 6 } ], "country": "PL", "filters": { "sort": "relevance", "query": "iphone 13", "category": null, "price_to": null, "condition": null, "seller_id": null, "price_from": null }, "currency": "PLN", "pagination": { "has_next": true, "per_page": 73, "total_pages": 100, "current_page": 1, "total_results": 147543 } }, "meta": { "credits": 20, "billable": true, "endpoint_family": "search" }, "success": true } ``` ## Errors | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. | | 404 | Not Found | The category does not exist. This response is not billable. | | 502 | Upstream Unavailable | Allegro did not answer in time or blocked the lookup. Retry. This response is not billable. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)