{
  "data": {
    "id": "6jqVxUOWUn3BxY9EE",
    "actId": "yTGdPYNIY8yiaWGK5",
    "userId": "NL4ThgItAwaoBlffQ",
    "startedAt": "2026-10-31T13:22:42.534Z",
    "finishedAt": "2026-10-31T13:23:15.783Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CLI"
    },
    "stats": {
      "durationMillis": 33132,
      "runTimeSecs": 33.132,
      "computeUnits": 0.03681333333333334,
      "imageSizeBytes": 3145606656
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "zifX0mkAFMHe8CatY",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Allegro Scraper Input\",\n  \"description\": \"Choose what to scrape on Allegro.pl: keyword searches, category pages, seller storefronts, offer or product URLs, product reviews, or seller profiles.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"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.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"search\",\n        \"byCategory\",\n        \"bySeller\",\n        \"byUrl\",\n        \"byProduct\",\n        \"reviews\",\n        \"sellerProfiles\"\n      ],\n      \"enumTitles\": [\n        \"Search by keyword\",\n        \"Browse category pages\",\n        \"Browse seller storefronts\",\n        \"Fetch offer or product URLs\",\n        \"Every seller for a product\",\n        \"Product reviews\",\n        \"Seller profiles\"\n      ],\n      \"default\": \"search\",\n      \"prefill\": \"search\"\n    },\n    \"searchQueries\": {\n      \"title\": \"Search Queries\",\n      \"type\": \"array\",\n      \"description\": \"Keywords to search for. One query per line. (mode=search)\",\n      \"editor\": \"stringList\",\n      \"prefill\": [\n        \"laptop\"\n      ]\n    },\n    \"categoryUrls\": {\n      \"title\": \"Category URLs\",\n      \"type\": \"array\",\n      \"description\": \"Allegro category URLs, or category ids/aliases. (mode=byCategory)\",\n      \"editor\": \"requestListSources\",\n      \"prefill\": []\n    },\n    \"startUrls\": {\n      \"title\": \"Start URLs\",\n      \"type\": \"array\",\n      \"description\": \"Offer, product, product-offers, seller or review target URLs. Use this for byUrl, bySeller, byProduct, reviews and sellerProfiles.\",\n      \"editor\": \"requestListSources\",\n      \"prefill\": []\n    },\n    \"market\": {\n      \"title\": \"Market\",\n      \"type\": \"string\",\n      \"description\": \"Allegro marketplace. Only Poland (allegro.pl) is supported.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"pl\"\n      ],\n      \"enumTitles\": [\n        \"Poland (allegro.pl)\"\n      ],\n      \"default\": \"pl\",\n      \"prefill\": \"pl\"\n    },\n    \"sortBy\": {\n      \"title\": \"Sort By\",\n      \"type\": \"string\",\n      \"description\": \"Order of results for search, category, seller and product-offer listings.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"relevance\",\n        \"price_asc\",\n        \"price_desc\",\n        \"price_with_delivery_asc\",\n        \"price_with_delivery_desc\",\n        \"popularity\",\n        \"ending_soonest\",\n        \"newest\",\n        \"product_rating\"\n      ],\n      \"enumTitles\": [\n        \"Relevance\",\n        \"Price: low to high\",\n        \"Price: high to low\",\n        \"Price with delivery: low to high\",\n        \"Price with delivery: high to low\",\n        \"Popularity\",\n        \"Ending soonest\",\n        \"Newest first\",\n        \"Product rating\"\n      ],\n      \"default\": \"relevance\",\n      \"prefill\": \"relevance\"\n    },\n    \"condition\": {\n      \"title\": \"Condition\",\n      \"type\": \"string\",\n      \"description\": \"Filter listings by item condition.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"all\",\n        \"new\",\n        \"used\",\n        \"refurbished\",\n        \"damaged\"\n      ],\n      \"enumTitles\": [\n        \"Any condition\",\n        \"New\",\n        \"Used\",\n        \"Refurbished\",\n        \"Damaged\"\n      ],\n      \"default\": \"all\",\n      \"prefill\": \"all\"\n    },\n    \"minPrice\": {\n      \"title\": \"Minimum Price\",\n      \"type\": \"integer\",\n      \"description\": \"Lowest price in PLN. Leave empty for no minimum.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000\n    },\n    \"maxPrice\": {\n      \"title\": \"Maximum Price\",\n      \"type\": \"integer\",\n      \"description\": \"Highest price in PLN. Leave empty for no maximum.\",\n      \"minimum\": 0,\n      \"maximum\": 1000000\n    },\n    \"freeShippingOnly\": {\n      \"title\": \"Free Delivery Only\",\n      \"type\": \"boolean\",\n      \"description\": \"Use Allegro's free-delivery (Smart!) filter for listing modes.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"buyNowOnly\": {\n      \"title\": \"Buy Now Only\",\n      \"type\": \"boolean\",\n      \"description\": \"Exclude auctions and keep only offers you can buy immediately.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"superSellerOnly\": {\n      \"title\": \"Super Seller Only\",\n      \"type\": \"boolean\",\n      \"description\": \"Keep only offers from Allegro Super Sellers.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"includeSponsored\": {\n      \"title\": \"Include Sponsored Offers\",\n      \"type\": \"boolean\",\n      \"description\": \"Include sponsored placements in listing results. Turn off for organic results only.\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"includeDetails\": {\n      \"title\": \"Enrich With Offer Details\",\n      \"type\": \"boolean\",\n      \"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.\",\n      \"default\": false,\n      \"prefill\": false\n    },\n    \"maxItems\": {\n      \"title\": \"Max Items\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum records to return. Listing modes cap each source at 6,000 offers (100 pages).\",\n      \"default\": 100,\n      \"prefill\": 2,\n      \"minimum\": 1,\n      \"maximum\": 6000\n    },\n    \"maxReviewsPerProduct\": {\n      \"title\": \"Max Reviews Per Product\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum reviews to collect for each product in reviews mode.\",\n      \"default\": 100,\n      \"prefill\": 100,\n      \"minimum\": 1,\n      \"maximum\": 1000\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Allegro Scraper: Listings, Offers, Reviews & Sellers\n\nCollect 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.\n\nNo API key, account, cookie or proxy setup is required.\n\n## What this actor does\n\n- **Seven ways in:** keyword search, category pages, seller storefronts, direct offer/product URLs, every seller for one product, product reviews, and seller profiles.\n- **Nine sort orders:** relevance, price, price with delivery, popularity, ending soonest, newest, and product rating.\n- **Live filters:** condition, price range, Buy Now, free delivery (Smart!), Super Seller, sponsored in/out.\n- **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.\n- **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.\n- **Reviews:** star rating, text, pros and cons, photos, helpful votes, language, variant and reviewer details.\n- **Seller profiles:** recommendation percentage, positive and negative counts, total ratings, time on Allegro, storefront offer count, categories and company identity.\n- **Clean records:** empty fields are omitted at every level. No nulls, blank strings or empty objects.\n\n## Modes\n\n| Mode | What it reads | What you get |\n|---|---|---|\n| `search` | `searchQueries` | Paginated keyword results with filters and sort |\n| `byCategory` | `categoryUrls` | Category pages with filters and sort |\n| `bySeller` | `startUrls` | A seller's storefront offers |\n| `byUrl` | `startUrls` | Full detail for offer and product URLs; listing rows for product-offers URLs |\n| `byProduct` | `startUrls` | Every seller's offer for one product UUID or product URL |\n| `reviews` | `startUrls` | Buyer reviews for product UUIDs or product URLs |\n| `sellerProfiles` | `startUrls` | Seller rating summary, company identity and storefront stats |\n\n`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.\n\n## Output\n\nEvery record has a `recordType`:\n\n- `listing` for search, category, seller, product-offers and offer/product rows.\n- `review` for buyer opinions.\n- `seller` for seller profiles.\n\n### Listing and offer fields\n\n| Field | Meaning |\n|---|---|\n| `offerId` | Allegro offer identifier |\n| `title` | Offer title |\n| `url` | Canonical offer URL |\n| `price`, `currency` | Current price and currency |\n| `originalPrice`, `discountPercent` | Pre-discount price and discount when present |\n| `priceWithDelivery`, `deliveryCost`, `deliveryText` | Delivery-aware price and cheapest delivery |\n| `freeShipping`, `isSmart`, `hasFreeReturn` | Delivery perks |\n| `condition` | `new`, `used`, `refurbished` or `damaged` |\n| `seller`, `sellerId`, `sellerUrl`, `sellerRating` | Seller identity and positive-feedback percentage |\n| `sellerIsCompany`, `sellerSuperSeller`, `sellerPositiveCount`, `sellerNegativeCount` | Seller badges and feedback counts |\n| `sellerCompany` | Legal name, tax id, REGON, KRS, address and verification |\n| `imageUrl`, `images`, `thumbnail` | Product media |\n| `category`, `categoryId`, `categoryPath` | Category identity and breadcrumbs |\n| `rating`, `reviewCount` | Product rating and rating count |\n| `productId`, `productUrl`, `productOffersCount` | Catalog product and seller count |\n| `soldLast30Days` | Buyers in the last 30 days |\n| `stockQuantity`, `stockUnit`, `purchaseLimit` | Stock and order limits |\n| `brand`, `gtin` | Brand and GTIN/EAN when published |\n| `parameters` | Name/value specification pairs |\n| `description`, `warranty`, `returnPolicy` | Full text, warranty and returns |\n| `publicationStart`, `publicationEnd` | Offer publication window |\n| `location` | Seller city and country |\n| `deliveryMethods` | Delivery method, group, cost and time |\n| `position`, `organicPosition`, `page` | Overall rank, organic rank and source page |\n| `isSponsored`, `isPromoted`, `sponsoredAndOrganic` | Placement flags |\n| `recordType`, `scrapedAt` | Record kind and UTC scrape time |\n\nReview records add `reviewId`, `productId`, `productUrl`, `author`, `rating`, `ratingPercent`, `text`, `pros`, `cons`, `images`, `createdAt`, `helpfulYes`, `helpfulNo`, `language`, `sellerLogin`, `variant`, `isBest` and `productFeatures`.\n\nSeller records add `sellerId`, `seller`, `url`, `positivePercent`, `positiveCount`, `negativeCount`, `ratingsTotal`, `onAllegroSince`, `offersCount`, `isCompany`, `superSeller`, `company`, `location` and `categories`.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search`, `byCategory`, `bySeller`, `byUrl`, `byProduct`, `reviews` or `sellerProfiles` |\n| `searchQueries` | array | – | Keywords for `search` |\n| `categoryUrls` | array | – | Category URLs for `byCategory` |\n| `startUrls` | array | – | URLs or ids for `bySeller`, `byUrl`, `byProduct`, `reviews` and `sellerProfiles` |\n| `market` | string | `pl` | Only `pl` (allegro.pl) is supported |\n| `sortBy` | string | `relevance` | One of the nine sort orders |\n| `condition` | string | `all` | `all`, `new`, `used`, `refurbished` or `damaged` |\n| `minPrice` | integer | – | Minimum price in PLN |\n| `maxPrice` | integer | – | Maximum price in PLN |\n| `freeShippingOnly` | boolean | `false` | Apply Allegro's free-delivery filter |\n| `buyNowOnly` | boolean | `false` | Exclude auctions |\n| `superSellerOnly` | boolean | `false` | Keep Super Seller offers |\n| `includeSponsored` | boolean | `true` | Include sponsored placements |\n| `includeDetails` | boolean | `false` | Open each offer in listing modes for stock, GTIN, specs and company data |\n| `maxItems` | integer | `100` | Total records; each source is capped at 6,000 offers |\n| `maxReviewsPerProduct` | integer | `100` | Review limit per product in `reviews` mode |\n\nOld 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.\n\n## Examples\n\n### Search for new laptops under 3,000 PLN\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchQueries\": [\"laptop\"],\n  \"condition\": \"new\",\n  \"maxPrice\": 3000,\n  \"sortBy\": \"price_asc\",\n  \"maxItems\": 100\n}\n```\n\n### Browse a category with free delivery\n\n```json\n{\n  \"mode\": \"byCategory\",\n  \"categoryUrls\": [{\"url\": \"https://allegro.pl/kategoria/laptopy-491\"}],\n  \"sortBy\": \"popularity\",\n  \"freeShippingOnly\": true,\n  \"includeDetails\": true,\n  \"maxItems\": 200\n}\n```\n\n### Fetch offer and product URLs with full detail\n\n```json\n{\n  \"mode\": \"byUrl\",\n  \"startUrls\": [\n    {\"url\": \"https://allegro.pl/oferta/10828773185\"},\n    {\"url\": \"https://allegro.pl/produkt/880fe6be-3992-4532-97f2-8fd88c55889a\"}\n  ]\n}\n```\n\n### Reviews and seller profiles\n\n```json\n{\n  \"mode\": \"reviews\",\n  \"startUrls\": [{\"url\": \"https://allegro.pl/produkt/880fe6be-3992-4532-97f2-8fd88c55889a\"}],\n  \"maxReviewsPerProduct\": 100\n}\n```\n\n```json\n{\n  \"mode\": \"sellerProfiles\",\n  \"startUrls\": [{\"url\": \"https://allegro.pl/uzytkownik/ogit_pl\"}]\n}\n```\n\n## Use cases\n\n- Monitor prices, discounts and delivery costs across Allegro categories.\n- Compare every seller's price and stock for the same catalog product.\n- Build seller intelligence lists with company identity, rating and storefront size.\n- Track rank, sponsored placement and 30-day demand signals for a keyword.\n- Collect buyer reviews for sentiment, product quality and variant analysis.\n- Feed price-comparison, assortment and repricing workflows with clean records.\n\n## Limits\n\n- **Market:** Allegro.pl only. Czech and Slovak marketplaces are not available in this version.\n- **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.\n- **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.\n- **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.\n- **History:** Allegro does not publish historical price or sales charts, so the actor returns current values only.\n- **Private contact data:** only company details that sellers publish are returned. No off-platform email or phone lookup is performed.\n\n## FAQ\n\n**Do I need an Allegro account, API key, cookie or proxy?**\nNo. The actor reads public pages and manages access automatically. Nothing is required from you.\n\n**Which modes can return the most fields?**\nOffer 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.\n\n**Why are some fields missing from a record?**\nAllegro 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.\n\n**How many results can one search return?**\nUp 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.\n\n**What do `position` and `organicPosition` mean?**\n`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.\n\n**How are sponsored offers handled?**\nThey 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`.\n\n**Can I pass bare ids instead of URLs?**\nAPI 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.\n\n**Are the results deduplicated?**\nYes. Each source is deduplicated by offer id, so a repeated placement does not create a duplicate row.\n\n**Does the actor work on allegro.cz or allegro.sk?**\nNot yet. Only allegro.pl is supported, and CZ/SK URLs are rejected with a clear status message.\n\n**Is this actor affiliated with Allegro?**\nNo. It is an independent third-party tool that reads publicly available marketplace data and is not endorsed by or connected to Allegro.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "allegro-pl-listings-by-search-category-or-url",
      "title": "Allegro Scraper: Listings, Offers, Reviews & Sellers",
      "description": "Scrape Allegro.pl search results, category and seller storefronts, offer and product details, product reviews and seller profiles. Get prices, stock, GTIN, specs, company data, delivery, warranty, ranking and sales signals.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Allegro Scraper: Listings, Offers, Reviews & Sellers\n\nCollect 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.\n\nNo API key, account, cookie or proxy setup is required.\n\n## What this actor does\n\n- **Seven ways in:** keyword search, category pages, seller storefronts, direct offer/product URLs, every seller for one product, product reviews, and seller profiles.\n- **Nine sort orders:** relevance, price, price with delivery, popularity, ending soonest, newest, and product rating.\n- **Live filters:** condition, price range, Buy Now, free delivery (Smart!), Super Seller, sponsored in/out.\n- **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.\n- **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.\n- **Reviews:** star rating, text, pros and cons, photos, helpful votes, language, variant and reviewer details.\n- **Seller profiles:** recommendation percentage, positive and negative counts, total ratings, time on Allegro, storefront offer count, categories and company identity.\n- **Clean records:** empty fields are omitted at every level. No nulls, blank strings or empty objects.\n\n## Modes\n\n| Mode | What it reads | What you get |\n|---|---|---|\n| `search` | `searchQueries` | Paginated keyword results with filters and sort |\n| `byCategory` | `categoryUrls` | Category pages with filters and sort |\n| `bySeller` | `startUrls` | A seller's storefront offers |\n| `byUrl` | `startUrls` | Full detail for offer and product URLs; listing rows for product-offers URLs |\n| `byProduct` | `startUrls` | Every seller's offer for one product UUID or product URL |\n| `reviews` | `startUrls` | Buyer reviews for product UUIDs or product URLs |\n| `sellerProfiles` | `startUrls` | Seller rating summary, company identity and storefront stats |\n\n`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.\n\n## Output\n\nEvery record has a `recordType`:\n\n- `listing` for search, category, seller, product-offers and offer/product rows.\n- `review` for buyer opinions.\n- `seller` for seller profiles.\n\n### Listing and offer fields\n\n| Field | Meaning |\n|---|---|\n| `offerId` | Allegro offer identifier |\n| `title` | Offer title |\n| `url` | Canonical offer URL |\n| `price`, `currency` | Current price and currency |\n| `originalPrice`, `discountPercent` | Pre-discount price and discount when present |\n| `priceWithDelivery`, `deliveryCost`, `deliveryText` | Delivery-aware price and cheapest delivery |\n| `freeShipping`, `isSmart`, `hasFreeReturn` | Delivery perks |\n| `condition` | `new`, `used`, `refurbished` or `damaged` |\n| `seller`, `sellerId`, `sellerUrl`, `sellerRating` | Seller identity and positive-feedback percentage |\n| `sellerIsCompany`, `sellerSuperSeller`, `sellerPositiveCount`, `sellerNegativeCount` | Seller badges and feedback counts |\n| `sellerCompany` | Legal name, tax id, REGON, KRS, address and verification |\n| `imageUrl`, `images`, `thumbnail` | Product media |\n| `category`, `categoryId`, `categoryPath` | Category identity and breadcrumbs |\n| `rating`, `reviewCount` | Product rating and rating count |\n| `productId`, `productUrl`, `productOffersCount` | Catalog product and seller count |\n| `soldLast30Days` | Buyers in the last 30 days |\n| `stockQuantity`, `stockUnit`, `purchaseLimit` | Stock and order limits |\n| `brand`, `gtin` | Brand and GTIN/EAN when published |\n| `parameters` | Name/value specification pairs |\n| `description`, `warranty`, `returnPolicy` | Full text, warranty and returns |\n| `publicationStart`, `publicationEnd` | Offer publication window |\n| `location` | Seller city and country |\n| `deliveryMethods` | Delivery method, group, cost and time |\n| `position`, `organicPosition`, `page` | Overall rank, organic rank and source page |\n| `isSponsored`, `isPromoted`, `sponsoredAndOrganic` | Placement flags |\n| `recordType`, `scrapedAt` | Record kind and UTC scrape time |\n\nReview records add `reviewId`, `productId`, `productUrl`, `author`, `rating`, `ratingPercent`, `text`, `pros`, `cons`, `images`, `createdAt`, `helpfulYes`, `helpfulNo`, `language`, `sellerLogin`, `variant`, `isBest` and `productFeatures`.\n\nSeller records add `sellerId`, `seller`, `url`, `positivePercent`, `positiveCount`, `negativeCount`, `ratingsTotal`, `onAllegroSince`, `offersCount`, `isCompany`, `superSeller`, `company`, `location` and `categories`.\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search`, `byCategory`, `bySeller`, `byUrl`, `byProduct`, `reviews` or `sellerProfiles` |\n| `searchQueries` | array | – | Keywords for `search` |\n| `categoryUrls` | array | – | Category URLs for `byCategory` |\n| `startUrls` | array | – | URLs or ids for `bySeller`, `byUrl`, `byProduct`, `reviews` and `sellerProfiles` |\n| `market` | string | `pl` | Only `pl` (allegro.pl) is supported |\n| `sortBy` | string | `relevance` | One of the nine sort orders |\n| `condition` | string | `all` | `all`, `new`, `used`, `refurbished` or `damaged` |\n| `minPrice` | integer | – | Minimum price in PLN |\n| `maxPrice` | integer | – | Maximum price in PLN |\n| `freeShippingOnly` | boolean | `false` | Apply Allegro's free-delivery filter |\n| `buyNowOnly` | boolean | `false` | Exclude auctions |\n| `superSellerOnly` | boolean | `false` | Keep Super Seller offers |\n| `includeSponsored` | boolean | `true` | Include sponsored placements |\n| `includeDetails` | boolean | `false` | Open each offer in listing modes for stock, GTIN, specs and company data |\n| `maxItems` | integer | `100` | Total records; each source is capped at 6,000 offers |\n| `maxReviewsPerProduct` | integer | `100` | Review limit per product in `reviews` mode |\n\nOld 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.\n\n## Examples\n\n### Search for new laptops under 3,000 PLN\n\n```json\n{\n  \"mode\": \"search\",\n  \"searchQueries\": [\"laptop\"],\n  \"condition\": \"new\",\n  \"maxPrice\": 3000,\n  \"sortBy\": \"price_asc\",\n  \"maxItems\": 100\n}\n```\n\n### Browse a category with free delivery\n\n```json\n{\n  \"mode\": \"byCategory\",\n  \"categoryUrls\": [{\"url\": \"https://allegro.pl/kategoria/laptopy-491\"}],\n  \"sortBy\": \"popularity\",\n  \"freeShippingOnly\": true,\n  \"includeDetails\": true,\n  \"maxItems\": 200\n}\n```\n\n### Fetch offer and product URLs with full detail\n\n```json\n{\n  \"mode\": \"byUrl\",\n  \"startUrls\": [\n    {\"url\": \"https://allegro.pl/oferta/10828773185\"},\n    {\"url\": \"https://allegro.pl/produkt/880fe6be-3992-4532-97f2-8fd88c55889a\"}\n  ]\n}\n```\n\n### Reviews and seller profiles\n\n```json\n{\n  \"mode\": \"reviews\",\n  \"startUrls\": [{\"url\": \"https://allegro.pl/produkt/880fe6be-3992-4532-97f2-8fd88c55889a\"}],\n  \"maxReviewsPerProduct\": 100\n}\n```\n\n```json\n{\n  \"mode\": \"sellerProfiles\",\n  \"startUrls\": [{\"url\": \"https://allegro.pl/uzytkownik/ogit_pl\"}]\n}\n```\n\n## Use cases\n\n- Monitor prices, discounts and delivery costs across Allegro categories.\n- Compare every seller's price and stock for the same catalog product.\n- Build seller intelligence lists with company identity, rating and storefront size.\n- Track rank, sponsored placement and 30-day demand signals for a keyword.\n- Collect buyer reviews for sentiment, product quality and variant analysis.\n- Feed price-comparison, assortment and repricing workflows with clean records.\n\n## Limits\n\n- **Market:** Allegro.pl only. Czech and Slovak marketplaces are not available in this version.\n- **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.\n- **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.\n- **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.\n- **History:** Allegro does not publish historical price or sales charts, so the actor returns current values only.\n- **Private contact data:** only company details that sellers publish are returned. No off-platform email or phone lookup is performed.\n\n## FAQ\n\n**Do I need an Allegro account, API key, cookie or proxy?**\nNo. The actor reads public pages and manages access automatically. Nothing is required from you.\n\n**Which modes can return the most fields?**\nOffer 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.\n\n**Why are some fields missing from a record?**\nAllegro 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.\n\n**How many results can one search return?**\nUp 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.\n\n**What do `position` and `organicPosition` mean?**\n`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.\n\n**How are sponsored offers handled?**\nThey 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`.\n\n**Can I pass bare ids instead of URLs?**\nAPI 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.\n\n**Are the results deduplicated?**\nYes. Each source is deduplicated by offer id, so a repeated placement does not create a duplicate row.\n\n**Does the actor work on allegro.cz or allegro.sk?**\nNot yet. Only allegro.pl is supported, and CZ/SK URLs are rejected with a clear status message.\n\n**Is this actor affiliated with Allegro?**\nNo. It is an independent third-party tool that reads publicly available marketplace data and is not endorsed by or connected to Allegro.\n",
      "input": {
        "title": "Allegro Scraper Input",
        "description": "Choose what to scrape on Allegro.pl: keyword searches, category pages, seller storefronts, offer or product URLs, product reviews, or seller profiles.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "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"
            ],
            "default": "search",
            "prefill": "search"
          },
          "searchQueries": {
            "title": "Search Queries",
            "type": "array",
            "description": "Keywords to search for. One query per line. (mode=search)",
            "editor": "stringList",
            "prefill": [
              "laptop"
            ]
          },
          "categoryUrls": {
            "title": "Category URLs",
            "type": "array",
            "description": "Allegro category URLs, or category ids/aliases. (mode=byCategory)",
            "editor": "requestListSources",
            "prefill": []
          },
          "startUrls": {
            "title": "Start URLs",
            "type": "array",
            "description": "Offer, product, product-offers, seller or review target URLs. Use this for byUrl, bySeller, byProduct, reviews and sellerProfiles.",
            "editor": "requestListSources",
            "prefill": []
          },
          "market": {
            "title": "Market",
            "type": "string",
            "description": "Allegro marketplace. Only Poland (allegro.pl) is supported.",
            "editor": "select",
            "enum": [
              "pl"
            ],
            "enumTitles": [
              "Poland (allegro.pl)"
            ],
            "default": "pl",
            "prefill": "pl"
          },
          "sortBy": {
            "title": "Sort By",
            "type": "string",
            "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"
            ],
            "default": "relevance",
            "prefill": "relevance"
          },
          "condition": {
            "title": "Condition",
            "type": "string",
            "description": "Filter listings by item condition.",
            "editor": "select",
            "enum": [
              "all",
              "new",
              "used",
              "refurbished",
              "damaged"
            ],
            "enumTitles": [
              "Any condition",
              "New",
              "Used",
              "Refurbished",
              "Damaged"
            ],
            "default": "all",
            "prefill": "all"
          },
          "minPrice": {
            "title": "Minimum Price",
            "type": "integer",
            "description": "Lowest price in PLN. Leave empty for no minimum.",
            "minimum": 0,
            "maximum": 1000000
          },
          "maxPrice": {
            "title": "Maximum Price",
            "type": "integer",
            "description": "Highest price in PLN. Leave empty for no maximum.",
            "minimum": 0,
            "maximum": 1000000
          },
          "freeShippingOnly": {
            "title": "Free Delivery Only",
            "type": "boolean",
            "description": "Use Allegro's free-delivery (Smart!) filter for listing modes.",
            "default": false,
            "prefill": false
          },
          "buyNowOnly": {
            "title": "Buy Now Only",
            "type": "boolean",
            "description": "Exclude auctions and keep only offers you can buy immediately.",
            "default": false,
            "prefill": false
          },
          "superSellerOnly": {
            "title": "Super Seller Only",
            "type": "boolean",
            "description": "Keep only offers from Allegro Super Sellers.",
            "default": false,
            "prefill": false
          },
          "includeSponsored": {
            "title": "Include Sponsored Offers",
            "type": "boolean",
            "description": "Include sponsored placements in listing results. Turn off for organic results only.",
            "default": true,
            "prefill": true
          },
          "includeDetails": {
            "title": "Enrich With Offer Details",
            "type": "boolean",
            "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.",
            "default": false,
            "prefill": false
          },
          "maxItems": {
            "title": "Max Items",
            "type": "integer",
            "description": "Maximum records to return. Listing modes cap each source at 6,000 offers (100 pages).",
            "default": 100,
            "prefill": 2,
            "minimum": 1,
            "maximum": 6000
          },
          "maxReviewsPerProduct": {
            "title": "Max Reviews Per Product",
            "type": "integer",
            "description": "Maximum reviews to collect for each product in reviews mode.",
            "default": 100,
            "prefill": 100,
            "minimum": 1,
            "maximum": 1000
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Allegro Scraper Output",
        "description": "Allegro listings, offer details, buyer reviews and seller profiles with prices, delivery, stock, specs, company identity and ranking signals.",
        "properties": {
          "listings": {
            "type": "string",
            "title": "Allegro records",
            "description": "Dataset of listing, review and seller records; the recordType field tells them apart.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "defaultMemoryMbytes": 2048,
      "minMemoryMbytes": 2048,
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Allegro Records",
              "transformation": {
                "fields": [
                  "recordType",
                  "title",
                  "price",
                  "currency",
                  "condition",
                  "seller",
                  "freeShipping",
                  "rating",
                  "reviewCount",
                  "url"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.2",
    "imageDigest": "9e439f82d6c985554104b0c6499b8ea774cc8bd4018c2f7fbd1906504e6dbd9b",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.03681333333333334
    }
  }
}