{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Hotels API — Hotel Prices, Room Rates & OTA Offers",
    "description": "Google Hotels API and scraper: hotel prices by city with rating, reviews, star class and amenities, plus room rates from every booking site (Booking.com, Expedia, Agoda, official site) with cancellation and breakfast terms. Any currency, no API key.",
    "version": "0.2",
    "x-build-id": "YIUQD3JsfVLYE8AED"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/monkey.d.scraping~google-hotels-room-offers/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-monkey.d.scraping-google-hotels-room-offers",
        "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/monkey.d.scraping~google-hotels-room-offers/runs": {
      "post": {
        "operationId": "runs-sync-monkey.d.scraping-google-hotels-room-offers",
        "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/monkey.d.scraping~google-hotels-room-offers/run-sync": {
      "post": {
        "operationId": "run-sync-monkey.d.scraping-google-hotels-room-offers",
        "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": {
          "destinations": {
            "title": "Destinations (city, area or search)",
            "type": "array",
            "description": "One search per line, such as Milan, Paris 5-star hotels or hostels near Shibuya Tokyo. Each search returns up to 20 hotels with price, rating, reviews, star class and amenities.",
            "items": {
              "type": "string"
            }
          },
          "hotels": {
            "title": "Hotels for room offers (name or Google Hotels link)",
            "type": "array",
            "description": "Optional. One hotel name with city or a full https://www.google.com/travel/hotels/entity/... link per line, up to 10. Returns every room offer shown for the stay: booking site, room, nightly price, stay total, cancellation and breakfast.",
            "items": {
              "type": "string"
            }
          },
          "checkIn": {
            "title": "Check-in — blank = 30 days from today",
            "type": "string",
            "description": "YYYY-MM-DD. Leave both dates blank for check-in 30 days from the run date."
          },
          "checkOut": {
            "title": "Check-out — blank = 2 nights after check-in",
            "type": "string",
            "description": "YYYY-MM-DD. With both dates blank, the stay lasts two nights."
          },
          "adults": {
            "title": "Adults in one room",
            "minimum": 1,
            "maximum": 6,
            "type": "integer",
            "description": "Adults sharing one room.",
            "default": 2
          },
          "currency": {
            "title": "Currency",
            "enum": [
              "EUR",
              "USD",
              "GBP",
              "CHF",
              "JPY",
              "CAD",
              "AUD",
              "CNY",
              "INR"
            ],
            "type": "string",
            "description": "Currency of all returned prices.",
            "default": "EUR"
          },
          "maxHotelsPerDestination": {
            "title": "Hotels per destination",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many hotels to return for each destination search, in Google Hotels order.",
            "default": 20
          },
          "includeRoomOffers": {
            "title": "Also get room offers for every hotel found",
            "type": "boolean",
            "description": "For each hotel found by a destination search, also return its room offers by booking site (Booking.com, Expedia, Agoda, official site and others).",
            "default": false
          },
          "onlyFreeCancellation": {
            "title": "Only free-cancellation room offers",
            "type": "boolean",
            "description": "Keep only room offers that state free cancellation.",
            "default": false
          },
          "onlyBreakfastIncluded": {
            "title": "Only breakfast-included room offers",
            "type": "boolean",
            "description": "Keep only room offers that state breakfast is included.",
            "default": false
          },
          "maxOffersPerHotel": {
            "title": "Maximum offers per hotel",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Return up to this many room offers per hotel, cheapest stay total first.",
            "default": 100
          },
          "previousSnapshotStoreId": {
            "title": "Previous run storage (optional)",
            "type": "string",
            "description": "Select the storage of an earlier run to get a list of room-offer price changes. Use the same dates, adults, filters and offer limit."
          },
          "previousSnapshot": {
            "title": "Or paste a snapshot JSON (optional)",
            "type": "object",
            "description": "Alternative to selecting the previous storage: paste the exported SNAPSHOT JSON."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}