{
  "openapi": "3.0.1",
  "info": {
    "title": "iSTYLE.cz Scraper ($1.75/1K): Apple Prices, EAN & Stock",
    "description": "Scrape iSTYLE.cz (Apple Premium Reseller, Czech Republic) by collection, search, EAN, part number or product URL: price, discount, stock, EAN, Apple part number, open-box and refurbished offers. Filters, monitoring. Unofficial.",
    "version": "0.0",
    "x-build-id": "lApXP6mzxfTwL8ktb"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/tsutseisoftware~istyle-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-tsutseisoftware-istyle-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~istyle-scraper/runs": {
      "post": {
        "operationId": "runs-sync-tsutseisoftware-istyle-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~istyle-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-tsutseisoftware-istyle-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": "Collection, search or product URLs",
            "type": "array",
            "description": "iSTYLE.cz URLs: a collection (e.g. https://istyle.cz/collections/apl-ps-iphone-17-pro, https://istyle.cz/collections/rozbaleny-iphone for open-box iPhones, https://istyle.cz/collections/all for the whole catalogue), search results (https://istyle.cz/search?q=airpods) or a product (https://istyle.cz/products/iphone-17-pro-mg8g4sx-a). Landing pages (/pages/…) are not product lists: use search terms for 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": "Searches the whole catalogue (name, type, brand, SKU or tags, accents ignored, about a minute for any number of terms). Devices come first (e.g. \"iPhone 17 Pro\"), then accessories (cases, straps). Up to 20 terms per run.",
            "items": {
              "type": "string"
            }
          },
          "eans": {
            "title": "EANs",
            "type": "array",
            "description": "EAN / UPC barcodes (check digit verified), e.g. 195951415680. Only an exact match is returned. New products are preferred over open-box ones with the same EAN.",
            "items": {
              "type": "string"
            }
          },
          "mpns": {
            "title": "MPNs (Apple part numbers)",
            "type": "array",
            "description": "Manufacturer part numbers, e.g. MJRR4SX/A or the model alone MJRR4 (another region suffix such as MJRR4CZ/A finds the same model). Only an exact model match is returned.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max products",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of products saved (and charged) in total. 0 = no limit.",
            "default": 100
          },
          "maxItemsPerStartUrl": {
            "title": "Max products per URL",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of products from each start URL or search term (and from all EANs or all MPNs). 0 = no limit.",
            "default": 0
          },
          "includeDetails": {
            "title": "Add EAN (barcode)",
            "type": "boolean",
            "description": "Adds the EAN to listed products. Slower: about 50 minutes per 1 000 products instead of about a minute for the whole catalogue. Lookups by EAN or MPN and product URLs always include the EAN.",
            "default": false
          },
          "descriptionFormat": {
            "title": "Description",
            "enum": [
              "short",
              "text",
              "html",
              "markdown"
            ],
            "type": "string",
            "description": "How the product description is saved. No format costs more or slows the run.",
            "default": "short"
          },
          "retryFromNewIp": {
            "title": "Retry rejected requests from a new IP address (on by default, $0.003 per new address)",
            "type": "boolean",
            "description": "On by default. iSTYLE.cz sometimes answers with a verification page instead of data, even to residential proxies. On: a rejected request is repeated from a new proxy address, $0.003 per new address used, nothing when the shop answers normally; it never solves the verification and keeps the same pace. A short run usually costs $0-0.003 extra; the most we measured was $0.054. Your maximum cost per run is respected. Off: a few cents cheaper, but the run may stop early. Needs a proxy (the default one is fine).",
            "default": true
          },
          "onlyInStock": {
            "title": "Only in stock",
            "type": "boolean",
            "description": "Only products the shop shows as \"Skladem\".",
            "default": false
          },
          "onlyDiscounted": {
            "title": "Only discounted",
            "type": "boolean",
            "description": "Only products with a crossed-out price.",
            "default": false
          },
          "minDiscountPercent": {
            "title": "Min discount (%)",
            "minimum": 0,
            "type": "integer",
            "description": "Only products with at least this discount."
          },
          "minPrice": {
            "title": "Min price (CZK)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest price incl. VAT."
          },
          "maxPrice": {
            "title": "Max price (CZK)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest price incl. VAT."
          },
          "brands": {
            "title": "Brands",
            "type": "array",
            "description": "Only these brands (the shop's vendor), e.g. Apple, Epico, Spigen, JBL. Case and diacritics are ignored.",
            "items": {
              "type": "string"
            }
          },
          "excludeBrands": {
            "title": "Exclude brands",
            "type": "array",
            "description": "Never these brands.",
            "items": {
              "type": "string"
            }
          },
          "nameKeywords": {
            "title": "Name must contain",
            "type": "array",
            "description": "Any of these words (case and diacritics ignored), e.g. \"256 GB\".",
            "items": {
              "type": "string"
            }
          },
          "excludeNameKeywords": {
            "title": "Name must not contain",
            "type": "array",
            "description": "None of these words (case and diacritics ignored), e.g. \"kryt\".",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "Categories (product types)",
            "type": "array",
            "description": "Only products whose category (the shop's product type, the `category` field) contains one of these texts, e.g. \"iPhone 17 Pro\", \"MacBook\", \"Obaly a kryty\". Case and diacritics are ignored.",
            "items": {
              "type": "string"
            }
          },
          "publishedWithinDays": {
            "title": "Added in the last N days",
            "minimum": 0,
            "type": "integer",
            "description": "Only products the shop published in the last N days (the `publishedAt` field), e.g. 7 for this week's new products. 0 or empty = any time."
          },
          "tags": {
            "title": "Tags",
            "type": "array",
            "description": "Only products with at least one of these shop tags (the `tags` field), e.g. \"NPI\" (new product introductions), \"BASE-PRODUCT\". Whole tag, case and diacritics ignored.",
            "items": {
              "type": "string"
            }
          },
          "updatedSince": {
            "title": "Updated since",
            "type": "string",
            "description": "Only products the shop changed since a date (2026-11-01) or within a period (24 hours, 7 days, 2 weeks), by the `updatedAt` field of the shop's lists. Products read one by one (EANs, MPNs, product URLs) have no update time and pass."
          },
          "excludeUsedOrOpenBox": {
            "title": "Only new (no open-box or refurbished)",
            "type": "boolean",
            "description": "Drops open-box (\"otevřený\") and refurbished (\"renovovaný\") offers.",
            "default": false
          },
          "onlyUsedOrOpenBox": {
            "title": "Only open-box or refurbished",
            "type": "boolean",
            "description": "Only open-box (\"otevřený\") and refurbished (\"renovovaný\") offers, which are usually cheaper.",
            "default": false
          },
          "onlyNewOrChanged": {
            "title": "Monitoring: only new or changed products",
            "type": "boolean",
            "description": "Saves (and charges) only products that are new or whose price, crossed-out price or availability changed since the previous run with the same monitoring key. Ideal for scheduled runs.",
            "default": false
          },
          "monitoringKey": {
            "title": "Monitoring key",
            "type": "string",
            "description": "Name of the saved state. Use a different key for each tracked list. Empty = \"default\". The value is stored encrypted."
          },
          "onlyPriceChanges": {
            "title": "Monitoring: only price changes",
            "type": "boolean",
            "description": "Of the changed products, only those whose price changed (new products are still saved).",
            "default": false
          },
          "minPriceDropPercent": {
            "title": "Monitoring: min price drop (%)",
            "minimum": 0,
            "type": "number",
            "description": "Only products whose price fell by at least this many percent since the previous run."
          },
          "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
          },
          "slackWebhookUrl": {
            "title": "Notifications: Slack webhook URL",
            "type": "string",
            "description": "Incoming webhook of your Slack channel (https://hooks.slack.com/services/...). Stored encrypted."
          },
          "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."
          },
          "telegramBotToken": {
            "title": "Notifications: Telegram bot token",
            "type": "string",
            "description": "Token of your Telegram bot (from @BotFather). Used with \"Telegram chat ID\". Stored encrypted."
          },
          "telegramChatId": {
            "title": "Notifications: Telegram chat ID",
            "type": "string",
            "description": "Chat, group or channel ID the bot writes to (e.g. -1001234567890)."
          },
          "webhookUrl": {
            "title": "Notifications: webhook URL",
            "type": "string",
            "description": "Any HTTPS URL (Zapier, Make, n8n, your server): 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
          },
          "maxPagesPerCategory": {
            "title": "Max pages per collection",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Pages of up to 250 products read per collection (40 = 10 000 products, more than the whole catalogue).",
            "default": 40
          },
          "maxSearchPages": {
            "title": "Max catalogue pages for searches",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "How much of the catalogue search terms (and many MPNs) search, in pages of up to 250 products, newest products first. 40 covers the whole catalogue; a lower number searches only the newer part.",
            "default": 40
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "iSTYLE.cz needs a residential proxy. The default is Apify Proxy with residential IPs in the Czech Republic, included in the price. Even residential addresses are sometimes rejected: see \"Retry rejected requests from a new IP address\". 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}