Google Hotels BigQuery

Get Google Hotels reviews into BigQuery.

One endpoint call, the BigQuery setup steps, and a field-to-column map. Then keep it refreshing on a schedule.

50 free requests on signup No credit card

Trusted by hospitality teams at

The pieces

One source, one destination.

Google Hotels Google Hotels

Google aggregates prices and reviews across the whole booking landscape, and its entity tokens resolve from plain hotel names, no URL required. On this page those reviews feed BigQuery, one row per review.

BigQuery BigQuery

BigQuery wants rows, not API calls. A small scheduled job fetches the JSON, flattens the fields you care about, and appends them to a table, so history accumulates and SQL does the rest. Here it becomes the front end for live Google Hotels reviews.

The call

One endpoint returns Google Hotels reviews.

The Google Reviews endpoint returns clean JSON for one hotel. Send your key in the X-API-Key header. See the endpoint docs for every parameter.

Setup

Wire BigQuery to the endpoint.

  1. 01

    Create a StayAPI account and copy your API key from the dashboard.

  2. 02

    Create a dataset and table with the schema below.

  3. 03

    Run the Python script below on a schedule (Cloud Run jobs and Cloud Scheduler work well).

  4. 04

    Query the table or point your BI layer at it.

Config

Python: fetch and insert.

This uses the real endpoint URL with the example Barceló Fortina Malta id. Swap in your hotel id and your API key.

load.py
import requests, psycopg2

URL = "https://api.stayapi.com/v1/google_reviews/reviews?data_id=0x80c8c430cb5147bd:0x82f2c7c5d9d10d84"
HEADERS = {"X-API-Key": "YOUR_API_KEY"}

resp = requests.get(URL, headers=HEADERS, timeout=30)
resp.raise_for_status()
body = resp.json()
records = body.get("data", {}).get("reviews") or body.get("reviews") or body.get("rooms") or []

conn = psycopg2.connect(dsn="YOUR_CONNECTION_STRING")
cur = conn.cursor()
for r in records:
    cur.execute(
        "INSERT INTO stay_data (place_name, place_address, average_rating, review_id) VALUES (%s, %s, %s, %s)",
        (r.get("place_name"), r.get("place_address"), r.get("average_rating"), r.get("review_id")),
    )
conn.commit()
cur.close()
conn.close()

50 free requests on signup, no card.

Field mapping

Response fields to columns.

Each field from the Google Reviews response, and a suggested column name.

Response field Column
data_id data_id
place_name place_name
place_address place_address
total_reviews total_reviews
average_rating average_rating
review_id review_id
rating rating
text text
iso_date iso_date
next_page_token next_page_token
has_more has_more
Result

What it looks like in BigQuery.

The fields from the mapping above land as columns: data_id, place_name, place_address, total_reviews. Refreshed on the schedule you set.

The columns you get

Every row is one hotel record from the Google Reviews response. These fields become columns:

  • data_id
  • place_name
  • place_address
  • total_reviews
  • average_rating
  • review_id
BigQuery showing Google Hotels reviews

Get your key.

Sign up, copy your key into the snippet above, and pull live Google Hotels reviews into BigQuery.

01 · the fast path

Try it free

50 free requests on signup. Fastest way to see if the schema fits.

Start free
  • Live API key in 30 seconds
  • No credit card required
  • Same schema as paid
02 · talk to us

Talk through your pipeline

15 minutes. Volume, endpoint mix, and where the data lands. Walk out with a quote.

Book a demo
  • Quote on the call, not after
  • Engineering, not sales
  • No deck, no slides