{
  "openapi": "3.0.1",
  "info": {
    "title": "Just Eat Scraper Spain — Restaurants, Menus & Fees",
    "description": "Scrape Just Eat Spain by postal code: every restaurant with rating, deals, minimum order, delivery fees and ETA, plus the full menu and price per product for the chains you choose. No login.",
    "version": "0.1",
    "x-build-id": "BLv7Op8afOkexYVkQ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/rastriq~just-eat-spain-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-rastriq-just-eat-spain-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/rastriq~just-eat-spain-scraper/runs": {
      "post": {
        "operationId": "runs-sync-rastriq-just-eat-spain-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/rastriq~just-eat-spain-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-rastriq-just-eat-spain-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": {
          "postalCodes": {
            "title": "📍 Postal codes",
            "type": "array",
            "description": "5-digit postal codes. The listing of a code includes every restaurant delivering there, so neighbouring codes overlap.",
            "items": {
              "type": "string"
            }
          },
          "postalCodePrefixes": {
            "title": "🗺️ Postal-code prefixes",
            "type": "array",
            "description": "Every postal code starting with these digits (GeoNames table): 280 = Madrid municipality, 080 = Barcelona. Codes Just Eat does not know answer with 0 restaurants and are reported as failed in SUMMARY.",
            "items": {
              "type": "string"
            }
          },
          "chains": {
            "title": "🍔 Restaurant chains",
            "type": "array",
            "description": "Keep only these chains (matched by name) and read their menus. Empty = all restaurants, no menus unless 'Read menus' is on.",
            "items": {
              "type": "string",
              "enum": [
                "mcdonalds",
                "burger_king",
                "popeyes",
                "kfc",
                "dominos",
                "telepizza",
                "tagliatella",
                "goiko",
                "five_guys",
                "muerde_la_pasta",
                "starbucks",
                "vips",
                "fosters_hollywood",
                "ginos",
                "papa_johns",
                "subway",
                "pizza_hut",
                "santagloria",
                "sibuya",
                "manolo_bakes",
                "udon",
                "pizzerias_carlos",
                "haagen_dazs",
                "volapie",
                "tony_romas",
                "taco_bell",
                "rodilla",
                "100_montaditos",
                "tgb"
              ],
              "enumTitles": [
                "McDonald's",
                "Burger King",
                "Popeyes",
                "KFC",
                "Domino's Pizza",
                "Telepizza",
                "La Tagliatella",
                "Goiko",
                "Five Guys",
                "Muerde la Pasta",
                "Starbucks",
                "VIPS",
                "Foster's Hollywood",
                "Ginos",
                "Papa John's",
                "Subway",
                "Pizza Hut",
                "Santagloria",
                "Sibuya",
                "Manolo Bakes",
                "Udon",
                "Pizzerías Carlos",
                "Häagen-Dazs",
                "Taberna del Volapié",
                "Tony Roma's",
                "Taco Bell",
                "Rodilla",
                "100 Montaditos",
                "TGB"
              ]
            }
          },
          "uniqueNames": {
            "title": "🔗 Restaurants by Just Eat slug",
            "type": "array",
            "description": "Read these menus directly, e.g. kfcatocha (from https://www.just-eat.es/restaurants-kfcatocha). Useful with the Just Eat links that chain locators publish.",
            "items": {
              "type": "string"
            }
          },
          "fetchMenus": {
            "title": "📋 Read menus and prices",
            "type": "boolean",
            "description": "Default: on when chains or slugs are given, off otherwise. With no chain filter it reads every listed restaurant's menu (thousands of pages for a city)."
          },
          "emitAllStores": {
            "title": "🏪 Emit all restaurants",
            "type": "boolean",
            "description": "With a chain filter, still emit every listed restaurant (menus only for the chains).",
            "default": false
          },
          "maxMenus": {
            "title": "🧪 Max menus (testing)",
            "minimum": 0,
            "type": "integer",
            "description": "Cap on menus read. 0 or empty = no cap."
          },
          "requestIntervalSecs": {
            "title": "⏱️ Seconds between requests",
            "minimum": 0.5,
            "type": "number",
            "description": "Polite pacing to just-eat.es. 1 s measured without any 429 (2026-11-15).",
            "default": 1
          },
          "egressMode": {
            "title": "🌐 Network",
            "enum": [
              "auto",
              "proxy"
            ],
            "type": "string",
            "description": "Used when no proxy is set below. Just Eat answered from an Apify datacenter IP (2026-11-15); if Cloudflare starts blocking, the actor switches to its secret JUSTEAT_PROXY_URL.",
            "default": "auto"
          },
          "proxyConfiguration": {
            "title": "🛡️ Proxy (optional)",
            "type": "object",
            "description": "Optional. Your own proxy replaces the actor's built-in egress (direct first, residential proxy in Spain on a block, included in the price)."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}