{
  "openapi": "3.0.1",
  "info": {
    "title": "Allegro Scraper - Offers, Prices, Sellers & Sales Velocity",
    "description": "Scrape Allegro.pl offers by keyword, EAN, category, seller or URL: price, 30-day lowest price and discount, delivery, Smart!, seller rating, people who bought, rating and specs. Add offer details (stock, EAN, description) and seller company & contact. Monitor new offers and price drops. No login.",
    "version": "0.1",
    "x-build-id": "NYPlLfn9VqKqKe0g8"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~allegro-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-allegro-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/scrapersdelight~allegro-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-allegro-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/scrapersdelight~allegro-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-allegro-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchQueries": {
            "title": "Search keywords",
            "type": "array",
            "description": "What you would type in Allegro's search box, one per line, e.g. \"iphone 15\", \"ekspres do kawy\", \"lego technic\". Each keyword is crawled page by page (about 60 offers per page).",
            "items": {
              "type": "string"
            }
          },
          "eans": {
            "title": "EAN / GTIN barcodes",
            "type": "array",
            "description": "8-14 digit barcodes, one per line, e.g. 5901234123457. Allegro's search resolves a barcode to the offers of that product.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Allegro URLs",
            "type": "array",
            "description": "Any Allegro page from your browser (allegro.pl, .cz, .sk): a search with filters (https://allegro.pl/listing?string=rower&price_to=2000), a category (https://allegro.pl/kategoria/laptopy-491), a seller storefront (/uzytkownik/<login>), every seller of one product (/oferty-produktu/…) or one offer (/oferta/…, /produkt/…?offerId=…). A p=N page number is honoured.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "sellers": {
            "title": "Seller storefronts",
            "type": "array",
            "description": "allegro.pl seller logins (e.g. \"Kong\") or storefront URLs (https://allegro.pl/uzytkownik/Kong). Every offer in the storefront is crawled, with the filters below. On allegro.cz / .sk paste the storefront URL.",
            "items": {
              "type": "string"
            }
          },
          "offerUrls": {
            "title": "Offer URLs or ids",
            "type": "array",
            "description": "Single offers to look up: offer URLs or bare numeric offer ids, e.g. 17876662164. An offer lookup reads the offer page, so these rows always carry the offer details.",
            "items": {
              "type": "string"
            }
          },
          "marketplace": {
            "title": "Marketplace",
            "enum": [
              "pl",
              "cz",
              "sk"
            ],
            "type": "string",
            "description": "Allegro site used for keywords, barcodes and offer ids. Pasted URLs keep their own site. Prices come in that site's currency.",
            "default": "pl"
          },
          "category": {
            "title": "Category",
            "type": "string",
            "description": "Restrict keywords to one allegro.pl category: its URL or slug, e.g. https://allegro.pl/kategoria/laptopy-491 or laptopy-491. With no keyword given, the category itself is crawled. On allegro.cz / .sk paste the category URL into Allegro URLs."
          },
          "minPrice": {
            "title": "Min price",
            "minimum": 0,
            "type": "integer",
            "description": "Only offers at or above this price, in the marketplace currency (Allegro's price_from)."
          },
          "maxPrice": {
            "title": "Max price",
            "minimum": 0,
            "type": "integer",
            "description": "Only offers at or below this price, in the marketplace currency (Allegro's price_to)."
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "any",
              "new",
              "used",
              "like-new",
              "refurbished",
              "damaged"
            ],
            "type": "string",
            "description": "Allegro's condition filter (allegro.pl). \"Like new\" covers returns, ex-display and repackaged items; \"Damaged\" covers damaged, for-parts and incomplete items.",
            "default": "any"
          },
          "sort": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "price-asc",
              "price-desc",
              "price-with-delivery-asc",
              "price-with-delivery-desc",
              "popularity",
              "newest",
              "ending-soon"
            ],
            "type": "string",
            "description": "Allegro's own sort order for searches, categories and storefronts.",
            "default": "relevance"
          },
          "offerType": {
            "title": "Offer type",
            "enum": [
              "any",
              "buyNow",
              "auction"
            ],
            "type": "string",
            "description": "Buy-now offers, auctions, or both.",
            "default": "any"
          },
          "deliveryOptions": {
            "title": "Delivery benefits",
            "type": "array",
            "description": "Only offers with these benefits: Allegro Smart!, free delivery, free return.",
            "items": {
              "type": "string",
              "enum": [
                "smart",
                "freeShipping",
                "freeReturn"
              ],
              "enumTitles": [
                "Allegro Smart!",
                "Free delivery",
                "Free return"
              ]
            }
          },
          "deliveryTime": {
            "title": "Delivery time",
            "enum": [
              "any",
              "one_day",
              "two_days"
            ],
            "type": "string",
            "description": "Only offers Allegro promises to deliver by tomorrow, or by the day after.",
            "default": "any"
          },
          "superSellerOnly": {
            "title": "Super Sellers only",
            "type": "boolean",
            "description": "Only offers from Allegro Super Sellers (Super Sprzedawca).",
            "default": false
          },
          "shippingFrom": {
            "title": "Ships from",
            "type": "array",
            "description": "Only offers shipped from these places (allegro.pl).",
            "items": {
              "type": "string",
              "enum": [
                "polska",
                "czechy",
                "slowacja",
                "wegry",
                "chiny",
                "pozostale-kraje-ue",
                "magazyn-allegro"
              ],
              "enumTitles": [
                "Poland",
                "Czechia",
                "Slovakia",
                "Hungary",
                "China",
                "Other EU countries",
                "Allegro warehouse"
              ]
            }
          },
          "region": {
            "title": "Voivodeship",
            "enum": [
              "",
              "1",
              "2",
              "3",
              "4",
              "5",
              "6",
              "7",
              "8",
              "9",
              "10",
              "11",
              "12",
              "13",
              "14",
              "15",
              "16"
            ],
            "type": "string",
            "description": "Only offers located in one Polish voivodeship (allegro.pl).",
            "default": ""
          },
          "city": {
            "title": "City",
            "type": "string",
            "description": "Only offers located in this city (allegro.pl), e.g. Kraków."
          },
          "minProductRating": {
            "title": "Min product rating",
            "enum": [
              "any",
              "4.6",
              "4.8",
              "5.0"
            ],
            "type": "string",
            "description": "Only products rated at least this by buyers (Allegro's product rating filter).",
            "default": "any"
          },
          "includeSponsored": {
            "title": "Include sponsored offers",
            "type": "boolean",
            "description": "Keep Allegro's paid ad slots (sponsored: true on the row). An offer repeated on later pages is delivered once.",
            "default": true
          },
          "titleKeywords": {
            "title": "Title must contain",
            "type": "array",
            "description": "Keep only offers whose title contains at least one of these words (case-insensitive), e.g. \"128 GB\".",
            "items": {
              "type": "string"
            }
          },
          "excludeKeywords": {
            "title": "Title must not contain",
            "type": "array",
            "description": "Drop offers whose title contains any of these words, e.g. \"etui\", \"szkło\".",
            "items": {
              "type": "string"
            }
          },
          "includeDetails": {
            "title": "Offer details",
            "type": "boolean",
            "description": "Add stock, EAN/GTIN, brand, condition, full description, every parameter (grouped), all images, category path, delivery methods with prices and times, return policy, rating distribution and up to 20 product reviews.",
            "default": false
          },
          "includeSellerContact": {
            "title": "Seller company & contact",
            "type": "boolean",
            "description": "Add the seller's trader block from the offer page: company name, tax id (NIP / VAT), REGON, KRS, address, published phone and e-mail. Read once per seller and charged once per seller that publishes it.",
            "default": false
          },
          "monitorMode": {
            "title": "Only new offers and price changes",
            "type": "boolean",
            "description": "Deliver only offers not delivered by an earlier run of the same search, plus offers whose price changed (changeType new / price_drop / price_increase with previousPrice). Pairs with a daily schedule.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor memory name",
            "type": "string",
            "description": "Named key-value store that keeps the monitor memory. Use a different name to start a separate monitor.",
            "default": "allegro-scraper-monitor"
          },
          "maxItems": {
            "title": "Max offers",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Most offer rows for the whole run. Allegro shows at most 6,000 offers (100 pages) per search or category; use price ranges to go wider. 0 = up to 10,000.",
            "default": 100
          },
          "maxItemsPerQuery": {
            "title": "Max offers per keyword / URL",
            "minimum": 0,
            "type": "integer",
            "description": "Most rows from each keyword, barcode, URL or seller. 0 = no per-target limit (only Max offers applies).",
            "default": 0
          },
          "maxPagesPerQuery": {
            "title": "Max pages per keyword / URL",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Most result pages read for each target (about 60 offers each, up to 100). 0 = as many as the offer limits need.",
            "default": 0
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Core fields only (id, title, prices, seller, rating, sales, URL, and the add-on fields you pay for) - small rows for AI agents and spreadsheets.",
            "default": false
          },
          "includeRawData": {
            "title": "Include raw data",
            "type": "boolean",
            "description": "Attach Allegro's own record for each offer (raw listing element; rawOffer from the offer page when details are on). Large rows.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional: your own proxy URLs, tried first on each page. Nothing to set otherwise: the actor tries a direct request, then reaches Allegro through Apify's Unblocker by itself (Allegro's anti-bot refuses datacenter and residential IPs).",
            "default": {
              "useApifyProxy": false
            }
          },
          "maxConcurrency": {
            "title": "Parallel pages",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Pages read at the same time. Each page takes 30-90 s to come back, so parallel pages make big runs faster.",
            "default": 8
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}