canonical: https://jentic.com/apis/google.com/google-travel-partner

# Google Travel Partner API

Manage hotel listings, pricing data, and performance analytics on Google Hotel Center through a RESTful interface with 23 endpoints. Retrieve price accuracy and coverage reports, configure free booking links, verify listing data, and reconcile reservation records. The API is designed for travel partners managing large hotel portfolios who need programmatic control over their Google hotel presence.

## For AI agents

Manage hotel listings, pricing accuracy, and booking link performance on Google Hotel Center. Pull performance reports, verify listings, and reconcile reservation data for travel partner accounts.

## Scope

Does not handle flight bookings, map directions, or general Google Ads - use for hotel listing management and booking link analytics on Google Hotel Center only.

## Capabilities

- Set hotels live on Google to enable booking links and price display in search results
- Query free booking link performance reports with date-range filtering and aggregation
- Retrieve price accuracy scores showing how listed prices compare to actual booking costs
- Verify hotel listing data against Google's validation rules before publishing
- Pull price coverage metrics showing what percentage of hotel inventory has active pricing
- Reconcile reservation records between partner systems and Google's booking data
- Upload and manage brand icons displayed alongside hotel listings in search

## Use cases

### AI Agent Hotel Listing Management

AI agents monitor and optimize hotel listings on Google Hotel Center through Jentic. The agent searches for operations by intent (e.g., 'check hotel price accuracy'), receives the schema, and executes reporting and verification calls without manual configuration. Automated monitoring catches pricing discrepancies and listing verification failures before they impact search visibility.

Example prompt: Query the price accuracy report for account 'accounts/12345' for the last 7 days using /v3/{+name}/priceAccuracyViews and flag any hotels below 90% accuracy

### Free Booking Links Performance Monitoring

Track click-through rates, impressions, and booking conversions for free booking links displayed in Google Search and Maps. The freeBookingLinksReportViews endpoint provides daily and weekly aggregates by property, allowing partners to identify underperforming listings and optimize pricing or availability data to improve visibility.

Example prompt: Query /v3/{+name}/freeBookingLinksReportViews for the past 30 days and aggregate click-through rates by property

### Price Accuracy and Coverage Optimization

Monitor how accurately listed prices match actual booking costs and what fraction of hotel inventory has active pricing. The priceAccuracyViews endpoint scores each property's pricing reliability, while priceCoverageViews shows gaps in rate availability. Partners use these metrics to prioritize pricing feed fixes and maximize search result eligibility.

Example prompt: Retrieve the latest price coverage summary using /v3/{+parent}/priceCoverageViews:latest and identify properties with coverage below 80%

### Reservation Reconciliation

Reconcile booking records between partner reservation systems and Google's data to ensure commission accuracy and resolve discrepancies. Upload reconciliation reports and run validation against Google's records. This prevents revenue leakage from mismatched bookings and supports accurate financial reporting between travel partners and Google.

Example prompt: Submit a reconciliation report for the current month using POST /v3/{+parent}/reconciliationReports and validate it with /v3/{+parent}/reconciliationReports:validate

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /v3/{+account}/hotels:setLiveOnGoogle | Set hotels live for display in Google search results |
| GET | /v3/{+name}/freeBookingLinksReportViews:query | Query free booking link performance metrics |
| GET | /v3/{+name}/priceAccuracyViews | Retrieve price accuracy scores by property |
| GET | /v3/{+name}/propertyPerformanceReportViews:query | Query property-level performance data |
| GET | /v3/{+parent}/priceCoverageViews:latest | Get the latest price coverage summary |
| GET | /v3/{+parent}/hotelViews | List hotel views for a partner account |
| POST | /v3/{+parent}/reconciliationReports | Upload a reconciliation report |
| POST | /v3/{+parent}/reconciliationReports:validate | Validate a reconciliation report |

## Key resources

