# Hostelworld API: Search hostels > Finds available hostels, hotels and guesthouses on Hostelworld in a city for given dates, with per-night dorm and private room prices, ratings, facilities and booking links. Unofficial. Not affiliated with or endorsed by Hostelworld. - Page: https://fous.com/methods/hostelworld.com/search-hostels - Method: `hostelworld.com/search_hostels`, version 1 - Website: hostelworld.com - Returns: name, type, rating, reviews, distance, lowest dorm and private prices, free cancellation, facilities, link - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `city` | string | yes | `"Berlin"` | City to search, for example Berlin or Berlin, Germany. | | `sort` | string | no | | Order results, for example price_low_to_high. One of "recommended", "price_low_to_high", "rating". Default "recommended". | | `guests` | integer | no | | Number of travellers, for example 2. Default 1. | | `check_in` | string | yes | `"2026-11-20"` | Arrival date, for example 2026-10-20. | | `currency` | string | no | | Three-letter price currency, for example EUR. Default "USD". | | `check_out` | string | yes | `"2026-11-22"` | Departure date, for example 2026-10-22. | | `room_type` | string | no | | Only include properties with this room type available, for example dorm. One of "any", "dorm", "private". Default "any". | | `max_results` | integer | no | | Maximum number of properties to return, for example 20. Default 20. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "city": "Berlin", "check_in": "2026-11-20", "check_out": "2026-11-22" } ``` Its output: ```json { "hostels": [ { "link": "https://www.hostelworld.com/pwa/hosteldetails.php/Circus-Hostel/Berlin/703?from=2026-10-20&to=2026-10-22&guests=1", "name": "Circus Hostel", "type": "hostel", "rating": 9.3, "property_id": 703, "rating_label": "Superb", "review_count": 8081, "main_facilities": [ "Free WiFi", "Wi-Fi", "Common Room" ], "free_cancellation": true, "distance_from_city_centre_km": 1.01, "lowest_dorm_bed_price_per_night": { "amount": 26.41, "currency": "USD" }, "lowest_private_room_price_per_night": { "amount": 101.56, "currency": "USD" } }, { "link": "https://www.hostelworld.com/pwa/hosteldetails.php/St-Christopher-s-Berlin-Mitte/Berlin/15426?from=2026-10-20&to=2026-10-22&guests=1", "name": "St Christopher's Berlin - Mitte", "type": "hostel", "rating": 8.3, "property_id": 15426, "rating_label": "Fabulous", "review_count": 10426, "main_facilities": [ "Free WiFi", "Wi-Fi", "Linen Included" ], "free_cancellation": true, "distance_from_city_centre_km": 1.28, "lowest_dorm_bed_price_per_night": { "amount": 21.48, "currency": "USD" }, "lowest_private_room_price_per_night": { "amount": 122.75, "currency": "USD" } }, { "link": "https://www.hostelworld.com/pwa/hosteldetails.php/MEININGER-Berlin-East-Side-Gallery/Berlin/280374?from=2026-10-20&to=2026-10-22&guests=1", "name": "MEININGER Berlin East Side Gallery", "type": "hostel", "rating": 8.8, "property_id": 280374, "rating_label": "Fabulous", "review_count": 2158, "main_facilities": [ "Free WiFi", "Wi-Fi", "Common Room" ], "free_cancellation": true, "distance_from_city_centre_km": 2.37, "lowest_dorm_bed_price_per_night": { "amount": 33.28, "currency": "USD" }, "lowest_private_room_price_per_night": { "amount": 114.16, "currency": "USD" } } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"hostelworld.com/search_hostels","input":{"city":"Berlin","check_in":"2026-11-20","check_out":"2026-11-22"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Find cheap dorm beds in Lisbon for 2 people from 2026-05-14 to 2026-05-18, sorted by lowest price, prices in EUR - What are the best-rated hostels on Hostelworld in Budapest for check-in June 3 and check-out June 6, 2026? - I'm travelling solo to Mexico City, arriving 2026-11-02 and leaving 2026-11-07 — show me hostels with private rooms, ideally with free cancellation - Pull up to 10 places to stay in Kyoto, Japan for 4 friends, March 20–24 2027, prices in JPY - Search Hostelworld for hostels in Amsterdam for 3 guests, 2026-08-09 to 2026-08-11, include ratings, distance from centre and booking links ## Input schema ```json { "type": "object", "required": [ "city", "check_in", "check_out" ], "properties": { "city": { "type": "string", "minLength": 1, "description": "City to search, for example Berlin or Berlin, Germany." }, "sort": { "enum": [ "recommended", "price_low_to_high", "rating" ], "type": "string", "default": "recommended", "description": "Order results, for example price_low_to_high." }, "guests": { "type": "integer", "default": 1, "maximum": 8, "minimum": 1, "description": "Number of travellers, for example 2." }, "check_in": { "type": "string", "format": "date", "description": "Arrival date, for example 2026-10-20." }, "currency": { "type": "string", "default": "USD", "pattern": "^[A-Za-z]{3}$", "description": "Three-letter price currency, for example EUR." }, "check_out": { "type": "string", "format": "date", "description": "Departure date, for example 2026-10-22." }, "room_type": { "enum": [ "any", "dorm", "private" ], "type": "string", "default": "any", "description": "Only include properties with this room type available, for example dorm." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum number of properties to return, for example 20.", "x-fous-developer": true } }, "additionalProperties": false } ``` ## Output schema ```json { "type": "object", "required": [ "hostels" ], "properties": { "hostels": { "type": "array", "items": { "type": "object", "required": [ "name", "type", "rating", "rating_label", "review_count", "distance_from_city_centre_km", "lowest_dorm_bed_price_per_night", "lowest_private_room_price_per_night", "free_cancellation", "main_facilities", "link", "property_id" ], "properties": { "link": { "type": "string" }, "name": { "type": "string" }, "type": { "enum": [ "hostel", "hotel", "guesthouse" ], "type": "string" }, "rating": { "type": [ "number", "null" ], "description": "Overall rating out of 10." }, "property_id": { "type": "integer", "x-fous-developer": true }, "rating_label": { "type": [ "string", "null" ] }, "review_count": { "type": "integer" }, "main_facilities": { "type": "array", "items": { "type": "string" } }, "free_cancellation": { "type": "boolean" }, "distance_from_city_centre_km": { "type": [ "number", "null" ] }, "lowest_dorm_bed_price_per_night": { "type": [ "object", "null" ], "required": [ "amount", "currency" ], "properties": { "amount": { "type": "number" }, "currency": { "type": "string" } } }, "lowest_private_room_price_per_night": { "type": [ "object", "null" ], "required": [ "amount", "currency" ], "properties": { "amount": { "type": "number" }, "currency": { "type": "string" } } } }, "additionalProperties": false } } }, "additionalProperties": false } ``` ## See more - [Agoda API: Search hotels](https://fous.com/methods/agoda.com/search-hotels.md): Finds available Agoda stays in a city for your dates, with prices before taxes and fees, star and guest ratings, and free-cancellation status. - [Trip.com API: Search hotels](https://fous.com/methods/trip.com/search-hotels.md): Finds hotels in a city on Trip.com for given dates, with prices, guest ratings, reviews and booking links. Only the initial public listing is read, so large limits may return fewer hotels. - [Expedia API: Search hotels](https://fous.com/methods/expedia.com/search-hotels.md): Finds Expedia hotels in a destination for given dates, with public USD prices, reviews, property class, refund status and links. Nightly prices are per room; totals include all requested rooms, taxes and fees. - [Booking.com API: Search stays](https://fous.com/methods/booking.com/search-stays.md): Searches Booking.com stays by destination and dates, with guest counts, price, review, cancellation, sorting and paging. Displayed prices generally exclude some taxes and fees; children are searched as age 8. - [Airbnb API: Search stays](https://fous.com/methods/airbnb.com/search-stays.md): Searches public Airbnb homes for a destination and travel dates. Each stay comes with its price, rating, room details and listing link. Prices are the displayed trip totals, including fees. - [Kayak API: Search hotels](https://fous.com/methods/kayak.com/search-hotels.md): Compares Kayak hotel nightly rates across booking sites for a city or neighborhood and stay dates (two adults, one room). - [Priceline API: Search hotels](https://fous.com/methods/priceline.com/search-hotels.md): Find publicly priced Priceline hotels in a place for your travel dates, with guest ratings, nightly and total USD prices, and cancellation information. Excludes hotels hidden behind anonymous deals and sign-in-only prices. - [Agoda API: Get room prices](https://fous.com/methods/agoda.com/get-room-prices.md): Finds room offers and nightly prices for one Agoda hotel on selected dates. Totals are calculated from displayed nightly prices before taxes and fees; final checkout totals may differ.