{
  "openapi": "3.0.1",
  "info": {
    "title": "Allegro Scraper",
    "description": "Look up Allegro products by EAN/GTIN and get every seller offering them - price, seller login, Super Seller status, feedback score and delivery. Built for MAP monitoring, repricing and distributor research. Also scrapes keyword and category listings across allegro.pl, .cz and .sk.",
    "version": "0.0",
    "x-build-id": "FsLV3TcsJMr3ezXdz"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/unfenced-group~allegro-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-unfenced-group-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/unfenced-group~allegro-scraper/runs": {
      "post": {
        "operationId": "runs-sync-unfenced-group-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/unfenced-group~allegro-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-unfenced-group-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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "ean",
              "product",
              "seller"
            ],
            "type": "string",
            "description": "What to scrape. 'search' returns product listings for a keyword or category. 'ean' takes a list of EAN/GTIN codes and resolves each to its Allegro product. 'product' takes Allegro /produkt/ URLs directly. 'seller' scrapes a seller's whole storefront catalogue. 'ean' and 'product' can expand into every seller's offer via Fetch seller offers.",
            "default": "search"
          },
          "searchQueries": {
            "title": "Search queries",
            "type": "array",
            "description": "Keywords to search for on Allegro. One search per keyword. Used in 'search' mode. Example: [\"iphone 15\", \"macbook air m3\"].",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "eans": {
            "title": "EAN / GTIN codes",
            "type": "array",
            "description": "Barcode (EAN-13 / GTIN) codes to look up. Each code is resolved to its Allegro product page. Used in 'ean' mode - the standard input for brand MAP monitoring and repricing. Example: [\"0195949035982\"].",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "productUrls": {
            "title": "Product URLs",
            "type": "array",
            "description": "Allegro product page URLs (https://allegro.pl/produkt/...). Used in 'product' mode. Example: [\"https://allegro.pl/produkt/smartfon-apple-iphone-15-6-gb-128-gb-5g-czarny-2c471a7b-e083-42cc-b811-faffef64ef77\"].",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "sellerUrls": {
            "title": "Seller storefronts",
            "type": "array",
            "description": "Seller storefront URLs or logins to scrape in full. Used in 'seller' mode. Accepts a full URL (https://allegro.pl/uzytkownik/SellerLogin) or a bare seller login. Example: [\"https://allegro.pl/uzytkownik/rtv_euro_agd\"].",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "fetchOffers": {
            "title": "Fetch seller offers",
            "type": "boolean",
            "description": "For each resolved product, return every seller's offer: seller login, price, Super Seller status, feedback score and delivery. This is how you see who is undercutting your RRP. Applies to 'ean' and 'product' modes.",
            "default": false
          },
          "maxOffersPerProduct": {
            "title": "Max seller offers per product",
            "minimum": 1,
            "type": "integer",
            "description": "Cap on seller offers returned per product. Popular products can have 150+ sellers. Example: 50.",
            "default": 100
          },
          "fetchProductDetails": {
            "title": "Fetch product details",
            "type": "boolean",
            "description": "Fetch each product's page for EAN, manufacturer part number (MPN) and the full specification table. Costs one extra request per product. Not needed in 'ean' mode unless you want the MPN and specs.",
            "default": false
          },
          "market": {
            "title": "Marketplace",
            "enum": [
              "pl",
              "cz",
              "sk"
            ],
            "type": "string",
            "description": "Which Allegro marketplace to scrape. PL supports global keyword search. CZ and SK require a category slug.",
            "default": "pl"
          },
          "category": {
            "title": "Category slug",
            "type": "string",
            "description": "Restrict a search to one category. Required for the CZ and SK markets, optional for PL. Example: smartfony-165 (PL) or telefony-a-prislusenstvi-4 (CZ).",
            "default": ""
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of products to return. Seller offers are capped separately by Max seller offers per product. Example: 100.",
            "default": 100
          },
          "sortBy": {
            "title": "Sort order",
            "enum": [
              "relevance",
              "p",
              "pd",
              "qd",
              "m"
            ],
            "type": "string",
            "description": "Ordering of search results. Applies to 'search' mode.",
            "default": "relevance"
          },
          "startUrls": {
            "title": "Start URLs",
            "type": "array",
            "description": "Allegro listing or category URLs to scrape directly, instead of building them from a keyword. Applies to 'search' mode.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "integer",
            "description": "Only return products at or above this price, in the marketplace's currency (PLN, CZK or EUR). Example: 500."
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "integer",
            "description": "Only return products at or below this price, in the marketplace's currency. Example: 3000."
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "all",
              "new",
              "used"
            ],
            "type": "string",
            "description": "Filter results by item condition. 'new' returns only new items, 'used' only used/refurbished items, 'all' returns both. Applies to 'search' and 'seller' modes and to seller offers.",
            "default": "all"
          },
          "freeDeliveryOnly": {
            "title": "Free delivery only",
            "type": "boolean",
            "description": "Only return products or offers that include free delivery.",
            "default": false
          },
          "superSellerOnly": {
            "title": "Super Seller only",
            "type": "boolean",
            "description": "Only return products or offers from Allegro Super Sellers (the platform's verified high-rating merchants).",
            "default": false
          }
        }
      },
      "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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}