- **Hotels** — Set hotels live on Google and manage listing visibility and status
- **Report Views** — Query free booking links, participation, property performance, and price accuracy reports
- **Price Coverage** — Monitor rate availability and coverage across hotel inventory
- **Reconciliation Reports** — Upload and validate booking reconciliation data
- **Account Links** — Manage linked accounts and brand configurations

## Why Jentic

- **Setup:** Wiring the Travel Partner API by hand means running Google's OAuth 2.0 service-account flow against travelpartner.googleapis.com, formatting the resource names its paths expect, and mapping the hotel listing and booking-link report endpoints yourself. Through Jentic you install once, import the Travel Partner API from the API Directory, store the service-account credentials once, and your agent calls it.
- **Permission scoping:** The Travel Partner API puts the account and resource name in the URL path (/v3/{+account}/... and /v3/{+parent}/...), so a rule can pin your agent to one account: it can read that account's price accuracy, hotel views, and performance reports and nothing else. You choose the operations it may call, so ones like setting hotels live on Google or submitting reconciliation reports are not included unless you add them.
- **Credential handling:** Your Google service-account credentials are stored once, encrypted, by your own Jentic One instance and exchanged for scoped access tokens at execution time. The private key never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'check hotel price accuracy on Google' or 'query booking link performance', and Jentic returns the matching Travel Partner operation with its input schema, including the resource name formatting, so the agent calls the right endpoint without reading the reference.

## Related APIs

- **Booking.com API** — Online travel agency with hotel inventory, rates, and booking functionality
- **Amadeus API** — Travel industry APIs covering flights, hotels, and travel intelligence
- **Google Cloud Storage** — Object storage for hosting hotel images and media assets

## FAQ

### What authentication does the Travel Partner API use?

The Travel Partner API uses Google OAuth 2.0 for authentication. Service accounts with the Travel Partner scope are typical for server-to-server integrations. Through Jentic, OAuth credentials are stored encrypted in your Jentic One instance - agents receive pre-authorized access tokens without handling service account keys directly.

### Can I check price accuracy for my hotel listings with this API?

Yes. The /v3/{+name}/priceAccuracyViews endpoint returns accuracy scores showing how closely your listed prices match actual booking costs. Use /v3/{+parent}/priceAccuracyViews:summarize for an aggregate summary across all properties. Scores below 90% typically indicate pricing feed issues.

### What are the rate limits for the Travel Partner API?

The Travel Partner API follows standard Google API quotas. Default limits are approximately 1,000 requests per 100 seconds per project. Report query endpoints may have lower limits due to computational cost. The API returns HTTP 429 with quota information when limits are exceeded.

### How do I pull a performance report through Jentic?

Search Jentic for 'query hotel booking link performance' to load the freeBookingLinksReportViews operation schema. Pass your account name and date range parameters to retrieve click, impression, and conversion data by property. Install with pip install jentic and run it through Jentic One, the self-hosted execution layer.

### Can I verify hotel listing data before publishing?

Yes. The /v3/{+parent}/listings:verify endpoint validates your hotel listing data against Google's requirements before going live. It checks for required fields, formatting issues, and data consistency. Use this to catch errors before they prevent listings from appearing in search results.

### What data does the reconciliation report contain?

Reconciliation reports compare booking records between your system and Google's data. They include reservation IDs, dates, amounts, and status for a given period. Use POST /v3/{+parent}/reconciliationReports to upload your data and /v3/{+parent}/reconciliationReports:validate to check it against Google's records.

### Can I limit what my agent is allowed to do with the Travel Partner API?

Yes. Because you run Jentic One yourself, your own rules decide which Travel Partner operations and which Google service-account credentials the agent may use. Since the API carries the account and resource name in the URL path, you can pin the agent to a single account and grant only read operations such as priceAccuracyViews, hotelViews, and the performance report views. Write operations like hotels:setLiveOnGoogle or submitting reconciliationReports stay unavailable unless you add them to the rule.