{ "openapi": "3.0.1", "info": { "title": "Rappi Scraper: Colombia Restaurants, Menus & Prices API", "description": "Scrape Rappi Colombia restaurants, stores and full menus. Extract store name, cuisine, rating, reviews, delivery time and fee, address, geo, promotions plus menu items with price, discount, description and image. Search by city, category or query. Export JSON, CSV, Excel.", "version": "0.1", "x-build-id": "ajWTPeZGD6GFQCUoW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapers_lat~rappi-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapers_lat-rappi-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/scrapers_lat~rappi-scraper/runs": { "post": { "operationId": "runs-sync-scrapers_lat-rappi-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/scrapers_lat~rappi-scraper/run-sync": { "post": { "operationId": "run-sync-scrapers_lat-rappi-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", "required": [ "country" ], "properties": { "maxStores": { "title": "Max Stores", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Maximum number of stores to collect. Optional." }, "withDetails": { "title": "With Details (menu, hours)", "type": "boolean", "description": "When enabled, each store is enriched with its full menu (products with name, price, description, image) and opening hours. Slower.", "default": true }, "query": { "title": "Search query", "type": "string", "description": "Optional. Free-text search matched against each store's name, brand and cuisine tags (e.g. 'sushi', 'mcdonalds', 'vegano'). Combine with city/category to narrow results." }, "startUrl": { "title": "Store URL or ID", "type": "string", "description": "Optional. A single Rappi restaurant/store page URL (e.g. https://www.rappi.com.co/restaurantes/delivery/121-empanaditas) or a bare numeric store ID. When set, only that store is scraped. Leave empty to scrape a city listing." }, "country": { "title": "Country", "enum": [ "CO" ], "type": "string", "description": "Rappi country to scrape. Determines the domain, language and proxy country.", "default": "CO" }, "city": { "title": "City", "enum": [ "Bogotá", "Medellín", "Cali", "Barranquilla" ], "type": "string", "description": "City to scrape within Colombia.", "default": "Bogotá" }, "freeDeliveryOnly": { "title": "Free delivery only", "type": "boolean", "description": "Optional. When enabled, only stores with a $0 delivery fee are returned.", "default": false }, "primeOnly": { "title": "Rappi Prime exclusives only", "type": "boolean", "description": "Optional. When enabled, only stores advertising a Rappi Prime / prime-exclusive offer are returned.", "default": false }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Optional. Only return stores with a rating score at or above this value (e.g. 4.5)." }, "category": { "title": "Category", "type": "string", "description": "Optional. Filter stores by cuisine category name, e.g. Hamburguesa, Pizza, Sushi, Pollo, Saludable, Desayunos. Matched against each store's category tags." } } }, "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 } } } } } } } } } }