Hilton API

The Hilton API for hotel discovery and starting cash rates.

Q: What is a Hilton hotel code?

The seven-character hotel_code is Hilton's ctyhocn identifier, for example LONHITW. Search returns it, and URL resolution extracts it without checking whether a property exists.

Q: Which Hilton URLs can I resolve?

Use a canonical HTTPS hilton.com or www.hilton.com hotel URL, or a reservation rooms URL containing one valid ctyhocn. See URL to Hotel ID for validation and normalization rules.

Q: Does total mean all Hilton hotels in a destination?

No. total is the number returned in this response. The limit defaults to 20 and accepts 1 to 150. No pagination parameter is supported.

Get undated Hilton hotel metadata, addresses, photos, amenity identifiers, and opening status as JSON. Extract hotel codes from canonical Hilton URLs, then request dated room types and starting cash offers.

REQUEST GET

USE CASE Get one starting cash offer per available Hilton room type for three adults.

curl "https://api.stayapi.com/v1/hilton/rooms" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "hotel_code=LONHITW" \
  -d "check_in=2026-11-12" \
  -d "check_out=2026-11-15" \
  -d "adults=3" \
  -d "currency=GBP"

USE CASE Find Hilton hotel metadata around London.

curl "https://api.stayapi.com/v1/hilton/search" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "query=London" \
  -d "limit=20"

USE CASE Extract a Hilton code from a property URL.

curl "https://api.stayapi.com/v1/hilton/hotel/url-to-id" \
  -G \
  -H "x-api-key: $STAYAPI_KEY" \
  -d "url=https://www.hilton.com/en/hotels/lonhitw-london-hilton-on-park-lane/"

RESPONSE 200 OK

2.41s

{
  "success": true,
  "hotel_code": "LONHITW",
  "check_in": "2026-11-12",
  "check_out": "2026-11-15",
  "adults": 3,
  "currency": "GBP",
  "native_currency": "GBP",
  "pricing_scope": "starting_rates",
  "total": 1,
  "room_types": [
    {
      "code": "D2RRF2",
      "name": "Family Room",
      "description": "Classically styled room with air conditioning and WiFi.",
      "occupancy": 3,
      "beds": 2,
      "accessible": false,
      "suite": false,
      "photos": [],
      "rates": [
        {
          "rate_plan_code": "RPLOSR",
          "per_night": 432.6,
          "total": 1297.81,
          "total_formatted": "£1,297.81",
          "currency": "GBP",
          "includes_taxes_and_service_charges": true,
          "rate_changes_during_stay": true
        }
      ]
    }
  ]
}

{
  "success": true,
  "hotels": [
    {
      "hotel_code": "LONHITW",
      "name": "London Hilton on Park Lane",
      "brand_code": "HI",
      "address": {
        "street": "22 Park Lane",
        "city": "London",
        "state": null,
        "country_code": "GB"
      },
      "location": {
        "latitude": 51.505,
        "longitude": -0.15
      },
      "phone": null,
      "photos": [],
      "url": "https://www.hilton.com/en/hotels/lonhitw-london-hilton-on-park-lane/",
      "status": {
        "open": true,
        "open_date": null,
        "reservations_enabled": true,
        "reservations_enabled_date": null,
        "seasonally_closed": false,
        "seasonal_reopen_date": null
      },
      "amenity_ids": [],
      "rating": null,
      "review_count": null
    }
  ],
  "total": 1,
  "location_match": null
}

{
  "success": true,
  "hotel_code": "LONHITW",
  "url": "https://www.hilton.com/en/hotels/lonhitw-london-hilton-on-park-lane/"
}

Start free with 50 requests Read the docs

99.9% uptime ~3s avg response Live, not cached

Trusted by hospitality teams at

Overview

What the Hilton API gives you.

Discover Hilton properties by destination, address, or coordinates. The search response provides English hotel metadata and the seven-character hotel_code, Hilton's ctyhocn identifier.

