Google Hotels Autocomplete

Get location autocomplete suggestions for hotel search. Use the type parameter to control whether you get location-based suggestions (cities), hotel-based suggestions (accommodations), or both.

Endpoint

GET /api/google-hotels/autocomplete
✨

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Parameters

q string Required

Location search query

gl string Optional

2-letter country code for localization (e.g., us, gb, de, fr)

hl string Optional

2-letter language code for results (e.g., en, es, fr, de)

currency string Optional

3-letter currency code used in suggestion links (e.g., USD, EUR, GBP)

type string Optional

Type of suggestions to return: location (cities/locations only), hotel (accommodations only), all (both). Default: hotel

Request Examples

<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://scrappa.co/api/google-hotels/autocomplete?q=Berlin');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'x-api-key: YOUR_API_KEY_HERE',
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
<?php

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'x-api-key' => 'YOUR_API_KEY_HERE',
])->get('https://scrappa.co/api/google-hotels/autocomplete?q=Berlin');

return $response->json();
fetch('https://scrappa.co/api/google-hotels/autocomplete?q=Berlin', {
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
const axios = require('axios');

axios.get('https://scrappa.co/api/google-hotels/autocomplete?q=Berlin', {
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE'
  }
})
  .then(response => console.log(response.data))
  .catch(error => console.error('Error:', error));
import requests

headers = {
    'x-api-key': 'YOUR_API_KEY_HERE'
}

response = requests.get('https://scrappa.co/api/google-hotels/autocomplete?q=Berlin', headers=headers)
print(response.json())
require 'net/http'
require 'uri'
require 'json'

uri = URI.parse('https://scrappa.co/api/google-hotels/autocomplete?q=Berlin')
request = Net::HTTP::Get.new(uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts JSON.parse(response.body)
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://scrappa.co/api/google-hotels/autocomplete?q=Berlin", nil)
    req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
curl -X GET 'https://scrappa.co/api/google-hotels/autocomplete?q=Berlin' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Response Schema

JSON Response 200 OK 
{
    "search_parameters": {
        "engine": "google_hotels_autocomplete",
        "q": "Paris",
        "gl": "us",
        "hl": "en",
        "currency": "USD"
    },
    "suggestions": [
        {
            "position": 1,
            "value": "paris hotel las vegas",
            "type": "accommodation",
            "highlighted_words": [
                "hotel las vegas"
            ],
            "autocomplete_suggestion": "paris hotel las vegas",
            "scrappa_google_hotels_link": "https://scrappa.co/api/google-hotels/search?q=Las+Vegas%2C+NV&check_in_date=2026-02-27&check_out_date=2026-02-28&adults=2&children=0&currency=USD&hl=en&gl=us&property_token=ChgIgbj58O-AraJFGgovbS8wMzQ4czYwEAE",
            "location": "Las Vegas, NV",
            "thumbnail": "https://lh3.googleusercontent.com/grass/AKc-QJEPi1pQEfr-uPrS56QJayOxIX_eB0VMbaasFAlqvvL0jM_cI_a_D9_lrItRAZpRCCIRP8yh8iZqTQw-WRk7PCoe2Q=w92-h92-n-k-no",
            "kgmid": "/m/0348s60",
            "data_cid": "4991312229159558145",
            "property_token": "ChgIgbj58O-AraJFGgovbS8wMzQ4czYwEAE",
            "scrappa_link": "https://scrappa.co/api/search?q=paris+hotel+las+vegas&hl=en&gl=us&kgmid=%2Fm%2F0348s60"
        }
    ],
    "response_time_ms": 587
}

Try It Live

Test this endpoint in our interactive playground with real data.

Open in Playground
← Back to Home