{
  "openapi": "3.0.1",
  "info": {
    "title": "Czech E-shop Price Comparison: Alza, Datart, Smarty & more",
    "description": "Compare a product's price across 9 Czech e-shops in one run: Alza, Datart, TS Bohemia, Smarty, Planeo, Mironet, OnlineShop, Mobil Pohotovost, iSTYLE. Search, EAN, MPN or a product link; one row per product with the lowest price, price per shop, stock, monitoring, alerts. Unofficial.",
    "version": "0.0",
    "x-build-id": "mHWYtvbFyiaaHtJWf"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tsutseisoftware~czech-eshop-aggregator/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tsutseisoftware-czech-eshop-aggregator",
        "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~czech-eshop-aggregator/runs": {
      "post": {
        "operationId": "runs-sync-tsutseisoftware-czech-eshop-aggregator",
        "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~czech-eshop-aggregator/run-sync": {
      "post": {
        "operationId": "run-sync-tsutseisoftware-czech-eshop-aggregator",
        "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": {
          "shops": {
            "title": "Shops",
            "type": "array",
            "description": "Shops to read, all at the same time. Empty = the 8 general shops (all but iSTYLE.cz, which sells only Apple and costs about $0.06 per search term in list pages: add it for Apple products). Every offer pays the price of its shop's own scraper; proxies are included.",
            "items": {
              "type": "string",
              "enum": [
                "alza",
                "datart",
                "tsbohemia",
                "smarty",
                "planeo",
                "mironet",
                "onlineshop",
                "mobil-pohotovost",
                "istyle"
              ],
              "enumTitles": [
                "Alza.cz ($2.89 / 1 000)",
                "Datart.cz ($0.95, +$1.65 with details / 1 000)",
                "TSBOHEMIA.CZ ($0.95, +$0.85 with details / 1 000)",
                "Smarty.cz ($0.95, +$0.85 with details / 1 000)",
                "Planeo.cz ($0.95 / 1 000)",
                "Mironet.cz ($0.95 / 1 000)",
                "OnlineShop.cz ($1.75, +$0.75 with details / 1 000)",
                "Mobil Pohotovost ($1.75 / 1 000)",
                "iSTYLE.cz ($1.75, +$2.50 per 1 000 list requests / 1 000) – opt-in, Apple only"
              ]
            },
            "default": [
              "alza",
              "datart",
              "tsbohemia",
              "smarty",
              "planeo",
              "mironet",
              "onlineshop",
              "mobil-pohotovost"
            ]
          },
          "searchQueries": {
            "title": "Search terms",
            "type": "array",
            "description": "Searched in every shop like in its search box, e.g. \"iphone 17 256gb\", \"lg oled55\", \"rtx 5070\". At most 10. Matching across shops needs EAN or MPN, so turn on \"Add details\" for searches.",
            "items": {
              "type": "string"
            }
          },
          "eans": {
            "title": "EANs",
            "type": "array",
            "description": "EAN barcodes (check digit verified). Looked up in Datart, TS Bohemia, Smarty, Planeo, Mironet, OnlineShop, Mobil Pohotovost and iSTYLE (Alza does not show EANs: give the MPN too). One row per EAN with every shop that sells it.",
            "items": {
              "type": "string"
            }
          },
          "mpns": {
            "title": "Manufacturer part numbers (MPN)",
            "type": "array",
            "description": "MPNs, e.g. \"MG6J4SX/A\". Looked up in Alza, TS Bohemia, Mironet, Mobil Pohotovost and iSTYLE. At most 100 EANs and MPNs together.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Product or category URLs",
            "type": "array",
            "description": "Product, category or search pages of the shops above (e.g. an Alza product page). Each is read by its own shop; then the products found are looked up in the other chosen shops by their codes, so one link gives the price everywhere. Category pages: turn on \"Add details\" for matching. At most 50.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "compareStartUrls": {
            "title": "Look up the products of the URLs in the other shops",
            "type": "boolean",
            "description": "Off = only the URLs' own shops are read.",
            "default": true
          },
          "maxItems": {
            "title": "Max products",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of products saved (after matching across shops). 0 = no limit.",
            "default": 100
          },
          "maxItemsPerShop": {
            "title": "Max products per shop",
            "minimum": 0,
            "type": "integer",
            "description": "How many products each shop reads at most. 0 = its share of \"Max products\" (Max products ÷ number of shops + 20 %). With EANs or MPNs at least the number of codes.",
            "default": 0
          },
          "maxPagesPerSearch": {
            "title": "Max pages per search",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "How many result pages each shop reads per search term (up to each shop's own maximum). Empty or 0 = the shop's default. Raise it for narrow filters; pages beyond what the saved offers explain (pages thrown away by a filter, EANs and MPNs not found) pay a small fee per 1 000 (Datart $1.70, Alza $1.60, Smarty $0.70, OnlineShop $0.60, TS Bohemia $0.30, Mobil Pohotovost $0.20, Planeo and Mironet $0.10). iSTYLE.cz pays its own list pages ($0.0025 each)."
          },
          "minPrice": {
            "title": "Min price (CZK)",
            "minimum": 0,
            "type": "integer",
            "description": "Only offers from this price."
          },
          "maxPrice": {
            "title": "Max price (CZK)",
            "minimum": 0,
            "type": "integer",
            "description": "Only offers up to this price."
          },
          "onlyNew": {
            "title": "Only new goods",
            "type": "boolean",
            "description": "Leave out used, open-box (\"rozbalené\"), like-new and refurbished offers, so prices compare the same thing.",
            "default": true
          },
          "onlyInStock": {
            "title": "Only in stock",
            "type": "boolean",
            "description": "Only offers in stock.",
            "default": false
          },
          "onlyDiscounted": {
            "title": "Only discounted",
            "type": "boolean",
            "description": "Only discounted offers.",
            "default": false
          },
          "minDiscountPercent": {
            "title": "Min discount %",
            "minimum": 0,
            "maximum": 99,
            "type": "integer",
            "description": "Only offers with at least this discount."
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Only these brands, e.g. \"Apple\", \"Samsung\".",
            "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 offers whose name contains one of these words.",
            "items": {
              "type": "string"
            }
          },
          "excludeNameKeywords": {
            "title": "Exclude words in name",
            "type": "array",
            "description": "Leave out offers whose name contains one of these words (e.g. \"kryt\", \"pouzdro\").",
            "items": {
              "type": "string"
            }
          },
          "includeDetails": {
            "title": "Add details (EAN, MPN, parameters)",
            "type": "boolean",
            "description": "Open each product page for the EAN, MPN, warranty and parameters, so the same product is matched across shops. Slower; Datart +$1.65, TS Bohemia and Smarty +$0.85, OnlineShop +$0.75 per 1 000 offers with details (Alza, Planeo, Mironet, Mobil Pohotovost and iSTYLE free). EAN and MPN lookups always have them.",
            "default": false
          },
          "retryFromNewIp": {
            "title": "iSTYLE.cz: retry rejected requests from a new IP address",
            "type": "boolean",
            "description": "iSTYLE.cz sometimes answers with a verification page instead of data. On: a rejected request is repeated from a new proxy address, $0.003 per new address used (new-ip-retry). Off: iSTYLE.cz may end without products (the other shops are not affected). Nothing is solved or bypassed.",
            "default": false
          },
          "mergeProducts": {
            "title": "One row per product",
            "type": "boolean",
            "description": "Offers with the same EAN or MPN become one row with the lowest price, the price in each shop and all offers. Off = one row per offer.",
            "default": true
          },
          "onlyInSeveralShops": {
            "title": "Only products in several shops",
            "type": "boolean",
            "description": "Save only products offered by at least two shops (the price comparison). The others are not saved and pay only a small check fee (see the README).",
            "default": false
          },
          "compactOutput": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Only the comparison (name, brand, EAN, MPN, shops, lowest price and shop, price in each shop) without the offers and parameters. Smaller rows for spreadsheets, AI agents and MCP clients.",
            "default": false
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "mostShops",
              "lowestPrice",
              "highestPrice",
              "priceSpread"
            ],
            "type": "string",
            "description": "Order of the products in the dataset (before \"Max products\" is applied). Empty = most shops first; lookups keep the order of your codes."
          },
          "onlyNewOrChanged": {
            "title": "Monitoring: only new or changed products",
            "type": "boolean",
            "description": "Return only products that are new or whose lowest price, cheapest shop, shops, stock or price in a shop changed since the previous run with the same Monitoring key. Unchanged products are not saved and pay only a small check fee per offer (see the README).",
            "default": false
          },
          "monitoringKey": {
            "title": "Monitoring: key",
            "type": "string",
            "description": "Name of the remembered state; use a different key for each list you monitor."
          },
          "telegramBotToken": {
            "title": "Notifications: Telegram bot token",
            "type": "string",
            "description": "Token of your Telegram bot (from @BotFather). Used with \"Telegram chat ID\"."
          },
          "telegramChatId": {
            "title": "Notifications: Telegram chat ID",
            "type": "string",
            "description": "Chat, group or channel ID the bot writes to (e.g. -1001234567890)."
          },
          "slackWebhookUrl": {
            "title": "Notifications: Slack webhook URL",
            "type": "string",
            "description": "Incoming webhook of your Slack channel (https://hooks.slack.com/services/...)."
          },
          "discordWebhookUrl": {
            "title": "Notifications: Discord webhook URL",
            "type": "string",
            "description": "Webhook of your Discord channel (https://discord.com/api/webhooks/...). In Discord: channel settings → Integrations → Webhooks → Copy Webhook URL. Stored encrypted."
          },
          "webhookUrl": {
            "title": "Notifications: webhook URL",
            "type": "string",
            "description": "Any HTTPS URL: gets a POST with JSON {title, summary, totalSaved, runUrl, datasetUrl, items}."
          },
          "whatsappAccessToken": {
            "title": "Notifications: WhatsApp access token",
            "type": "string",
            "description": "Access token of the WhatsApp Cloud API of your Meta business account, used with \"WhatsApp phone number ID\" and \"WhatsApp recipient number\" (step by step in the README, section \"WhatsApp notifications: setup\"). For scheduled runs use a permanent token of a system user: Business settings → System users → Generate token, with the permissions whatsapp_business_messaging and whatsapp_business_management; the token of WhatsApp → API Setup expires within hours. Stored encrypted."
          },
          "whatsappPhoneNumberId": {
            "title": "Notifications: WhatsApp phone number ID",
            "type": "string",
            "description": "ID of your WhatsApp business number that sends the message (not the number itself), e.g. 106540352242922. In your Meta app: WhatsApp → API Setup → Phone number ID."
          },
          "whatsappTo": {
            "title": "Notifications: WhatsApp recipient number",
            "type": "string",
            "description": "Phone number that gets the message, in international format with the country code (e.g. +420601234567); up to 5 numbers separated by commas or new lines, each gets its own message and the notification is charged once per run. A test number of Meta sends only to numbers you added and confirmed under API Setup → To. Stored encrypted."
          },
          "whatsappTemplateName": {
            "title": "Notifications: WhatsApp template name",
            "type": "string",
            "description": "Name of your approved message template (WhatsApp Manager → Message templates, e.g. apify_results), recommended: WhatsApp delivers a template message at any time. Its body gets the run summary with the first results in {{1}} and the dataset link in {{2}} (a template with only {{1}} gets both in {{1}}). Empty: a plain text message, which WhatsApp delivers only when the recipient wrote to your business number in the last 24 hours, so a scheduled run usually needs a template. Meta charges your business account for template messages (step by step in the README, section \"WhatsApp notifications: setup\")."
          },
          "whatsappTemplateLanguage": {
            "title": "Notifications: WhatsApp template language",
            "type": "string",
            "description": "Language code of the template exactly as WhatsApp Manager → Message templates shows it next to the template, e.g. en_US, en_GB, cs, sk, pl or de. Used only with \"WhatsApp template name\".",
            "default": "en_US"
          },
          "notificationLimit": {
            "title": "Notifications: max products per message",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "How many products are listed in one notification (the rest as \"…and N more\").",
            "default": 10
          },
          "notifyOnlyChanges": {
            "title": "Notifications: only when something was saved",
            "type": "boolean",
            "description": "Send nothing when the run saved no product (e.g. a monitoring run without changes).",
            "default": true
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}