GET

Hilton URL to Hotel ID API - Extract Hotel Codes

Extract the seven-character Hilton hotel_code from a public URL.

Overview

Extract a Hilton hotel code from a canonical HTTPS hotel or reservation rooms URL with StayAPI. Get the seven-character ctyhocn and normalized URL as JSON.

Scope

Local extraction does not check whether a hotel exists. Accepts hilton.com or www.hilton.com over HTTPS: /en/hotels/{code}-{slug}/ or /en/book/reservation/rooms/?ctyhocn={code}, including supported locale prefixes. Tracking parameters and fragments are removed; conflicting or repeated ctyhocn values are rejected. Pass hotel_code to 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/hotel/url-to-id

Parameters

Parameter	Type	Required	Description
url	string	Required	Canonical HTTPS Hilton hotel or reservation rooms URL, at most 2,048 characters; no credentials, whitespace, or nonstandard port. Reservation URLs require exactly one valid ctyhocn.

Response schema

Field	Type	Description
success	boolean	True on successful extraction.
hotel_code	string	Uppercase seven-character ctyhocn identifier; existence is not validated.
url	string	Normalized HTTPS www.hilton.com URL, with tracking parameters and fragment removed.

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/hotel/url-to-id?url=https%3A%2F%2Fwww.hilton.com%2Fen%2Fhotels%2Flonhitw-london-hilton-on-park-lane%2F" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch("https://api.stayapi.com/v1/hilton/hotel/url-to-id?url=https%3A%2F%2Fwww.hilton.com%2Fen%2Fhotels%2Flonhitw-london-hilton-on-park-lane%2F", {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/hotel/url-to-id?url=https%3A%2F%2Fwww.hilton.com%2Fen%2Fhotels%2Flonhitw-london-hilton-on-park-lane%2F", headers={"X-API-Key": "YOUR_API_KEY"})
response.raise_for_status()
print(response.json())

<?php
$ch = curl_init('https://api.stayapi.com/v1/hilton/hotel/url-to-id?url=https%3A%2F%2Fwww.hilton.com%2Fen%2Fhotels%2Flonhitw-london-hilton-on-park-lane%2F');
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/hotel/url-to-id?url=https%3A%2F%2Fwww.hilton.com%2Fen%2Fhotels%2Flonhitw-london-hilton-on-park-lane%2F")
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,
  "hotel_code": "LONHITW",
  "url": "https://www.hilton.com/en/hotels/lonhitw-london-hilton-on-park-lane/"
}

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