{
  "openapi": "3.0.1",
  "info": {
    "title": "Glovo Scraper Spain — Menu Prices, Fees & Stores",
    "description": "Scrape Glovo Spain: every store of the restaurant chains you choose in Madrid or Barcelona, with delivery fee, service fee, rating, promotions and the price of each menu product per store. No login.",
    "version": "0.1",
    "x-build-id": "GsMbXeOUJuc3yvmri"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/rastriq~glovo-spain-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-rastriq-glovo-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~glovo-spain-scraper/runs": {
      "post": {
        "operationId": "runs-sync-rastriq-glovo-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~glovo-spain-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-rastriq-glovo-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": {
          "cities": {
            "title": "🏙️ Cities",
            "type": "array",
            "description": "Cities with a verified Glovo city code and bounding box.",
            "items": {
              "type": "string",
              "enum": [
                "MAD",
                "BCN"
              ],
              "enumTitles": [
                "Madrid",
                "Barcelona"
              ]
            }
          },
          "chains": {
            "title": "🍔 Restaurant chains",
            "type": "array",
            "description": "Chains to sweep, from the built-in slug table. Empty = every chain in the table for the city.",
            "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"
              ]
            }
          },
          "extraSlugs": {
            "title": "➕ Extra Glovo stores",
            "type": "array",
            "description": "More Glovo stores as CITY:slug, e.g. MAD:vips-desayunos-madrid (the slug is in the store URL glovoapp.com/es/es/madrid/{slug}/).",
            "items": {
              "type": "string"
            }
          },
          "coarseStepKm": {
            "title": "🗺️ Coarse grid step (km)",
            "minimum": 0.25,
            "type": "number",
            "description": "First pass over the whole city.",
            "default": 2
          },
          "fineStepKm": {
            "title": "🔍 Fine grid step (km)",
            "minimum": 0,
            "type": "number",
            "description": "Second pass, only in coarse cells served by the chain or next to one. 0 = coarse only.",
            "default": 0.5
          },
          "fetchMenus": {
            "title": "📋 Read menus and prices",
            "type": "boolean",
            "description": "Read the menu of each store found.",
            "default": true
          },
          "maxMenus": {
            "title": "🧪 Max menus (testing)",
            "minimum": 0,
            "type": "integer",
            "description": "0 or empty = all. Prefilled at 1 for a quick sample run; clear it to read every store's menu."
          },
          "maxPointsPerSlug": {
            "title": "🧪 Max points per chain (testing)",
            "minimum": 0,
            "type": "integer",
            "description": "0 or empty = no cap. A capped sweep is reported as capped. Prefilled at 50 for a quick sample run; clear it for the full city sweep."
          },
          "requestIntervalSecs": {
            "title": "⏱️ Seconds between requests",
            "minimum": 0.5,
            "type": "number",
            "description": "Pacing to api.glovoapp.com.",
            "default": 0.5
          },
          "menuIntervalSecs": {
            "title": "⏱️ Seconds between menu requests",
            "minimum": 1,
            "type": "number",
            "description": "Menus are throttled separately by Glovo: at 0.5 s, 429 errors started after about 25 menus.",
            "default": 1.5
          },
          "egressMode": {
            "title": "🌐 Network",
            "enum": [
              "auto",
              "proxy"
            ],
            "type": "string",
            "description": "Used when no proxy is set below. Glovo blocks datacenter IPs after about a minute, so by default the actor starts direct and switches to its own residential proxy in Spain (included in the price) on the first block.",
            "default": "auto"
          },
          "proxyConfiguration": {
            "title": "🛡️ Proxy (optional)",
            "type": "object",
            "description": "Optional. Your own proxy replaces the actor's built-in residential proxy."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}