GET

Otelpuan Hotel Search API

Find hotel suggestions by name and use their IDs for reviews.

Copy for your AI agent

Paste into Claude, ChatGPT, Cursor or Copilot — endpoint, parameters, response fields and a curl example in Markdown.

Overview

Find Otelpuan hotel suggestions by name with StayAPI. Get hotel IDs, names, canonical URLs, and location labels, then use hotel_id to read guest reviews.

Scope

Hotel-only autocomplete suggestions, not exhaustive city inventory. No page, limit, or filter controls. An empty match returns success with hotels: [] and total: 0. Pass a returned hotel_id directly to Hotel Reviews; no URL resolver call is needed.

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/otelpuan/search

Parameters

Parameter	Type	Required	Description
query	string	Required	Hotel name query, 2–200 characters after trimming surrounding whitespace. Unicode is accepted; control characters and dot-only path segments ("." or "..") are rejected.

Response schema

Field	Type	Description
success / query	boolean / string	Success flag and the trimmed query.
hotels	array	Hotel suggestions with hotel_id, name, canonical url, and nullable location label. No ratings or review counts are returned.
total	integer	Number of hotel suggestions returned, not the total inventory for a city.

Errors and limitations

Errors use RFC 7807 Problem Details with provider: "otelpuan", an instance and correlation id.

400 INVALID_QUERY: query must contain 2–200 characters after trimming and contain no control characters or dot-only path segments.
422: query is required.
502 UPSTREAM_ERROR or 504 UPSTREAM_TIMEOUT: the source request could not complete.
503: service temporarily unavailable.
500 CONTENT_EXTRACTION_FAILED: the source response could not be interpreted.

Related resources

Check rooms and prices for a stay Search for hotel IDs by name Resolve a URL to a hotel ID Read reviews by hotel ID Otelpuan API overview Use Otelpuan tools through MCP

Request

curl -X GET "https://api.stayapi.com/v1/otelpuan/search?query=Turkler" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch("https://api.stayapi.com/v1/otelpuan/search?query=Turkler", { headers: { "X-API-Key": "YOUR_API_KEY" } });
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

import requests

response = requests.get("https://api.stayapi.com/v1/otelpuan/search?query=Turkler", headers={"X-API-Key": "YOUR_API_KEY"})
response.raise_for_status()
print(response.json())

Response

{
  "success": true,
  "query": "Turkler",
  "hotels": [
    {
      "hotel_id": "25322",
      "name": "Türkler Otel",
      "url": "https://www.otelpuan.com/Turkler-Otel",
      "location": "Trabzon Şehir Merkezi"
    }
  ],
  "total": 1
}