Skip to main content
POST
/
api
/
hostelworld
/
properties
/
search
/hostelworld/properties/search
curl --request POST \
  --url https://api.anysite.io/api/hostelworld/properties/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "city": "<string>",
  "count": 2,
  "timeout": 300,
  "check_in": "2026-08-15",
  "nights": 1,
  "guests": 1,
  "currency": "USD"
}
'
[
  {
    "id": "<string>",
    "@type": "@hostelworld_search_property",
    "url": "<string>",
    "name": "<string>",
    "property_type": "<string>",
    "description": "<string>",
    "star_rating": 123,
    "is_new": true,
    "is_featured": true,
    "is_promoted": true,
    "is_very_popular": true,
    "is_hostelworld_recommended": true,
    "has_free_cancellation": true,
    "sustainability_levels": [],
    "address": "<string>",
    "district": "<string>",
    "districts": [],
    "city": {
      "@type": "@hostelworld_city",
      "id": "<string>",
      "name": "<string>",
      "country": "<string>"
    },
    "country": "<string>",
    "latitude": 123,
    "longitude": 123,
    "distance_from_center": 123,
    "distance_unit": "<string>",
    "review_count": 123,
    "rating": {
      "@type": "@hostelworld_rating",
      "overall": 123,
      "value": 123,
      "security": 123,
      "location": 123,
      "staff": 123,
      "atmosphere": 123,
      "cleanliness": 123,
      "facilities": 123
    },
    "currency": "<string>",
    "lowest_price_per_night": 123,
    "lowest_dorm_price_per_night": 123,
    "lowest_private_price_per_night": 123,
    "promotions": [],
    "images": [],
    "facilities": []
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
city
string
required

City to search hostels in: a city name or a Hostelworld numeric city id

Minimum string length: 1
Examples:

"London"

"Berlin"

"Bangkok"

"3"

count
integer
required

Max number of results to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
check_in
string | null

Check-in date (YYYY-MM-DD) to return live nightly prices. Omit for listings without prices

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-08-15"

nights
integer
default:1

Number of nights for the stay

Required range: x >= 1
guests
integer
default:1

Number of guests

Required range: x >= 1
currency
string
default:USD

Currency for nightly prices

Required string length: 3

Response

Successful Response

id
string
required
@type
string
default:@hostelworld_search_property
url
string | null
name
string | null
property_type
string | null
description
string | null
star_rating
integer | null
is_new
boolean | null
is_promoted
boolean | null
has_free_cancellation
boolean | null
sustainability_levels
string[]
address
string | null
district
string | null
districts
string[]
city
HostelworldCity · object
country
string | null
latitude
number | null
longitude
number | null
distance_from_center
number | null
distance_unit
string | null
review_count
integer | null
rating
HostelworldRating · object
currency
string | null
lowest_price_per_night
number | null
lowest_dorm_price_per_night
number | null
lowest_private_price_per_night
number | null
promotions
HostelworldPromotion · object[]
images
string[]
facilities
HostelworldFacilityCategory · object[]