GET

Wyndham URL to Hotel ID API

Resolve a public Wyndham hotel URL to its numeric property ID.

Overview

GraphQL resolution only

StayAPI extracts the hotel slug locally and resolves it through Wyndham's GraphQL property service. The hotel page is never requested, and there is no Browserless or browser-automation fallback.

Use this endpoint when you have a canonical wyndhamhotels.com URL but need the numeric property_id accepted by Wyndham Rooms. Wyndham Search also returns the same identifier.

Endpoint URL

GET https://api.stayapi.com/v1/wyndham/hotel/url-to-id

Authenticate with X-API-Key: YOUR_API_KEY.

Query parameter

Parameter	Type	Required	Rules
url	URL string	Yes	HTTP or HTTPS URL on `wyndhamhotels.com` or a subdomain. It must contain a hotel-specific slug, for example `/laquinta/forsyth-georgia/la-quinta-forsyth/overview`.

Response schema

url: normalized input URL with a lowercase host and no query string or fragment.
property_id: numeric Wyndham identifier used by Rooms.
name and brand_code: nullable property metadata returned by GraphQL.

Errors and limitations

Errors follow RFC 7807 Problem Details with provider: "wyndham", product: "url-to-id", the supplied provided_url, and a correlation_id.

400 INVALID_URL: invalid scheme or non-Wyndham host.
400 PROPERTY_SLUG_NOT_FOUND: valid Wyndham host without a hotel slug.
404 PROPERTY_NOT_FOUND: GraphQL found no matching property.
502 UPSTREAM_ERROR: Wyndham GraphQL failed or returned an ambiguous result.

This resolver accepts canonical Wyndham hotel URLs, not city pages or free-form hotel names. It is not paginated or cached.

Request

curl -G "https://api.stayapi.com/v1/wyndham/hotel/url-to-id" \
  -H "X-API-Key: YOUR_API_KEY" \
  --data-urlencode "url=https://www.wyndhamhotels.com/laquinta/forsyth-georgia/la-quinta-forsyth/overview"

const params = new URLSearchParams({
  url: "https://www.wyndhamhotels.com/laquinta/forsyth-georgia/la-quinta-forsyth/overview"
});
const response = await fetch(`https://api.stayapi.com/v1/wyndham/hotel/url-to-id?${params}`, {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
console.log(await response.json());

import requests

response = requests.get(
    "https://api.stayapi.com/v1/wyndham/hotel/url-to-id",
    params={"url": "https://www.wyndhamhotels.com/laquinta/forsyth-georgia/la-quinta-forsyth/overview"},
    headers={"X-API-Key": "YOUR_API_KEY"},
)
print(response.json())

require "net/http"
require "uri"

uri = URI("https://api.stayapi.com/v1/wyndham/hotel/url-to-id")
uri.query = URI.encode_www_form(url: "https://www.wyndhamhotels.com/laquinta/forsyth-georgia/la-quinta-forsyth/overview")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = "YOUR_API_KEY"
puts Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(request) }.body

Response

{
  "success": true,
  "url": "https://www.wyndhamhotels.com/laquinta/forsyth-georgia/la-quinta-forsyth/overview",
  "property_id": "53089",
  "name": "La Quinta Inn & Suites by Wyndham Forsyth",
  "brand_code": "LQ"
}

{
  "type": "https://api.stayapi.com/errors/property-not-found",
  "title": "Property Not Found",
  "status": 404,
  "detail": "No Wyndham property matched the hotel URL",
  "instance": "/v1/wyndham/hotel/url-to-id",
  "provider": "wyndham",
  "product": "url-to-id",
  "error_code": "PROPERTY_NOT_FOUND",
  "provided_url": "https://www.wyndhamhotels.com/laquinta/example/example/overview",
  "correlation_id": "req_abc123"
}