Vexaloom Labs

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.

FieldTypeRequiredDescription
modestringrequiredWhat 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.
searchQueriesarrayoptionalKeywords to search for. One query per line. (mode=search)
categoryUrlsarrayoptionalAllegro category URLs, or category ids/aliases. (mode=byCategory)
Show all input fields
FieldTypeRequiredDescription
modestringrequiredWhat 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.
searchQueriesarrayoptionalKeywords to search for. One query per line. (mode=search)
categoryUrlsarrayoptionalAllegro category URLs, or category ids/aliases. (mode=byCategory)
startUrlsarrayoptionalOffer, product, product-offers, seller or review target URLs. Use this for byUrl, bySeller, byProduct, reviews and sellerProfiles.
marketstringoptionalAllegro marketplace. Only Poland (allegro.pl) is supported.
sortBystringoptionalOrder of results for search, category, seller and product-offer listings.
conditionstringoptionalFilter listings by item condition.
minPriceintegeroptionalLowest price in PLN. Leave empty for no minimum.
maxPriceintegeroptionalHighest price in PLN. Leave empty for no maximum.
freeShippingOnlybooleanoptionalUse Allegro's free-delivery (Smart!) filter for listing modes.
buyNowOnlybooleanoptionalExclude auctions and keep only offers you can buy immediately.
superSellerOnlybooleanoptionalKeep only offers from Allegro Super Sellers.
includeSponsoredbooleanoptionalInclude sponsored placements in listing results. Turn off for organic results only.
includeDetailsbooleanoptionalOpen 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.
maxItemsintegeroptionalMaximum records to return. Listing modes cap each source at 6,000 offers (100 pages).
maxReviewsPerProductintegeroptionalMaximum 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.

FieldTypeRequiredDescription
listingsstringoptionalDataset 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:

  • listing for search, category, seller, product-offers and offer/product rows.
  • review for buyer opinions.
  • seller for 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: bySeller reads the seller rating summary once per seller so rows carry seller and sellerRating even 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.

Open the step-by-step Python guide →

Source build 6jqVxUOWUn3BxY9EE. Documentation is regenerated from the default published build; private drafts are not included.