{ "openapi": "3.0.1", "info": { "title": "Glovo Store & Restaurant Finder", "description": "Build a directory of Glovo merchants — restaurants, supermarkets, shops and pharmacies — with ratings, delivery and service fees, address, phone number, category and open status, for any delivery location. Bulk store URLs or automatic city discovery.", "version": "1.0", "x-build-id": "IDA4mbBFB0WcVZ8K3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/axlymxp~glovo-store-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-axlymxp-glovo-store-finder", "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/axlymxp~glovo-store-finder/runs": { "post": { "operationId": "runs-sync-axlymxp-glovo-store-finder", "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/axlymxp~glovo-store-finder/run-sync": { "post": { "operationId": "run-sync-axlymxp-glovo-store-finder", "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": { "storeUrls": { "title": "Store URLs or slugs", "type": "array", "description": "Merchants to resolve. Paste full Glovo store URLs or bare store slugs (e.g. carrefour-madrid). Each is resolved for every delivery location below and returned as one directory row.", "default": [], "items": { "type": "string" } }, "sitemapCountry": { "title": "Discover stores by country (sitemap)", "type": "string", "description": "Optional. ISO country code (e.g. ES, IT, PL) to automatically discover merchants from Glovo's public store sitemap. Combine with 'City filter' to focus on specific cities. Leave empty to only use the store URLs above." }, "sitemapCityFilter": { "title": "City filter (for sitemap discovery)", "type": "array", "description": "Optional. City slugs to keep when discovering by country (e.g. madrid, barcelona). The slug is the city segment of a Glovo store URL. Leave empty to include every city in the country.", "default": [], "items": { "type": "string" } }, "locations": { "title": "Delivery locations", "type": "array", "description": "One or more delivery points to resolve merchants for. Each item is an object with an optional 'label' and either 'latitude'+'longitude' or a 'location' string (a known city name or 'lat,lng'). A store is only returned if it serves the given point, so match your coordinates to the city you are mapping.", "default": [] }, "maxStores": { "title": "Max stores to resolve (per location)", "minimum": 1, "type": "integer", "description": "Cap on how many candidate stores are resolved per location (each is one lookup). Bounds cost/time when discovering a whole city from the sitemap.", "default": 200 }, "maxItems": { "title": "Max items (total)", "minimum": 1, "type": "integer", "description": "Global cap across all locations. The run stops once this many store rows are pushed.", "default": 1000 }, "language": { "title": "Content language", "type": "string", "description": "Language code for names/labels (e.g. en, es, it, pt, pl).", "default": "en" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. The Glovo API is not IP-gated, so proxies are usually unnecessary.", "default": { "useApifyProxy": 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 } } }, "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 } } } } } } } } } }