{
  "openapi": "3.0.1",
  "info": {
    "title": "OnlineShop.cz Scraper ($1.75/1K): Prices, EAN & Monitoring",
    "description": "Scrape OnlineShop.cz (Czech electronics and home appliance e-shop) by category, brand, search or EAN: price with the discount code, regular price, lowest price in 30 days, stock, EAN, rating and specifications. Monitoring returns only changed or removed products. Unofficial.",
    "version": "0.0",
    "x-build-id": "ivUbNpYdKnK4II78F"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tsutseisoftware~onlineshop-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tsutseisoftware-onlineshop-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/tsutseisoftware~onlineshop-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tsutseisoftware-onlineshop-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/tsutseisoftware~onlineshop-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tsutseisoftware-onlineshop-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": {
          "startUrls": {
            "title": "Category, brand, search or product URLs",
            "type": "array",
            "description": "OnlineShop.cz category URLs (e.g. https://www.onlineshop.cz/americke-lednice/), category overviews (https://www.onlineshop.cz/elektronika/, its categories are read one after another), brand pages (https://www.onlineshop.cz/xiaomi/), sale sections (https://www.onlineshop.cz/vyprodej/, /bazar/ for unpacked goods), search URLs (https://www.onlineshop.cz/vyhledavani/?q=...) or product URLs. Tip: set filters and sorting on the website and paste the URL; the actor keeps them.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "searchQueries": {
            "title": "Search terms",
            "type": "array",
            "description": "Words to search for on OnlineShop.cz, e.g. \"iphone 17\". The website shows up to about 60-70 results per search; when it opens a category instead (e.g. \"lednice\"), that category is read up to \"Max pages per search\". At most 20 terms.",
            "items": {
              "type": "string"
            }
          },
          "eans": {
            "title": "EANs",
            "type": "array",
            "description": "Your own list of EANs (barcodes). Each one is confirmed on the product page (rows with matchedBy \"ean\", the product page data included; when the website rejects that page, the only product its search finds is returned with its listing data). Each product found is charged as \"Product lookup\" ($0.80 per 1 000, see the Pricing tab) instead of \"Product details\"; EANs not sold on OnlineShop.cz cost nothing and are listed in the status message. At most 1 000 per run.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max products",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of products saved. You pay per saved product. 0 = no limit.",
            "default": 100
          },
          "maxItemsPerStartUrl": {
            "title": "Max products per URL",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of products from each start URL, search term or the EAN list (0 = no limit). Useful with several categories in one run.",
            "default": 0
          },
          "includeDetails": {
            "title": "Include details (product page, extra charge)",
            "type": "boolean",
            "description": "Also reads each product page: all technical parameters, description, MPN (when given) and the EAN and category for search results. Charged as \"Product details\" ($0.75 per 1 000 products with a product page, see the Pricing tab). Rows from categories already include the EAN, price, stock, rating and energy class without it.",
            "default": false
          },
          "descriptionMaxLength": {
            "title": "Description length",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum length of the product description (with details). 0 = no description.",
            "default": 1000
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "default",
              "popular",
              "price-asc",
              "price-desc",
              "rating"
            ],
            "type": "string",
            "description": "Order of listing pages (the website's own sorting). With a price filter, \"Cheapest first\" reads fewer pages.",
            "default": "default"
          },
          "onlyInStock": {
            "title": "Only in stock",
            "type": "boolean",
            "description": "Only products in stock (\"Skladem\").",
            "default": false
          },
          "onlyDiscounted": {
            "title": "Only discounted",
            "type": "boolean",
            "description": "Only products with a real discount: a price lower than the lowest price of the last 30 days (as the website shows it, EU Omnibus), including discount-code prices.",
            "default": false
          },
          "minDiscountPercent": {
            "title": "Min discount (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Only products with at least this discount (against the 30-day low, as the website shows it)."
          },
          "minPrice": {
            "title": "Min price (CZK)",
            "minimum": 0,
            "type": "integer",
            "description": "Only products with at least this price (incl. VAT, with the discount code)."
          },
          "maxPrice": {
            "title": "Max price (CZK)",
            "minimum": 0,
            "type": "integer",
            "description": "Only products with at most this price."
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Only these brands, e.g. Samsung, Hisense (case and diacritics don't matter). In a category with more than one page, the website's brand filter is used.",
            "items": {
              "type": "string"
            }
          },
          "excludeBrands": {
            "title": "Exclude brands",
            "type": "array",
            "description": "Leave out these brands.",
            "items": {
              "type": "string"
            }
          },
          "nameKeywords": {
            "title": "Name must contain",
            "type": "array",
            "description": "Only products whose name contains at least one of these words.",
            "items": {
              "type": "string"
            }
          },
          "excludeNameKeywords": {
            "title": "Name must not contain",
            "type": "array",
            "description": "Leave out products whose name contains any of these words (e.g. kryt, obal for accessories).",
            "items": {
              "type": "string"
            }
          },
          "excludeUsedOrOpenBox": {
            "title": "Exclude used and open-box products",
            "type": "boolean",
            "description": "Leave out unpacked, returned and used goods (the website's \"Rozbaleno\" offers).",
            "default": false
          },
          "onlyNewOrChanged": {
            "title": "Monitoring: only new or changed products",
            "type": "boolean",
            "description": "Return (and pay for) only products that are new or whose price, regular price or availability changed since the previous run with the same monitoring key. Ideal for scheduled price monitoring. Unchanged products are free; each listing page read to check them is charged as \"Monitoring page\" ($0.60 per 1 000 pages of 24 products, see the Pricing tab).",
            "default": false
          },
          "monitoringKey": {
            "title": "Monitoring key",
            "type": "string",
            "description": "Name of the saved monitoring state. Use a different key for each set of categories you monitor. Empty = \"default\". The value is stored encrypted."
          },
          "onlyPriceChanges": {
            "title": "Monitoring: only price changes",
            "type": "boolean",
            "description": "Of the changed products, return only those whose price changed (new products are still returned).",
            "default": false
          },
          "minPriceDropPercent": {
            "title": "Monitoring: min price drop (%)",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Return only products whose price dropped by at least this many percent since the previous run (price drop alerts)."
          },
          "includeRemovedProducts": {
            "title": "Monitoring: include removed products",
            "type": "boolean",
            "description": "Adds rows with changeType \"removed\" for products that disappeared since the previous run (only after a run that read everything) and \"reappeared\" when they are back.",
            "default": false
          },
          "fastMode": {
            "title": "Fast mode (small extra charge)",
            "type": "boolean",
            "description": "Fast mode reads up to about 3x faster and drops back to the normal speed for the rest of the run at the first sign of load. It never changes IP address to get around a limit. Extra charge \"Fast mode\" ($0.01 per 1 000 products, see the Pricing tab) only for products saved while the fast speed was on.",
            "default": false
          },
          "maxPagesPerCategory": {
            "title": "Max pages per category",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Maximum listing pages read from each category or brand URL (24 products per page).",
            "default": 50
          },
          "maxSearchPages": {
            "title": "Max pages per search",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Maximum pages read per search term. A real search shows all its results (up to about 60-70) on one page; this matters when the website opens a category for the search term.",
            "default": 2
          },
          "maxRequestsPerMinute": {
            "title": "Max requests per minute",
            "minimum": 1,
            "maximum": 60,
            "type": "integer",
            "description": "Speed limit at the normal speed (all requests together).",
            "default": 30
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "OnlineShop.cz needs a residential proxy. It is set by default and its cost is included in the price. You can also use your own proxies.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "CZ"
            }
          },
          "sendErrorReports": {
            "title": "Send error reports",
            "type": "boolean",
            "description": "When a run fails, send the developer a short error report: the error and your input with secrets left out (tokens, webhooks and e-mails are hidden). Your results are never sent. Reports are deleted after at most 120 hours. Turn off to send nothing.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}