{ "openapi": "3.0.1", "info": { "title": "Stay Finder: The Best Hotel or Airbnb, Reviews Read", "description": "Enter where, when and who is going. It compares every hotel and Airbnb it can find for your dates on Google Hotels and Airbnb, reads the leading stays' recent reviews for what matters to your party, and returns its picks with dated quotes and caveats and the ones to skip, as a page, PDF and data.", "version": "0.1", "x-build-id": "0VefYkcw6CYIh4nlo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zaiq~stay-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zaiq-stay-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/zaiq~stay-finder/runs": { "post": { "operationId": "runs-sync-zaiq-stay-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/zaiq~stay-finder/run-sync": { "post": { "operationId": "run-sync-zaiq-stay-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", "required": [ "destination" ], "properties": { "destination": { "title": "Where?", "type": "string", "description": "City or region with its country, for example Cape Town, South Africa." }, "checkIn": { "title": "Arrive", "type": "string", "description": "First night. Leave empty for 30 days from today." }, "checkOut": { "title": "Leave", "type": "string", "description": "Check-out day, 1 to 14 nights later. Leave empty for five nights." }, "adults": { "title": "Adults", "minimum": 1, "maximum": 12, "type": "integer", "description": "Everyone 18 or older.", "default": 2 }, "childrenAges": { "title": "Children's ages", "type": "array", "description": "One age per child, for example [7, 10].", "items": { "type": "integer" }, "default": [] }, "budget": { "title": "Budget for the stay", "minimum": 1, "type": "number", "description": "The most you want to spend on the stay for all the nights, in your currency." }, "currency": { "title": "Currency", "type": "string", "description": "Three-letter code, for example ZAR, EUR, USD or GBP.", "default": "ZAR" }, "tripStyles": { "title": "Trip style", "type": "array", "description": "Luxury favours the highest-rated stays, budget the best value, family space and quiet.", "items": { "type": "string", "enum": [ "family", "relaxing", "adrenaline", "nightlife", "romantic", "culture", "food-and-wine", "nature", "beach", "luxury", "budget" ], "enumTitles": [ "Family", "Relaxing", "Adrenaline", "Nightlife (a jol)", "Romantic", "Culture", "Food and wine", "Nature", "Beach", "Luxury", "Budget" ] }, "default": [] }, "nearPlace": { "title": "Near", "type": "string", "description": "Optional: a place you want to be close to, for example V&A Waterfront. Otherwise location is scored against the top sights." }, "mustHaves": { "title": "Must have", "type": "array", "description": "For example pool, parking, wifi, backup power. Stays that do not list them are left out.", "default": [], "items": { "type": "string" } }, "minBedrooms": { "title": "Bedrooms", "minimum": 0, "maximum": 12, "type": "integer", "description": "At least this many bedrooms.", "default": 0 }, "minBeds": { "title": "Beds", "minimum": 0, "maximum": 12, "type": "integer", "description": "At least this many beds.", "default": 0 }, "pets": { "title": "Bringing a pet", "type": "boolean", "description": "Only stays that allow pets.", "default": false }, "wheelchair": { "title": "Wheelchair user", "type": "boolean", "description": "Only stays that list step-free access.", "default": false }, "language": { "title": "Language", "type": "string", "description": "Language of the written reasons and notes.", "default": "English" } } }, "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 } } } } } } } } } }