{
  "openapi": "3.0.1",
  "info": {
    "title": "Zap Scraper | Prices and Store Offers",
    "description": "Zap scraper for zap.co.il (זאפ), Israel's price comparison site. Search by keyword, category, link or product ID and get the lowest and highest price in shekels, store count, rating, specs, images and every store's offer with shipping, delivery and warranty. 20 products in 5 seconds, 25 fields each.",
    "version": "1.0",
    "x-build-id": "tVPGstCms3bOpg8se"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~zap-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-zap-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/silentflow~zap-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-zap-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/silentflow~zap-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-zap-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchQueries": {
            "title": "🔎 Keywords",
            "type": "array",
            "description": "Products to look up on Zap, one per line, in English or Hebrew, as you would type them in the Zap search box: <code>iphone 17</code>, <code>dyson</code>, <code>samsung tv</code>, <code>מקרר</code>. A word that names a category (<code>מקרר</code>, fridge) reads that whole category, a model code (<code>RS70F64KET</code>) returns that product, and any other word reads Zap's search results. Each page holds 24 products.",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "🗂️ Categories",
            "type": "array",
            "description": "Whole Zap categories, by the code after <code>sog=</code> in the category address: <code>e-tv</code> (TVs), <code>e-fridge</code> (fridges), <code>e-cellphone</code> (phones), <code>c-pclaptop</code> (laptops), <code>e-airconditioner</code> (air conditioners), <code>e-vaccumcleaner</code> (vacuums). Every page of the category is read, most popular first, up to the cap below.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Zap links",
            "type": "array",
            "description": "Pages copied from zap.co.il: a category with its filters (<code>https://www.zap.co.il/models.aspx?sog=e-cellphone&db188396=1951979</code> is Apple phones), a search (<code>https://www.zap.co.il/search.aspx?keyword=dyson</code>) or a product (<code>https://www.zap.co.il/model.aspx?modelid=1270618</code>). The filters and the sort of a link are kept as you set them on Zap.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "productIds": {
            "title": "🆔 Product IDs",
            "type": "array",
            "description": "Zap product IDs, the number after <code>modelid=</code> in a product page address: <code>1270618</code> for <code>zap.co.il/model.aspx?modelid=1270618</code>. Each ID returns one row with every store's offer, whatever the filters below. Handy to track the prices of products you follow.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "🔢 Max products",
            "minimum": 1,
            "type": "integer",
            "description": "The most products the run returns, keywords, categories, links and IDs together. A product found twice counts once.",
            "default": 50
          },
          "sort": {
            "title": "↕️ Sort by",
            "enum": [
              "popular",
              "price",
              "price_desc",
              "stores",
              "rating",
              "reviews"
            ],
            "type": "string",
            "description": "The order Zap lists the results in. With a cap, it decides which products you get: <code>Price, low to high</code> returns the cheapest ones first.",
            "default": "popular"
          },
          "minPrice": {
            "title": "💰 Min price (₪)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only products whose lowest price, in shekels, is at least this amount, such as <code>1000</code>. Empty: no minimum."
          },
          "maxPrice": {
            "title": "💰 Max price (₪)",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only products whose lowest price, in shekels, is at most this amount, such as <code>3000</code>. Empty: no maximum."
          },
          "includeOffers": {
            "title": "🏪 Store offers",
            "type": "boolean",
            "description": "Add the offer of every store selling the product: store, price, shipping, total price, delivery days, new or refurbished, Eilat price, official or parallel import, warranty and who gives it, store rating and reviews, and the buy link. It also adds the highest price, the model name, the category path and all the product images. Turn it off for list prices only: much faster on big categories.",
            "default": true
          },
          "includeFullSpecs": {
            "title": "📋 Full specifications",
            "type": "boolean",
            "description": "Add the full technical sheet of every product as Zap lists it, in Hebrew: brand, series, screen, memory, weight, battery and every other line Zap has (43 lines for an iPhone, about 20 for a TV). The key specs are always there; this adds the rest. One more page per product, so runs take longer.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}