{ "openapi": "3.0.1", "info": { "title": "Despegar Hotels Scraper", "description": "Extract hotel listings from Despegar with prices, ratings, reviews, locations, amenities, room types, availability, images, and booking URLs. Ideal for hotel price monitoring, travel market research, competitor analysis, tourism insights, and hospitality datasets.", "version": "0.0", "x-build-id": "oSTJtFfmMk0zescIV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~Despegar-Hotels-Scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-Despegar-Hotels-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/shahidirfan~Despegar-Hotels-Scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-Despegar-Hotels-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/shahidirfan~Despegar-Hotels-Scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-Despegar-Hotels-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": { "startUrls": { "title": "Destination URLs", "type": "array", "description": "Despegar / Decolar destination listing URLs from any regional domain. Example: https://www.us.despegar.com/accommodations/accommodations-in-new+york/5227. When provided, these take priority over the Location field.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "A destination name such as \"New York\" or \"Buenos Aires\", a numeric destination ID, or a destination URL. Used when no Destination URLs are supplied.", "default": "New York" }, "domain": { "title": "Market domain", "type": "string", "description": "Regional Despegar / Decolar domain used to resolve the Location, for example www.us.despegar.com, www.despegar.com.ar, www.despegar.com.mx or www.decolar.com.", "default": "www.us.despegar.com" }, "stars": { "title": "Star ratings", "type": "array", "description": "Optional. Restrict hotels to the selected star ratings. Leave empty to collect every hotel the destination lists.", "items": { "type": "string", "enum": [ "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ] } }, "minRating": { "title": "Minimum guest rating", "minimum": 0, "maximum": 10, "type": "number", "description": "Optional. Only keep hotels whose guest rating (0-10) is at least this value." }, "sortBy": { "title": "Sort hotels by", "enum": [ "relevance", "rating_desc", "stars_desc", "price_asc", "price_desc" ], "type": "string", "description": "Order in which hotels are saved.", "default": "relevance" }, "results_wanted": { "title": "Maximum hotels", "minimum": 1, "type": "integer", "description": "Maximum number of hotels to save across all destinations. Raise it to collect everything a destination lists.", "default": 20 }, "max_pages": { "title": "Maximum listing pages per destination", "minimum": 1, "type": "integer", "description": "Safety cap on how many listing pages are requested per destination. The standard page is used first and each star class adds one more page.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Destination pages are public, so a proxy is usually not required. Use Apify Proxy if you scrape many destinations.", "default": {} } } }, "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 } } } } } } } } } }