For Search, supply a query or both coordinates, never both. Search is undated inventory: it does not provide prices, room inventory, or availability for a stay. Properties may be unopened or seasonally closed, so inspect the published status fields. Use the returned hotel code with Rooms for dated starting cash offers.

Choose a search center.

Use a 2–200 character trimmed query or a finite latitude and longitude pair. Request up to 150 results; the default limit is 20.

Keep the hotel code.

Search and URL resolution return the same seven-character hotel_code identifier.

Read property status.

Opening and seasonal status describe the property. They do not establish room availability for any stay.

View pricing View the docs

Endpoints

Every Hilton endpoint, one base URL.

Each returns normalized JSON in the same shape. Click any endpoint for parameters, an example response, and a live playground.

GET Hotel rooms /v1/hilton/rooms Dated room types and one starting cash offer each, with exact USD or GBP stay totals. GET Hotel search /v1/hilton/search Find English hotel metadata by destination, address, or coordinates without dates or prices. GET URL to Hotel ID /v1/hilton/hotel/url-to-id Extract hotel_code from a canonical HTTPS Hilton hotel or reservation rooms URL without validating existence.

Browse the full Hilton docs

Use cases

What teams build on the Hilton API.

The same endpoints, pointed at different jobs. These are the ones we see most.

Destination discovery.

Find Hilton properties around a destination or address and retain their hotel codes.

Map hotel inventory.

Use coordinates to find properties and plot returned hotel locations.

Normalize hotel links.

Extract a consistent uppercase hotel code from a canonical Hilton property link.

Compare starting cash offers.

Use hotel_code with stay dates. Preserve exact published stay totals instead of multiplying rounded nightly averages; distinguish display currency from native_currency. The tax-and-service-charge flag does not cover every possible property fee.

Inspect opening status.

Keep opening dates, reservation status, and seasonal closure fields alongside hotel metadata.

Also over MCP

Hilton data, inside your AI agent.

The same endpoints are exposed as MCP tools. Connect Claude, Cursor, or Claude Code, ask in plain English, and the agent calls the tool and answers from live Hilton data.

See the MCP setup Read the MCP docs

Claude

Find Hilton hotels in London and include their opening status.

Used hilton_search 2.41s

The response includes Hilton hotel codes, addresses, and opening status. Prices and stay availability are outside this endpoint's scope.

Pricing

50 free requests on signup.
Pick a plan when you need more.

Flat monthly plans, every endpoint included on every plan. 1 request = 1 credit. No per-endpoint multipliers, no surprise overages.

01 Free

Wire it up. See the schema.

$0 to start

50 free requests on signup
Every endpoint included
No credit card required
Same schema as paid

Start free

02 Basic

Kick the tires in production.

$49 per month

1,500 requests / month
Every endpoint included
Per-endpoint usage dashboard
Email support

Start Basic

What people ask about the Hilton API.

Don't see your question? Email us at info@stayapi.com.

How do I search Hilton hotels?

Call Hotel Search with a destination or address query, or a latitude and longitude pair. Do not combine the two modes. Results contain English metadata.

Does the Hilton API return rates or rooms?

Yes. Rooms returns dated room types and one starting cash offer per room type. One room with no children is fixed; choose 1–4 adults and USD or GBP. Full rate plans and points offers are not included.

What is a Hilton hotel code?

The seven-character hotel_code is Hilton's ctyhocn identifier, for example LONHITW. Search returns it, and URL resolution extracts it without checking whether a property exists.

Which Hilton URLs can I resolve?

Use a canonical HTTPS hilton.com or www.hilton.com hotel URL, or a reservation rooms URL containing one valid ctyhocn. See URL to Hotel ID for validation and normalization rules.

Does total mean all Hilton hotels in a destination?

No. total is the number returned in this response. The limit defaults to 20 and accepts 1 to 150. No pagination parameter is supported.

Two ways to start.

Both end with live Hilton data in your stack. The fast path is on the left.

01 · the fast path

Try it free

50 free requests after sign up. Fastest way to see if the schema fits.