{
  "openapi": "3.0.1",
  "info": {
    "title": "Google Hotels Prices Scraper | OTA Rates & Rate Parity",
    "description": "Scrape Google Hotels prices from every seller Google lists (Booking.com, Expedia, Hotels.com, Agoda, the official site and more, typically 15 to 30 per hotel) for your exact dates. City search, hotel lists, date sweeps, rate-parity flags and price-change monitoring.",
    "version": "1.0",
    "x-build-id": "gOG0nDnGfID0aFANO"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/zrk1212~google-hotels-prices-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-zrk1212-google-hotels-prices-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/zrk1212~google-hotels-prices-scraper/runs": {
      "post": {
        "operationId": "runs-sync-zrk1212-google-hotels-prices-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/zrk1212~google-hotels-prices-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-zrk1212-google-hotels-prices-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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "prices",
              "search"
            ],
            "type": "string",
            "description": "Prices: one row per hotel per stay date with the price from every seller (or one row per seller, see Output format). Search: one row per hotel from the Google Hotels results list with the lowest price, rating, class, amenities and coordinates. Search is cheaper and has no per-seller prices.",
            "default": "prices"
          },
          "queries": {
            "title": "Search queries",
            "type": "array",
            "description": "Free-text Google Hotels searches, for example hotels in Austin, hotels near Times Square, or Paris 5-star hotels. Each query returns up to Max hotels per query hotels.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "hotels": {
            "title": "Specific hotels",
            "type": "array",
            "description": "Google Hotels entity URLs (https://www.google.com/travel/hotels/entity/ChoIn5iv34ia.../prices), raw entity ids (ChoIn5iv34iajuemARoNL2cvMTFidjFubnp6MxAB) or hotel names with a city (Hotel Van Zandt, Austin). Entity URLs and ids are the fastest and most reliable input.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "checkInDate": {
            "title": "Check-in date",
            "type": "string",
            "description": "Exact check-in date. If empty, Days ahead is used. Dates in the past or more than 330 days ahead return a free error row."
          },
          "checkOutDate": {
            "title": "Check-out date",
            "type": "string",
            "description": "Exact check-out date. If empty, check-in plus Nights is used."
          },
          "daysAhead": {
            "title": "Days ahead",
            "minimum": 0,
            "maximum": 330,
            "type": "integer",
            "description": "Used when Check-in date is empty: check-in is today (UTC) plus this many days. Keeps scheduled runs always in the future.",
            "default": 30
          },
          "nights": {
            "title": "Nights",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Length of stay when Check-out date is empty.",
            "default": 2
          },
          "adults": {
            "title": "Adults",
            "minimum": 1,
            "maximum": 12,
            "type": "integer",
            "description": "Number of adults.",
            "default": 2
          },
          "sweepDays": {
            "title": "Date sweep: extra check-in dates",
            "minimum": 0,
            "maximum": 90,
            "type": "integer",
            "description": "Price calendar: also check this many additional check-in dates after the first one (same number of nights). 0 means a single stay. Example: 29 gives 30 check-in dates.",
            "default": 0
          },
          "sweepStepDays": {
            "title": "Date sweep: days between dates",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Days between swept check-in dates. 7 means the same weekday every week.",
            "default": 1
          },
          "childAges": {
            "title": "Child ages",
            "type": "array",
            "description": "One entry per child, as the age from 0 to 17, for example 8 and 5.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "currency": {
            "title": "Currency",
            "type": "string",
            "description": "Three-letter ISO 4217 currency code, for example USD, EUR or GBP. If Google prices a hotel in a different currency, that hotel-date becomes a free CURRENCY_UNSUPPORTED error row.",
            "default": "USD"
          },
          "outputFormat": {
            "title": "Output format (prices mode)",
            "enum": [
              "perHotel",
              "perSeller"
            ],
            "type": "string",
            "description": "perHotel gives one row per hotel-date with a sellers array. perSeller gives one flat row per seller per hotel-date, which suits spreadsheets. You pay once per hotel-date in both formats.",
            "default": "perHotel"
          },
          "includeSponsored": {
            "title": "Include sponsored sellers",
            "type": "boolean",
            "description": "Include sellers that appear only in Google sponsored Featured options block. They are flagged isSponsored.",
            "default": true
          },
          "maxHotels": {
            "title": "Max hotels per query",
            "minimum": 1,
            "maximum": 300,
            "type": "integer",
            "description": "Maximum hotels per search query. Results are read 20 properties per page, up to 15 pages. Does not limit the Specific hotels list.",
            "default": 20
          },
          "propertyTypes": {
            "title": "Property types",
            "enum": [
              "hotels",
              "vacationRentals",
              "all"
            ],
            "type": "string",
            "description": "Google mixes vacation rentals into city results. Hotels skips them, and skipped properties are never charged.",
            "default": "hotels"
          },
          "minHotelClass": {
            "title": "Minimum star class",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "Skip hotels below this star class. 0 keeps all.",
            "default": 0
          },
          "monitorKey": {
            "title": "Monitor key",
            "type": "string",
            "description": "Price-change monitoring: give any name, for example austin-weekend. The actor remembers the last prices under this name and outputs only hotel-dates (prices mode) or hotels per stay (search mode) that are new or whose prices changed. Unchanged ones are not output and not charged."
          },
          "gl": {
            "title": "Google country",
            "type": "string",
            "description": "Two-letter Google country code. The prices you see follow the country of the IP address, see the README.",
            "default": "us"
          },
          "hl": {
            "title": "Interface language",
            "type": "string",
            "description": "Interface language. Keep en unless you need localized text fields. Prices are read from numeric fields either way.",
            "default": "en"
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Parallel requests. Keep it low to stay polite to Google.",
            "default": 4
          },
          "maxRunSecs": {
            "title": "Max run seconds",
            "minimum": 0,
            "maximum": 86400,
            "type": "integer",
            "description": "Stop cleanly with partial results after this many seconds. The example input uses 100 so the daily test stays fast. Set 0 (no limit) for larger runs.",
            "default": 0
          },
          "maxResidentialPages": {
            "title": "Max residential retry pages",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "If Google shows a block page, the actor never solves it. It waits once, then retries that single page through a US residential proxy, up to this many pages per run. Block recovery is automatic and included in the price. 0 turns the retry off and returns a free BLOCKED row instead.",
            "default": 50
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "No proxy is enough for US prices and is the fastest. Set a proxy only if you need another point of sale (use a residential group with that country), which is slower.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}