{ "openapi": "3.0.1", "info": { "title": "Multi Booking Scraper API: Airbnb, Booking.com, Vrbo & More", "description": "$5/1K. Multi booking scraper API: search Airbnb, Booking.com, Vrbo, Expedia, Hotels.com, Agoda, Google Hotels, Hostelworld & TripAdvisor for one or many cities in one run. Prices for your dates, photos, ratings, amenities, links. Hotel price tracker, STR data, MCP-ready. No login.", "version": "1.0", "x-build-id": "Q3wI9JeVD8yCVDwwN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/openclawai~hotel-rental-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-openclawai-hotel-rental-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/openclawai~hotel-rental-scraper/runs": { "post": { "operationId": "runs-sync-openclawai-hotel-rental-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/openclawai~hotel-rental-scraper/run-sync": { "post": { "operationId": "run-sync-openclawai-hotel-rental-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": { "location": { "title": "πŸ“ Location", "type": "string", "description": "City, region or area to search, e.g. 'Lisbon, Portugal', 'Tokyo', 'Tulum, Mexico'. 'City, Country' gives the most exact match on every site. Use Multiple locations below to search several places in one run." }, "locations": { "title": "πŸ—ΊοΈ Multiple locations (optional)", "maxItems": 10, "type": "array", "description": "Search several places in one run, e.g. ['Paris, France', 'Rome, Italy', 'Barcelona, Spain']. Results from every location are merged and de-duplicated; each row's searchLocation shows which place it came from. ⚠️ Cost scales with locations: 3 locations β‰ˆ 3Γ— the results. Max 10. Leave empty to use the single Location above.", "items": { "type": "string" } }, "checkIn": { "title": "πŸ“… Check-in", "type": "string", "description": "Check-in date (YYYY-MM-DD) or a relative date like '30 days' or '2 weeks' from today. Prices are for these exact dates.", "default": "30 days" }, "nights": { "title": "πŸŒ™ Nights", "minimum": 1, "maximum": 30, "type": "integer", "description": "Length of stay. Check-out = check-in + nights.", "default": 2 }, "adults": { "title": "πŸ‘₯ Adults", "minimum": 1, "maximum": 16, "type": "integer", "description": "Number of adult guests.", "default": 2 }, "minPricePerNight": { "title": "πŸ’² Min price per night", "minimum": 0, "type": "integer", "description": "Optional. Only return stays costing at least this much per night, in the selected currency." }, "maxPricePerNight": { "title": "πŸ’² Max price per night", "minimum": 0, "type": "integer", "description": "Optional. Only return stays costing at most this much per night, in the selected currency. Sites that support it filter at the source, so you still get full results; everything is double-checked and out-of-range rows are never charged." }, "sites": { "title": "🌐 Sites", "type": "array", "description": "Which sites to search. All run at the same time. Airbnb, Booking.com, Vrbo, Agoda and Hostelworld return in seconds; Tripadvisor takes up to a minute.", "items": { "type": "string", "enum": [ "airbnb", "booking", "google_hotels", "expedia", "hotels_com", "vrbo", "agoda", "hostelworld", "tripadvisor" ], "enumTitles": [ "Airbnb", "Booking.com", "Google Hotels (+ every site's price)", "Expedia", "Hotels.com", "Vrbo", "Agoda", "Hostelworld", "Tripadvisor" ] }, "default": [ "airbnb", "booking", "google_hotels", "expedia", "hotels_com", "vrbo", "agoda", "hostelworld", "tripadvisor" ] }, "maxResultsPerSite": { "title": "πŸ“Š Max results per site", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Upper limit per site (and per things-to-do source). Total results β‰ˆ this Γ— number of sites. Typical ceilings per search: Booking.com ~1,000, Agoda and Expedia/Hotels.com/Vrbo several hundred, Airbnb ~280, Google Hotels ~150, Tripadvisor ~300.", "default": 50 }, "includeThingsToDo": { "title": "🎟️ Include things to do", "type": "boolean", "description": "Also return tours, attractions and experiences for the location (Tripadvisor and Airbnb, when those sites are selected). Charged like any other result.", "default": false }, "currency": { "title": "πŸ’± Currency", "enum": [ "USD", "EUR", "GBP", "CAD", "AUD", "JPY", "CHF", "INR", "BRL", "MXN", "SGD", "HKD", "AED", "NZD", "SEK", "NOK", "DKK", "PLN", "THB", "KRW" ], "type": "string", "description": "Currency for every price in the run. Sites that only quote USD are converted at the European Central Bank daily rate; those rows keep originalCurrency and exchangeRate.", "default": "USD" } } }, "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 } } } } } } } } } }