Allegro.pl Listings by Search, Category or URL
Find Allegro.pl products by keyword search, category page, or direct offer URL, with price, seller rating, condition, shipping, and rating details, filterable by price range and free shipping.
Input schema
Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.
| Field | Type | Required | Description |
|---|---|---|---|
mode | string | required | What to scrape. Search by keyword, browse categories or sellers, fetch specific offer/product URLs, get every seller for a product, read product reviews, or build seller profiles. |
searchQueries | array | optional | Keywords to search for. One query per line. (mode=search) |
categoryUrls | array | optional | Allegro category URLs, or category ids/aliases. (mode=byCategory) |
Show all input fields
| Field | Type | Required | Description |
|---|---|---|---|
mode | string | required | What to scrape. Search by keyword, browse categories or sellers, fetch specific offer/product URLs, get every seller for a product, read product reviews, or build seller profiles. |
searchQueries | array | optional | Keywords to search for. One query per line. (mode=search) |
categoryUrls | array | optional | Allegro category URLs, or category ids/aliases. (mode=byCategory) |
startUrls | array | optional | Offer, product, product-offers, seller or review target URLs. Use this for byUrl, bySeller, byProduct, reviews and sellerProfiles. |
market | string | optional | Allegro marketplace. Only Poland (allegro.pl) is supported. |
sortBy | string | optional | Order of results for search, category, seller and product-offer listings. |
condition | string | optional | Filter listings by item condition. |
minPrice | integer | optional | Lowest price in PLN. Leave empty for no minimum. |
maxPrice | integer | optional | Highest price in PLN. Leave empty for no maximum. |
freeShippingOnly | boolean | optional | Use Allegro's free-delivery (Smart!) filter for listing modes. |
buyNowOnly | boolean | optional | Exclude auctions and keep only offers you can buy immediately. |
superSellerOnly | boolean | optional | Keep only offers from Allegro Super Sellers. |
includeSponsored | boolean | optional | Include sponsored placements in listing results. Turn off for organic results only. |
includeDetails | boolean | optional | Open each offer from search, category, seller and product-offer listings to add stock, GTIN, full specs, company identity, warranty and returns. Slower and uses more requests. |
maxItems | integer | optional | Maximum records to return. Listing modes cap each source at 6,000 offers (100 pages). |
maxReviewsPerProduct | integer | optional | Maximum reviews to collect for each product in reviews mode. |
Download the published input schema
View complete JSON
{
"description": "Choose what to scrape on Allegro.pl: keyword searches, category pages, seller storefronts, offer or product URLs, product reviews, or seller profiles.",
"properties": {
"buyNowOnly": {
"default": false,
"description": "Exclude auctions and keep only offers you can buy immediately.",
"prefill": false,
"title": "Buy Now Only",
"type": "boolean"
},
"categoryUrls": {
"description": "Allegro category URLs, or category ids/aliases. (mode=byCategory)",
"editor": "requestListSources",
"prefill": [],
"title": "Category URLs",
"type": "array"
},
"condition": {
"default": "all",
"description": "Filter listings by item condition.",
"editor": "select",
"enum": [
"all",
"new",
"used",
"refurbished",
"damaged"
],
"enumTitles": [
"Any condition",
"New",
"Used",
"Refurbished",
"Damaged"
],
"prefill": "all",
"title": "Condition",
"type": "string"
},
"freeShippingOnly": {
"default": false,
"description": "Use Allegro's free-delivery (Smart!) filter for listing modes.",
"prefill": false,
"title": "Free Delivery Only",
"type": "boolean"
},
"includeDetails": {
"default": false,
"description": "Open each offer from search, category, seller and product-offer listings to add stock, GTIN, full specs, company identity, warranty and returns. Slower and uses more requests.",
"prefill": false,
"title": "Enrich With Offer Details",
"type": "boolean"
},
"includeSponsored": {
"default": true,
"description": "Include sponsored placements in listing results. Turn off for organic results only.",
"prefill": true,
"title": "Include Sponsored Offers",
"type": "boolean"
},
"market": {
"default": "pl",
"description": "Allegro marketplace. Only Poland (allegro.pl) is supported.",
"editor": "select",
"enum": [
"pl"
],
"enumTitles": [
"Poland (allegro.pl)"
],
"prefill": "pl",
"title": "Market",
"type": "string"
},
"maxItems": {
"default": 100,
"description": "Maximum records to return. Listing modes cap each source at 6,000 offers (100 pages).",
"maximum": 6000,
"minimum": 1,
"prefill": 2,
"title": "Max Items",
"type": "integer"
},
"maxPrice": {
"description": "Highest price in PLN. Leave empty for no maximum.",
"maximum": 1000000,
"minimum": 0,
"title": "Maximum Price",
"type": "integer"
},
"maxReviewsPerProduct": {
"default": 100,
"description": "Maximum reviews to collect for each product in reviews mode.",
"maximum": 1000,
"minimum": 1,
"prefill": 100,
"title": "Max Reviews Per Product",
"type": "integer"
},
"minPrice": {
"description": "Lowest price in PLN. Leave empty for no minimum.",
"maximum": 1000000,
"minimum": 0,
"title": "Minimum Price",
"type": "integer"
},
"mode": {
"default": "search",
"description": "What to scrape. Search by keyword, browse categories or sellers, fetch specific offer/product URLs, get every seller for a product, read product reviews, or build seller profiles.",
"editor": "select",
"enum": [
"search",
"byCategory",
"bySeller",
"byUrl",
"byProduct",
"reviews",
"sellerProfiles"
],
"enumTitles": [
"Search by keyword",
"Browse category pages",
"Browse seller storefronts",
"Fetch offer or product URLs",
"Every seller for a product",
"Product reviews",
"Seller profiles"
],
"prefill": "search",
"title": "Mode",
"type": "string"
},
"searchQueries": {
"description": "Keywords to search for. One query per line. (mode=search)",
"editor": "stringList",
"prefill": [
"laptop"
],
"title": "Search Queries",
"type": "array"
},
"sortBy": {
"default": "relevance",
"description": "Order of results for search, category, seller and product-offer listings.",
"editor": "select",
"enum": [
"relevance",
"price_asc",
"price_desc",
"price_with_delivery_asc",
"price_with_delivery_desc",
"popularity",
"ending_soonest",
"newest",
"product_rating"
],
"enumTitles": [
"Relevance",
"Price: low to high",
"Price: high to low",
"Price with delivery: low to high",
"Price with delivery: high to low",
"Popularity",
"Ending soonest",
"Newest first",
"Product rating"
],
"prefill": "relevance",
"title": "Sort By",
"type": "string"
},
"startUrls": {
"description": "Offer, product, product-offers, seller or review target URLs. Use this for byUrl, bySeller, byProduct, reviews and sellerProfiles.",
"editor": "requestListSources",
"prefill": [],
"title": "Start URLs",
"type": "array"
},
"superSellerOnly": {
"default": false,
"description": "Keep only offers from Allegro Super Sellers.",
"prefill": false,
"title": "Super Seller Only",
"type": "boolean"
}
},
"required": [
"mode"
],
"schemaVersion": 1,
"title": "Allegro Scraper Input",
"type": "object"
}
Output schema
Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.
| Field | Type | Required | Description |
|---|---|---|---|
listings | string | optional | Dataset of listing, review and seller records; the recordType field tells them apart. |
Download the published output schema
View complete JSON
{
"actorOutputSchemaVersion": 1,
"description": "Allegro listings, offer details, buyer reviews and seller profiles with prices, delivery, stock, specs, company identity and ranking signals.",
"properties": {
"listings": {
"description": "Dataset of listing, review and seller records; the recordType field tells them apart.",
"template": "{{links.apiDefaultDatasetUrl}}/items",
"title": "Allegro records",
"type": "string"
}
},
"title": "Allegro Scraper Output"
}
Dataset schema
Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.
Download the published dataset schema
View complete JSON
{
"actorSpecification": 1,
"views": {
"overview": {
"display": {
"component": "table",
"properties": {}
},
"title": "Allegro Records",
"transformation": {
"fields": [
"recordType",
"title",
"price",
"currency",
"condition",
"seller",
"freeShipping",
"rating",
"reviewCount",
"url"
]
}
}
}
}
Key-value schema
Published key-value store definitions, when provided by this build.
This definition is not present in the default published build. See the published README for available documentation.
Published README
Read the full published documentation
Allegro Scraper: Listings, Offers, Reviews & Sellers
Collect public data from Allegro.pl, Poland's largest marketplace, in one run. Start from a keyword search, a category page, a seller storefront, or any offer and product URL. The actor returns listing cards with price, delivery, seller and ranking signals, full offer details with stock, GTIN, specifications and company identity, buyer reviews, and seller profiles.
No API key, account, cookie or proxy setup is required.
What this actor does
- Seven ways in: keyword search, category pages, seller storefronts, direct offer/product URLs, every seller for one product, product reviews, and seller profiles.
- Nine sort orders: relevance, price, price with delivery, popularity, ending soonest, newest, and product rating.
- Live filters: condition, price range, Buy Now, free delivery (Smart!), Super Seller, sponsored in/out.
- Listing intelligence: price and price with delivery, original price and discount, stock, seller rating and company flag, product rating, 30-day buyer counts, offer counts, parameters, images, rank, organic rank and sponsored flags.
- Offer details: stock quantity and purchase limit, GTIN, brand, full specifications, description, seller company name and tax ids, delivery methods, returns, warranty, location and publication dates.
- Reviews: star rating, text, pros and cons, photos, helpful votes, language, variant and reviewer details.
- Seller profiles: recommendation percentage, positive and negative counts, total ratings, time on Allegro, storefront offer count, categories and company identity.
- Clean records: empty fields are omitted at every level. No nulls, blank strings or empty objects.
Modes
| Mode | What it reads | What you get |
|---|---|---|
search |
searchQueries |
Paginated keyword results with filters and sort |
byCategory |
categoryUrls |
Category pages with filters and sort |
bySeller |
startUrls |
A seller's storefront offers |
byUrl |
startUrls |
Full detail for offer and product URLs; listing rows for product-offers URLs |
byProduct |
startUrls |
Every seller's offer for one product UUID or product URL |
reviews |
startUrls |
Buyer reviews for product UUIDs or product URLs |
sellerProfiles |
startUrls |
Seller rating summary, company identity and storefront stats |
byUrl also accepts offer, product and product-offers URLs. bySeller and sellerProfiles accept seller URLs. Wrong-mode URLs are skipped with a status message instead of failing the whole run.
Output
Every record has a recordType:
listingfor search, category, seller, product-offers and offer/product rows.reviewfor buyer opinions.sellerfor seller profiles.
Listing and offer fields
| Field | Meaning |
|---|---|
offerId |
Allegro offer identifier |
title |
Offer title |
url |
Canonical offer URL |
price, currency |
Current price and currency |
originalPrice, discountPercent |
Pre-discount price and discount when present |
priceWithDelivery, deliveryCost, deliveryText |
Delivery-aware price and cheapest delivery |
freeShipping, isSmart, hasFreeReturn |
Delivery perks |
condition |
new, used, refurbished or damaged |
seller, sellerId, sellerUrl, sellerRating |
Seller identity and positive-feedback percentage |
sellerIsCompany, sellerSuperSeller, sellerPositiveCount, sellerNegativeCount |
Seller badges and feedback counts |
sellerCompany |
Legal name, tax id, REGON, KRS, address and verification |
imageUrl, images, thumbnail |
Product media |
category, categoryId, categoryPath |
Category identity and breadcrumbs |
rating, reviewCount |
Product rating and rating count |
productId, productUrl, productOffersCount |
Catalog product and seller count |
soldLast30Days |
Buyers in the last 30 days |
stockQuantity, stockUnit, purchaseLimit |
Stock and order limits |
brand, gtin |
Brand and GTIN/EAN when published |
parameters |
Name/value specification pairs |
description, warranty, returnPolicy |
Full text, warranty and returns |
publicationStart, publicationEnd |
Offer publication window |
location |
Seller city and country |
deliveryMethods |
Delivery method, group, cost and time |
position, organicPosition, page |
Overall rank, organic rank and source page |
isSponsored, isPromoted, sponsoredAndOrganic |
Placement flags |
recordType, scrapedAt |
Record kind and UTC scrape time |
Review records add reviewId, productId, productUrl, author, rating, ratingPercent, text, pros, cons, images, createdAt, helpfulYes, helpfulNo, language, sellerLogin, variant, isBest and productFeatures.
Seller records add sellerId, seller, url, positivePercent, positiveCount, negativeCount, ratingsTotal, onAllegroSince, offersCount, isCompany, superSeller, company, location and categories.
Input
| Field | Type | Default | Description |
|---|---|---|---|
mode |
string | search |
search, byCategory, bySeller, byUrl, byProduct, reviews or sellerProfiles |
searchQueries |
array | – | Keywords for search |
categoryUrls |
array | – | Category URLs for byCategory |
startUrls |
array | – | URLs or ids for bySeller, byUrl, byProduct, reviews and sellerProfiles |
market |
string | pl |
Only pl (allegro.pl) is supported |
sortBy |
string | relevance |
One of the nine sort orders |
condition |
string | all |
all, new, used, refurbished or damaged |
minPrice |
integer | – | Minimum price in PLN |
maxPrice |
integer | – | Maximum price in PLN |
freeShippingOnly |
boolean | false |
Apply Allegro's free-delivery filter |
buyNowOnly |
boolean | false |
Exclude auctions |
superSellerOnly |
boolean | false |
Keep Super Seller offers |
includeSponsored |
boolean | true |
Include sponsored placements |
includeDetails |
boolean | false |
Open each offer in listing modes for stock, GTIN, specs and company data |
maxItems |
integer | 100 |
Total records; each source is capped at 6,000 offers |
maxReviewsPerProduct |
integer | 100 |
Review limit per product in reviews mode |
Old inputs remain valid without appearing in the form: searchQuery, categoryUrl, conditionFilter and the old sortBy/mode values are mapped automatically. A saved proxyConfiguration is ignored because the actor handles access itself.
Examples
Search for new laptops under 3,000 PLN
{
"mode": "search",
"searchQueries": ["laptop"],
"condition": "new",
"maxPrice": 3000,
"sortBy": "price_asc",
"maxItems": 100
}
Browse a category with free delivery
{
"mode": "byCategory",
"categoryUrls": [{"url": "https://allegro.pl/kategoria/laptopy-491"}],
"sortBy": "popularity",
"freeShippingOnly": true,
"includeDetails": true,
"maxItems": 200
}
Fetch offer and product URLs with full detail
{
"mode": "byUrl",
"startUrls": [
{"url": "https://allegro.pl/oferta/10828773185"},
{"url": "https://allegro.pl/produkt/880fe6be-3992-4532-97f2-8fd88c55889a"}
]
}
Reviews and seller profiles
{
"mode": "reviews",
"startUrls": [{"url": "https://allegro.pl/produkt/880fe6be-3992-4532-97f2-8fd88c55889a"}],
"maxReviewsPerProduct": 100
}
{
"mode": "sellerProfiles",
"startUrls": [{"url": "https://allegro.pl/uzytkownik/ogit_pl"}]
}
Use cases
- Monitor prices, discounts and delivery costs across Allegro categories.
- Compare every seller's price and stock for the same catalog product.
- Build seller intelligence lists with company identity, rating and storefront size.
- Track rank, sponsored placement and 30-day demand signals for a keyword.
- Collect buyer reviews for sentiment, product quality and variant analysis.
- Feed price-comparison, assortment and repricing workflows with clean records.
Limits
- Market: Allegro.pl only. Czech and Slovak marketplaces are not available in this version.
- Pagination: each listing source stops at page 100. Page 100 is served; page 101 redirects back to page 1, which the actor treats as the end. That is about 6,000 offers per query; split broad searches by price, category or condition to go deeper.
- Detail pages: anti-bot protection can occasionally block an individual detail page. Listing rows are always kept; missing detail fields are omitted and counted in the status message.
- Seller storefronts:
bySellerreads the seller rating summary once per seller so rows carrysellerandsellerRatingeven though storefront cards omit them. If that summary is blocked, offers are still returned and the rating is omitted. - History: Allegro does not publish historical price or sales charts, so the actor returns current values only.
- Private contact data: only company details that sellers publish are returned. No off-platform email or phone lookup is performed.
FAQ
Do I need an Allegro account, API key, cookie or proxy? No. The actor reads public pages and manages access automatically. Nothing is required from you.
Which modes can return the most fields?
Offer and product URLs always return full detail. For search, category, seller and product-offer runs, turn on includeDetails to add stock, GTIN, specifications, company identity, warranty and returns to every listing.
Why are some fields missing from a record?
Allegro does not publish every field for every offer. Empty values are omitted rather than filled with nulls or placeholders. Condition, GTIN, brand and discount are the fields most often absent on listing cards; includeDetails fills most of them.
How many results can one search return? Up to 100 pages, or roughly 6,000 offers, per source. Use narrower keywords, a category, a price range or a condition filter to reach more of a large result set.
What do position and organicPosition mean?
position is the card's overall order on the listing, including sponsored placements. organicPosition counts only non-sponsored cards. page tells you which listing page the card came from.
How are sponsored offers handled?
They are included by default and marked with isSponsored. Set includeSponsored to false for organic results only. When the same offer appears as both sponsored and organic, one record is kept and marked sponsoredAndOrganic.
Can I pass bare ids instead of URLs?
API callers can pass bare offer ids, product UUIDs and seller logins wherever URLs are accepted; category ids and aliases also work for byCategory. In the form, use the full Allegro URL.
Are the results deduplicated? Yes. Each source is deduplicated by offer id, so a repeated placement does not create a duplicate row.
Does the actor work on allegro.cz or allegro.sk? Not yet. Only allegro.pl is supported, and CZ/SK URLs are rejected with a clear status message.
Is this actor affiliated with Allegro? No. It is an independent third-party tool that reads publicly available marketplace data and is not endorsed by or connected to Allegro.
Python quickstart
Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.
Source build 6jqVxUOWUn3BxY9EE. Documentation is regenerated from the default published build; private drafts are not included.