{
  "openapi": "3.0.1",
  "info": {
    "title": "Booking.com Hotel Prices Scraper | City Search & Rate Calendar",
    "description": "The Booking.com Rates Scraper prices named hotels across a whole range of check-in dates, lengths of stay and occupancies in one run, returning total and per-night rates, taxes, cancellation terms, sold-out dates and ~100 competitor rates per stay — ideal for revenue management and rate shopping.",
    "version": "0.0",
    "x-build-id": "OWAVin3it4hLUbORF"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/piotrv1001~booking-com-rates-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-piotrv1001-booking-com-rates-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/piotrv1001~booking-com-rates-scraper/runs": {
      "post": {
        "operationId": "runs-sync-piotrv1001-booking-com-rates-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/piotrv1001~booking-com-rates-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-piotrv1001-booking-com-rates-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": {
          "hotels": {
            "title": "Properties",
            "type": "array",
            "description": "Properties to price — a hotel name, a Booking.com property URL, or a Booking.com property ID. One per line. Leave empty when you search destinations instead.",
            "items": {
              "type": "string"
            }
          },
          "destinations": {
            "title": "Destinations",
            "type": "array",
            "description": "Cities, regions, districts, airports or landmarks to search (e.g. \"London\", \"Tuscany\"), or Booking.com search result URLs. Every property found is priced for each stay, up to \"Max properties per destination\". Without dates, a destination search prices one check-in date (tomorrow).",
            "items": {
              "type": "string"
            }
          },
          "checkinFrom": {
            "title": "First check-in date",
            "type": "string",
            "description": "Start of the check-in date range, in YYYY-MM-DD format. Leave empty to start tomorrow."
          },
          "checkinTo": {
            "title": "Last check-in date",
            "type": "string",
            "description": "End of the check-in date range, in YYYY-MM-DD format. Leave empty to cover 14 days. Booking.com sells about 450 days ahead; later dates are clamped."
          },
          "losNights": {
            "title": "Lengths of stay (nights)",
            "type": "array",
            "description": "Every check-in date is priced once for each length of stay you pick. Leave empty for 1 and 2 nights (1 night for destinations).",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6",
                "7",
                "10",
                "14",
                "21",
                "28"
              ],
              "enumTitles": [
                "1 night",
                "2 nights",
                "3 nights",
                "4 nights",
                "5 nights",
                "6 nights",
                "7 nights",
                "10 nights",
                "14 nights",
                "21 nights",
                "28 nights"
              ]
            }
          },
          "occupancy": {
            "title": "Occupancy (adults)",
            "type": "array",
            "description": "Every check-in date and length of stay is priced once for each occupancy you pick.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4",
                "5",
                "6"
              ],
              "enumTitles": [
                "1 adult",
                "2 adults",
                "3 adults",
                "4 adults",
                "5 adults",
                "6 adults"
              ]
            },
            "default": [
              "2"
            ]
          },
          "children": {
            "title": "Children",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Children in the party, priced on every stay. Each child needs an age below; a missing age is taken as 8."
          },
          "childrenAges": {
            "title": "Children's ages",
            "type": "array",
            "description": "One age (0-17) per child, e.g. [5, 9]. Booking.com prices children by age. Leave \"Children\" empty and the number of ages is used."
          },
          "rooms": {
            "title": "Rooms",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Rooms per booking. The price is the total for all rooms. Needs at least one adult per room."
          },
          "currency": {
            "title": "Currency",
            "enum": [
              "USD",
              "EUR",
              "GBP",
              "AUD",
              "CAD",
              "CHF",
              "JPY",
              "CNY",
              "INR",
              "BRL",
              "MXN",
              "PLN",
              "SEK",
              "NOK",
              "DKK",
              "CZK",
              "AED",
              "SGD",
              "ZAR",
              "TRY"
            ],
            "type": "string",
            "description": "Currency the rates are returned in.",
            "default": "USD"
          },
          "includeCompetitors": {
            "title": "Include competitor rates",
            "type": "boolean",
            "description": "Also return the rates of nearby properties for exactly the same stay, so every rate can be benchmarked against its local market. Named properties only. Adds roughly 100 extra rows per rate row and is billed separately.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum rate rows",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many rate rows for your properties. Competitor rows are extra and are not counted here.",
            "default": 100
          },
          "maxProperties": {
            "title": "Max properties per destination",
            "minimum": 1,
            "type": "integer",
            "description": "How many properties each destination returns per stay. Each one is a rate row. \"Maximum rate rows\" still caps the whole run.",
            "default": 50
          },
          "sortBy": {
            "title": "Sort destination results",
            "enum": [
              "top_picks",
              "price",
              "review_score",
              "stars_desc",
              "stars_asc",
              "distance",
              "popularity"
            ],
            "type": "string",
            "description": "Order in which a destination's properties are taken.",
            "default": "top_picks"
          },
          "minStars": {
            "title": "Minimum stars",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "Only properties with at least this star rating."
          },
          "minReviewScore": {
            "title": "Minimum review score",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Only properties with at least this guest review score, out of 10. Booking.com filters on 6, 7, 8 or 9 and up; other values round down."
          },
          "minPricePerNight": {
            "title": "Minimum price per night",
            "minimum": 0,
            "type": "integer",
            "description": "In the run's currency."
          },
          "maxPricePerNight": {
            "title": "Maximum price per night",
            "minimum": 1,
            "type": "integer",
            "description": "In the run's currency."
          },
          "propertyTypes": {
            "title": "Property types",
            "type": "array",
            "description": "Only these kinds of property. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "hotels",
                "apartments",
                "aparthotels",
                "hostels",
                "guest_houses",
                "bed_and_breakfasts",
                "holiday_homes",
                "homestays",
                "villas",
                "resorts"
              ],
              "enumTitles": [
                "Hotels",
                "Apartments",
                "Aparthotels",
                "Hostels",
                "Guest houses",
                "Bed and breakfasts",
                "Holiday homes",
                "Homestays",
                "Villas",
                "Resorts"
              ]
            }
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Proxy settings. Datacenter proxies are enough for this Actor.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}