Provided by DataForSEO
Get Google hotel details using a hotel identifier with DataForSEO
Read the Google Hotels entry of one hotel, addressed by its hotel identifier, for one location and language, optionally for given check-in and check-out dates and guest counts. The answer is that single hotel: its name, star class, address, description, website, amenities, neighborhood, location scores for things to do, restaurants, transit and airport access, map coordinates, review score with vote count and the spread of ratings, and overview images. One request per call, priced by the vendor's own rate card; an empty result set is reported as no result.
How to run it
Step 1Set up
Once: paste this into your agent's chat. The Skill installs the CLI and logs in by itself. For an agent that cannot use a shell, connect it over MCP instead.
set up https://glasser.ai/SKILL.md
Show me how to use the DataForSEO endpoint /v3/business_data/google/hotel_info/live/advanced on Glasser.glasser run -p dataforseo -e '/v3/business_data/google/hotel_info/live/advanced' -i '{"language_code":"en","location_code":1023191,"hotel_identifier":"CgoI-KWyzenM_MV3EAE"}' --endpoint-version 2Uses endpoint version 2. Inspect the current price before running. Install and log in first on Get Started.
Once per Run:
IDEMPOTENCY_KEY=$(uuidgen)Run it, and copy this same block to send it again:
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"dataforseo","endpoint":"/v3/business_data/google/hotel_info/live/advanced","input":{"language_code":"en","location_code":1023191,"hotel_identifier":"CgoI-KWyzenM_MV3EAE"},"endpoint_version":2}'Reuse the same Idempotency-Key to send it again: the second send is a read of the first Run. A new key is a new Run and a new Charge. Uses endpoint version 2; inspect the current price before running.
Step 2Try a specific example task
When you need to qualify potential customers, you might compare company information with your ideal-customer criteria to decide which accounts to research next.
Copy this prompt into your agent to review companies against your ideal-customer criteria.
Use dataforseo:/v3/business_data/google/hotel_info/live/advanced on Glasser.
Check the returned company data against my ideal-customer criteria.Endpoint structure
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"hotel_identifier"
],
"properties": {
"tag": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"adults": {
"type": "integer"
},
"check_in": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"children": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"maxItems": 100,
"minItems": 1
},
"currency": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"check_out": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"language_code": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"language_name": {
"type": "string"
},
"location_code": {
"type": "integer"
},
"location_name": {
"type": "string"
},
"prices_end_date": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"hotel_identifier": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"prices_date_range": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"prices_start_date": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"location_coordinate": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"load_prices_by_dates": {
"type": "boolean"
}
},
"additionalProperties": false
}{
"language_code": "en",
"location_code": 1023191,
"hotel_identifier": "CgoI-KWyzenM_MV3EAE"
}This Endpoint publishes no output schema. You get the Provider's own response body, unchanged — we do not warrant a shape we cannot guarantee.
How pricing works
| Data returned or no match | The same price with or without matching data. | $0.004 |
|---|---|---|
| Provider error | The Provider failed to answer. | $0.00 |
| Timed out | The Run exceeded its time limit. | $0.00 |
| Internal failure | An internal error prevented completion. | $0.00 |