GET

Hilton Search API - Hotel Metadata

Find undated Hilton hotel inventory by destination or coordinates.

Overview

Search Hilton hotels by destination, address, or coordinates with StayAPI. Get hotel codes, location, photos, amenities, and opening status as English JSON.

Scope

Supply query OR both latitude and longitude. English content only. No dates, prices, room inventory, or stay availability. Results can include unopened or seasonally closed properties: inspect status. There is no pagination or sort parameter; total counts returned hotels only. Use hotel_code with Rooms for dated starting cash offers.

Authentication

Send your StayAPI key in the X-API-Key header. Successful requests return JSON; failures use RFC 7807 Problem Details.

Endpoint URL

GET https://api.stayapi.com/v1/hilton/search

Parameters

Parameter	Type	Required	Description
query	string	Optional	Destination or address, 2–200 characters after trimming. Required unless both coordinates are supplied; mutually exclusive with coordinates.
latitude	number	Optional	Finite latitude, -90 to 90 inclusive. Requires longitude and no query.
longitude	number	Optional	Finite longitude, -180 to 180 inclusive. Requires latitude and no query.
limit	integer	Optional	Maximum hotels returned, 1 to 150. Default: 20.

Response schema

Field	Type	Description
success	boolean	True on a successful response.
hotels	array	Hotel metadata; no prices or dated availability.
hotels[].hotel_code	string	Seven-character Hilton ctyhocn identifier, for example LONHITW.
hotels[].name / brand_code / phone / url	string	Hotel name and nullable brand code, telephone, and public URL.
hotels[].address	object	Nullable street, city, state, and country_code.
hotels[].location	object	Nullable latitude and longitude.
hotels[].photos / amenity_ids	array	Photos with url and nullable caption; published amenity identifiers.
hotels[].rating / review_count	number	Nullable published score and review count.
hotels[].status	object	Nullable open, open_date, reservations_enabled, reservations_enabled_date, seasonally_closed, and seasonal_reopen_date. These describe property status, not availability for a stay.
total	integer	Number of hotels returned, not a global inventory count.
location_match	object or null	Matched destination name, type, and location coordinates when provided.

Errors and limitations

Errors use RFC 7807 Problem Details with provider: "hilton" and a correlation id.

400 INVALID_INPUT: invalid search form, hotel code, dates, occupancy, or currency.
400 INVALID_URL: supply a canonical HTTPS Hilton hotel or reservation rooms URL.
422: a required parameter is missing or a typed parameter is outside its declared contract.
502 UPSTREAM_ERROR: Hilton data could not be retrieved or verified. An unverified sold-out rooms result also returns an error.
504: the request timed out.
503: service temporarily unavailable; honor Retry-After when supplied.

Related Hilton endpoints

Search hotel metadata and codes Dated rooms and starting cash rates Extract a Hilton hotel code

Request

curl -X GET "https://api.stayapi.com/v1/hilton/search?query=London&limit=20" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch("https://api.stayapi.com/v1/hilton/search?query=London&limit=20", {headers: {"X-API-Key": "YOUR_API_KEY"}});
if (!response.ok) throw new Error(await response.text());
console.log(await response.json());

import requests
response = requests.get("https://api.stayapi.com/v1/hilton/search?query=London&limit=20", headers={"X-API-Key": "YOUR_API_KEY"})
response.raise_for_status()
print(response.json())

<?php
$ch = curl_init('https://api.stayapi.com/v1/hilton/search?query=London&limit=20');
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY']]);
echo curl_exec($ch);
curl_close($ch);

require "net/http"
require "json"
uri = URI("https://api.stayapi.com/v1/hilton/search?query=London&limit=20")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = "YOUR_API_KEY"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
puts JSON.parse(response.body)

Response

{
  "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
}

{
  "type": "about:blank",
  "title": "Invalid Input",
  "status": 400,
  "detail": "Invalid Hilton input.",
  "provider": "hilton",
  "error_code": "INVALID_INPUT"
}