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.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
11 optional filters available.
string
Required
Search text, for example iphone 13.
coffee shops
string
Optional
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.
example
number
Optional
Lowest price in the currency of the country. No returned item is cheaper.
10
number
Optional
Highest price in the currency of the country. No returned item is more expensive.
10
string
Optional
new, used, damaged or refurbished. CZ and SK support new and used. No returned item has another condition.
example
string
Optional
relevance (default), price_asc, price_desc, price_with_delivery_asc, price_with_delivery_desc, popularity, newest or time_left.
relevance
integer
Optional
Page number from 1. Allegro shows at most 100 pages. A page past the last page returns an empty list, never page 1.
1
boolean
Optional
true lists fixed price offers only. Country PL only.
true
boolean
Optional
true lists offers with Allegro Smart delivery only. Country PL only.
true
boolean
Optional
true lists offers of super sellers only. Country PL only.
true
string
Optional
Numeric seller id from a result. Lists only that seller. Country PL only.
1234567890
string
Optional
Allegro storefront: PL (allegro.pl, PLN), CZ (allegro.cz, CZK) or SK (allegro.sk, EUR). Default PL.
US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"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
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"query": [
"Send the search text as query."
]
},
"message": "The request validation failed"
}Not Found
The category does not exist. This response is not billable.
{
"meta": {
"billable": false
},
"error": {
"code": "NOT_FOUND",
"message": "Allegro has no result."
},
"success": false
}Upstream Unavailable
Allegro did not answer in time or blocked the lookup. Retry. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Allegro is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.