{ "openapi": "3.0.1", "info": { "title": "Booking & Airbnb Scraper & Comparator", "description": "Scrapes and compares accommodation offers from Airbnb and Booking.com to find the best value stays based on price, rating, and location. Normalizes data, calculates a stay score, and returns the best rental options for given dates and city.", "version": "0.0", "x-build-id": "rmI2d9SYsJe6H1Df4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pengwius~booking-airbnb-scraper-comparator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pengwius-booking-airbnb-scraper-comparator", "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/pengwius~booking-airbnb-scraper-comparator/runs": { "post": { "operationId": "runs-sync-pengwius-booking-airbnb-scraper-comparator", "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/pengwius~booking-airbnb-scraper-comparator/run-sync": { "post": { "operationId": "run-sync-pengwius-booking-airbnb-scraper-comparator", "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": [ "location", "scoringPriority" ], "properties": { "location": { "title": "Destination", "type": "string", "description": "City, region, or specific location to search for.", "default": "Warsaw, Poland" }, "checkInDate": { "title": "Check-in Date", "type": "string", "description": "Format: YYYY-MM-DD. If left empty, defaults to 14 days from today." }, "checkOutDate": { "title": "Check-out Date", "type": "string", "description": "Format: YYYY-MM-DD. If left empty, defaults to 16 days from today (2 nights)." }, "adults": { "title": "Number of Adults", "minimum": 1, "type": "integer", "description": "Number of adult guests.", "default": 2 }, "children": { "title": "Number of Children", "minimum": 0, "type": "integer", "description": "Number of children.", "default": 0 }, "currency": { "title": "Currency", "type": "string", "description": "Preferred currency code (e.g., USD, EUR, PLN).", "default": "USD" }, "accommodationTypes": { "title": "Accommodation Type", "type": "array", "description": "Filter by property type", "items": { "type": "string", "enum": [ "apartment", "hotel", "hostel", "guesthouse", "homestay", "bed_and_breakfast", "holiday_home", "villa", "holiday_park", "farm_stay", "campsite", "resort", "motel", "lodge", "capsule_hotel", "country_house" ], "enumTitles": [ "Apartments", "Hotels", "Hostels", "Guest houses", "Homestays", "Bed and breakfasts", "Holiday homes", "Villas", "Holiday parks", "Farm stays", "Campsites", "Resorts", "Motels", "Lodges", "Capsule hotels", "Country houses" ] }, "default": [] }, "minStars": { "title": "Minimum Stars", "minimum": 1, "maximum": 5, "type": "integer", "description": "Filter by star rating (1-5)" }, "reviewScore": { "title": "Review Score", "enum": [ "any", "60", "70", "80", "90" ], "type": "string", "description": "Filter by review score", "default": "any" }, "facilities": { "title": "Property Facilities", "type": "array", "description": "Select property facilities", "items": { "type": "string", "enum": [ "parking", "restaurant", "room_service", "24h_front_desk", "fitness_centre", "non_smoking_rooms", "airport_shuttle", "spa_wellness", "hot_tub", "free_wifi", "ev_charging", "swimming_pool", "pets_allowed" ], "enumTitles": [ "Parking", "Restaurant", "Room service", "24-hour front desk", "Fitness centre", "Non-smoking rooms", "Airport shuttle", "Spa and wellness centre", "Hot tub/Jacuzzi", "Free WiFi", "Electric vehicle charging station", "Swimming pool", "Pets allowed" ] }, "default": [] }, "roomFacilities": { "title": "Room Facilities", "type": "array", "description": "Select room facilities", "items": { "type": "string", "enum": [ "private_bathroom", "kitchen", "balcony", "air_conditioning", "view", "bathtub", "terrace" ], "enumTitles": [ "Private bathroom", "Kitchen/kitchenette", "Balcony", "Air conditioning", "View", "Bathtub", "Terrace" ] }, "default": [] }, "meals": { "title": "Meals", "type": "array", "description": "Select meal plans", "items": { "type": "string", "enum": [ "breakfast_included", "breakfast_dinner", "all_meals" ], "enumTitles": [ "Breakfast included", "Breakfast & dinner included", "All meals included" ] }, "default": [] }, "reservationPolicy": { "title": "Reservation Policy", "type": "array", "description": "Select reservation policies", "items": { "type": "string", "enum": [ "free_cancellation", "no_credit_card" ], "enumTitles": [ "Free cancellation", "Book without credit card" ] }, "default": [] }, "bedPreference": { "title": "Bed Preference", "enum": [ "any", "twin", "double" ], "type": "string", "description": "Preferred bed type", "default": "any" }, "accessibility": { "title": "Accessibility", "type": "array", "description": "Accessibility features", "items": { "type": "string", "enum": [ "wheelchair_accessible", "elevator", "ground_floor" ], "enumTitles": [ "Wheelchair accessible", "Upper floors accessible by elevator", "Entire unit located on ground floor" ] }, "default": [] }, "sortBy": { "title": "Platform Sort Order", "enum": [ "price", "distance", "rating", "stars" ], "type": "string", "description": "How to sort results on the booking platform?", "default": "price" }, "scoringPriority": { "title": "My Scoring Priority", "enum": [ "balanced", "price", "rating", "free_cancellation" ], "type": "string", "description": "Choose what matters most to you. This affects the 'score' field in the output, helping you sort the best deals to the top.", "default": "balanced" }, "scrapeBooking": { "title": "Scrape Booking.com", "type": "boolean", "description": "Enable scraping from Booking.com", "default": true }, "scrapeAirbnb": { "title": "Scrape Airbnb", "type": "boolean", "description": "Enable scraping from Airbnb", "default": true }, "minPrice": { "title": "Min Price (per night)", "minimum": 0, "type": "integer", "description": "Minimum price per night in the selected currency." }, "maxPrice": { "title": "Max Price (per night)", "minimum": 0, "type": "integer", "description": "Maximum price per night in the selected currency. Leave empty for no limit." }, "maxItems": { "title": "Max Items per Platform", "minimum": 0, "type": "integer", "description": "Limit the number of results scraped from EACH platform (e.g., 50 from Booking + 50 from Airbnb = 100 total). Set to 0 for no limit.", "default": 50 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Select proxies to be used by your crawler.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }