Skip to content
Eden Engine

Google Hotels Hotel Details by Hotel ID (US Market, English)

omnial/google-hotels-hotel-details

Given a Google Hotels hotel ID, returns that hotel's details for a US, English-language user: name, star class, address, phone, website domain, description, check-in and check-out times, amenities, neighborhood with location scores and coordinates, guest rating and its star split, review topics with mention counts, other review sites' ratings with a guest review, and nightly prices by booking site with room offers, for the stay dates and party size the response names.

activeper callv1

Price

Up to $0.00546 per call; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

Google

Data from Google.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/google-hotels-hotel-details" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/google-hotels-hotel-details" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/google-hotels-hotel-details", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/google-hotels-hotel-details", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.00546
Updated
Oct 14, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "hotel_identifier",
    "location_code",
    "language_code"
  ],
  "properties": {
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "description": "The language of the details; only \"en\" (English), the one tested, is offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "description": "The market the details are fetched for; only 2840 (United States), the one tested, is offered."
    },
    "hotel_identifier": {
      "type": "string",
      "minLength": 1,
      "description": "The hotel's Google Hotels entity ID, the identifier in a Google Hotels hotel page link."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "about": {
            "type": "object",
            "properties": {
              "domain": {
                "type": "string",
                "description": "The hotel website's domain."
              },
              "amenities": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "hint": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "A qualifier key on how the amenity is offered; null when none."
                          },
                          "amenity": {
                            "type": "string",
                            "description": "The amenity's key."
                          },
                          "hint_label": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The qualifier's display text; null when none."
                          },
                          "is_available": {
                            "type": "boolean",
                            "description": "Whether the hotel offers the amenity."
                          },
                          "amenity_label": {
                            "type": "string",
                            "description": "The amenity's display name."
                          }
                        }
                      }
                    },
                    "category": {
                      "type": "string",
                      "description": "The category key."
                    },
                    "category_label": {
                      "type": "string",
                      "description": "The category's name."
                    }
                  }
                },
                "description": "Amenities grouped by category."
              },
              "description": {
                "type": "string",
                "description": "A short summary of the hotel."
              },
              "full_address": {
                "type": "string",
                "description": "The hotel's name followed by its street address."
              },
              "check_in_time": {
                "type": "object",
                "properties": {
                  "hour": {
                    "type": "number"
                  },
                  "minute": {
                    "type": "number"
                  }
                },
                "description": "The check-in time."
              },
              "check_out_time": {
                "type": "object",
                "properties": {
                  "hour": {
                    "type": "number"
                  },
                  "minute": {
                    "type": "number"
                  }
                },
                "description": "The check-out time."
              },
              "sub_descriptions": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Longer paragraphs about the hotel."
              },
              "popular_amenities": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "hint": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "A qualifier key on how the amenity is offered; null when none."
                    },
                    "amenity": {
                      "type": "string",
                      "description": "The amenity's key."
                    },
                    "hint_label": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The qualifier's display text; null when none."
                    },
                    "is_available": {
                      "type": "boolean",
                      "description": "Whether the hotel offers the amenity."
                    },
                    "amenity_label": {
                      "type": "string",
                      "description": "The amenity's display name."
                    }
                  }
                },
                "description": "The amenities highlighted for the hotel."
              }
            }
          },
          "phone": {
            "type": "string",
            "description": "The hotel's phone number."
          },
          "stars": {
            "type": "number",
            "description": "The hotel's star class."
          },
          "title": {
            "type": "string",
            "description": "The hotel's name."
          },
          "prices": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string"
                    },
                    "price": {
                      "type": "number",
                      "description": "The site's nightly price."
                    },
                    "title": {
                      "type": "string",
                      "description": "The booking site's name."
                    },
                    "offers": {
                      "type": [
                        "array",
                        "null"
                      ],
                      "items": {
                        "type": "object",
                        "properties": {
                          "type": {
                            "type": "string"
                          },
                          "price": {
                            "type": "number",
                            "description": "The room's nightly price."
                          },
                          "title": {
                            "type": "string",
                            "description": "The room type."
                          },
                          "currency": {
                            "type": "string"
                          }
                        }
                      },
                      "description": "Room offers from this site; empty or null when none are shown."
                    },
                    "is_paid": {
                      "type": "boolean",
                      "description": "Whether the listing is a paid (sponsored) placement."
                    },
                    "currency": {
                      "type": "string"
                    },
                    "official_site": {
                      "type": "boolean",
                      "description": "Whether the listing is the hotel's own booking site."
                    }
                  }
                },
                "description": "One entry per booking site listing a price."
              },
              "price": {
                "type": "number",
                "description": "The headline nightly price."
              },
              "check_in": {
                "type": "string",
                "description": "The check-in date the prices are for."
              },
              "currency": {
                "type": "string",
                "description": "The price currency."
              },
              "visitors": {
                "type": "number",
                "description": "The party size the prices are for."
              },
              "check_out": {
                "type": "string",
                "description": "The check-out date the prices are for."
              }
            }
          },
          "address": {
            "type": "string",
            "description": "The hotel's street address."
          },
          "reviews": {
            "type": "object",
            "properties": {
              "value": {
                "type": "number",
                "description": "The average guest rating, out of 5."
              },
              "mentions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "title": {
                      "type": "string",
                      "description": "The topic."
                    },
                    "total_count": {
                      "type": "number"
                    },
                    "negative_count": {
                      "type": "number"
                    },
                    "positive_count": {
                      "type": "number"
                    },
                    "positive_score": {
                      "type": "number",
                      "description": "The share of mentions that are positive, from 0 to 1."
                    },
                    "visible_by_default": {
                      "type": "boolean",
                      "description": "Whether the topic is shown before the list is expanded."
                    }
                  }
                },
                "description": "Topics guests mention, with how they feel about each."
              },
              "votes_count": {
                "type": "number",
                "description": "How many guest ratings there are."
              },
              "other_sites_reviews": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "title": {
                      "type": "string",
                      "description": "The review site's name."
                    },
                    "rating": {
                      "type": "object",
                      "properties": {
                        "value": {
                          "type": "number",
                          "description": "The site's average rating."
                        },
                        "rating_type": {
                          "type": "string",
                          "description": "The rating scale."
                        },
                        "votes_count": {
                          "type": "number",
                          "description": "The site's rating count."
                        }
                      }
                    },
                    "review_text": {
                      "type": "string",
                      "description": "One guest review's text."
                    }
                  }
                },
                "description": "Average ratings and one guest review from other review sites."
              },
              "rating_distribution": {
                "type": "object",
                "properties": {
                  "1": {
                    "type": "number"
                  },
                  "2": {
                    "type": "number"
                  },
                  "3": {
                    "type": "number"
                  },
                  "4": {
                    "type": "number"
                  },
                  "5": {
                    "type": "number"
                  }
                },
                "description": "The percentage of guest ratings at each star level, 1 to 5."
              }
            }
          },
          "datetime": {
            "type": "string",
            "description": "When the details were fetched (UTC)."
          },
          "location": {
            "type": "object",
            "properties": {
              "latitude": {
                "type": "number"
              },
              "longitude": {
                "type": "number"
              },
              "neighborhood": {
                "type": "string",
                "description": "The hotel's neighborhood or area."
              },
              "overall_score": {
                "type": "number",
                "description": "The overall location score, out of 5."
              },
              "location_chain": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "title": {
                      "type": "string",
                      "description": "The place's name."
                    }
                  }
                },
                "description": "The places the hotel sits within, ending with the hotel itself."
              },
              "score_by_categories": {
                "type": "object",
                "properties": {
                  "overall": {
                    "type": "number"
                  },
                  "transit": {
                    "type": "number"
                  },
                  "restaurants": {
                    "type": "number"
                  },
                  "things_to_do": {
                    "type": "number"
                  },
                  "airport_access": {
                    "type": "number"
                  }
                },
                "description": "Location scores out of 5 by topic."
              },
              "neighborhood_description": {
                "type": "string",
                "description": "A short description of the area."
              }
            }
          },
          "language_code": {
            "type": "string",
            "description": "The language code."
          },
          "location_code": {
            "type": "number",
            "description": "The market's location code."
          },
          "hotel_identifier": {
            "type": "string",
            "description": "The hotel ID that was looked up."
          },
          "stars_description": {
            "type": "string",
            "description": "The star class as text."
          }
        }
      }
    }
  },
  "description": "The hotel, wrapped as `{results: [...]}` with one entry."
}