{
  "openapi": "3.0.1",
  "info": {
    "title": "BOX.gr Scraper — Greek Restaurants, Menus & Prices",
    "description": "Scrape BOX (box.gr), Greece's food and grocery delivery app: shops of any Greek town with ratings, fees, minimum order, hours and offers, plus full menus with EUR prices, discounts, offers and option groups. No proxy setup.",
    "version": "0.1",
    "x-build-id": "mDl5EGO5ht1q24vZf"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/teodor_banea~box-gr-restaurant-menu-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-teodor_banea-box-gr-restaurant-menu-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/teodor_banea~box-gr-restaurant-menu-scraper/runs": {
      "post": {
        "operationId": "runs-sync-teodor_banea-box-gr-restaurant-menu-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/teodor_banea~box-gr-restaurant-menu-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-teodor_banea-box-gr-restaurant-menu-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": "What to scrape",
            "enum": [
              "restaurants",
              "menus"
            ],
            "type": "string",
            "description": "Choose \"Restaurants\" for one row per shop (rating, fees, minimum order, opening hours, offers). Choose \"Full menus\" for one row per menu item with prices, discounts and option groups; a typical restaurant has 50–200 items and a supermarket several thousand, so menus multiply the result count.",
            "default": "restaurants"
          },
          "locations": {
            "title": "Locations (towns or districts)",
            "type": "array",
            "description": "Enter Greek towns or districts as BOX names them, in Greek or Latin letters, e.g. \"Larisa\", \"Λάρισα\", \"Thessaloniki\", \"Kalamaria\", \"Pagkrati\", or a 5-digit postal code. Case and accents are ignored; unknown names are listed in the log with close matches. Each location returns the shops BOX lists for it.",
            "items": {
              "type": "string"
            }
          },
          "restaurantUrls": {
            "title": "Shop URLs",
            "type": "array",
            "description": "Enter BOX shop page URLs (https://box.gr/delivery/<town>/<shop>). They are scraped in addition to the locations and always include shop details.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "vertical": {
            "title": "Shop type",
            "enum": [
              "food",
              "shops",
              "supermarket",
              "all"
            ],
            "type": "string",
            "description": "Choose which BOX section to list: restaurants and cafés, shops (mini markets, florists, butchers, pharmacies, kiosks…), supermarkets, or everything.",
            "default": "food"
          },
          "searchQuery": {
            "title": "Search shops",
            "type": "string",
            "description": "Keep only shops whose name or chain contains this text. Case and Greek accents are ignored, so \"καφε\" also finds \"Καφέ\"."
          },
          "cuisines": {
            "title": "Cuisines",
            "type": "array",
            "description": "Keep only shops with one of these cuisines, as BOX shows them in Greek or in Latin letters (e.g. \"Pizza\", \"Burger\", \"Σουβλάκια\", \"souvlakia\", \"Καφές\"). Unknown names are listed in the log with the cuisines of that location.",
            "items": {
              "type": "string"
            }
          },
          "onlyOpen": {
            "title": "Only shops open now",
            "type": "boolean",
            "description": "Keep only shops that take orders right now.",
            "default": false
          },
          "minRating": {
            "title": "Minimum rating",
            "enum": [
              "3.5",
              "4",
              "4.5"
            ],
            "type": "string",
            "description": "Keep only shops rated at least this much (0–5, decimals allowed, e.g. \"4.5\"). Shops without ratings are dropped when this is set."
          },
          "sortBy": {
            "title": "Sort shops by",
            "enum": [
              "platform",
              "rating",
              "reviews",
              "name",
              "deliveryFee",
              "minimumOrder"
            ],
            "type": "string",
            "description": "Order in which shops are taken before the limits apply. \"BOX order\" keeps the order of the BOX location page (open shops first).",
            "default": "platform"
          },
          "maxRestaurants": {
            "title": "Maximum shops per location",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Limit the shops returned (restaurants) or the shops whose menus are read (menus) for each location; your shop URLs form one more group with the same limit. 0 = no cap per location (restaurants: up to 10,000; menus: up to 2,000 shops per location). Shops with an empty menu are skipped without counting. Use Maximum results for a ceiling on the whole run.",
            "default": 50
          },
          "maxItemsPerRestaurant": {
            "title": "Maximum items per shop",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "In menus mode, keep only the first N menu items of each shop (in menu order). 0 = the whole menu. Supermarkets list thousands of products; set a number to keep runs small.",
            "default": 0
          },
          "maxItemsTotal": {
            "title": "Maximum results",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Set a hard ceiling on returned rows for the whole run, across all locations. 0 = no ceiling (still capped at 50,000 rows). The run stops at once when it is reached; locations not reached are listed in the log and the final status.",
            "default": 0
          },
          "includeModifiers": {
            "title": "Include option groups",
            "type": "boolean",
            "description": "In menus mode, add each item's option groups (sizes, extras, removals, sugar…) with option prices, and the choices of each offer. They come with the menu at no extra cost; turn off for smaller rows.",
            "default": true
          },
          "includeDetails": {
            "title": "Include shop details",
            "type": "boolean",
            "description": "In restaurants mode, also read each shop's page facts: delivery time of BOX-courier shops, preparation time, and company name, registry and VAT number for registered companies. One extra request per shop. Shop URLs always get these details.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}