Hotel name search
Fuzzy search for hotels by name — handles typos, partial matches, and diacritics normalization.
Fuzzy search for a hotel by name. Handles exact matches, partial matches, typos, and diacritics
normalization (e.g. "peremé" matches "Pereme").
Permission: Read
Two equivalent forms are available — pick whichever fits your client better.
GET /api/v1/hotels/name-search| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | Yes | — | Hotel name or partial name |
limit | integer | No | 10 | Max results, 1–100 |
min_score | float | No | 60 | Minimum match score, 0–100 |
include_location | boolean | No | true | Include address, city, country |
include_details | boolean | No | false | Return full hotel data per match |
curl --get \
--url https://api.fx-port.com/api/v1/hotels/name-search \
--header 'Authorization: Bearer fxp_test_YOUR_KEY' \
--data-urlencode 'query=Sofitel' \
--data-urlencode 'limit=5' \
--data-urlencode 'min_score=50'Response example
{
"environment": "sandbox",
"query": "Sofitel",
"results_count": 3,
"search_time": "0.235s",
"hotels": [
{
"id": "sofitel_algiers_hamma_garden",
"name": "Sofitel Algiers Hamma Garden",
"match_score": 95.5,
"match_type": "fuzzy",
"address": "172 Rue Hassiba Ben Bouali, Algiers",
"city": "Algiers",
"country_code": "DZ",
"postal_code": "16000"
}
]
}With include_details: true, each entry in hotels[] is the full cached hotel document instead
of the compact match summary above.
Field reference
| Field | Description |
|---|---|
match_score | 0–100 similarity score |
match_type | exact, partial, or fuzzy |
id | Pass this as id on search_advanced or get_rates |
Edge cases
// Typos — still matches
{ "query": "softel algirs" }
// Diacritics — normalized both ways
{ "query": "peremé" }
// Partial name
{ "query": "hilton" }POST /api/v1/hotels/search_advanced
Search hotels by geo-radius or a specific hotel ID, with live availability and indicative pricing. Supports streaming (SSE) for large result sets.
POST /api/v1/hotels/get_hotel_info
Full hotel detail — rooms, amenities, policies, images, and facts. Tries cache first, falls back to the supplier.