Alibaba Travel

Look up the city codes the other tools take (THR for Tehran, MHD for Mashhad) and what is sold for each city. Use first when the user names a city: pass the returned `code` to al_trains, al_buses or al_flights. `train` is true for cities with a station, `flight` for cities with a domestic airport. Buses use the same codes (a tiny train stop may have no buses). With international=true it searches the whole world (Dubai, Istanbul, Paris) and returns airports; `whole_city` rows (code ending in ALL) cover every airport of a city.

Search train tickets between two Iranian cities on one day: company, class, times, price and seats left. Use for "trains from Tehran to Mashhad on 1405-08-20". Prices are Toman per adult. `seats_left` 0 means sold out. `class` is the wagon name (stars, berths, meals) and `class_code` its type: S saloon seats, EC 4-berth compartment, EL 6-berth compartment, V special. Pass return_date for the way back. Call al_trains_cheapest to compare prices over the following days. While the rail suppliers are in their maintenance window (usually after midnight) the site answers with an error; try again in a few minutes.

List the lowest train price for each day from a start date, to pick the cheapest day to travel. Use before al_trains when the date is flexible. Prices are Toman per adult; a missing day has no train.

Search intercity bus tickets between two Iranian cities on one day: company, bus type, times, price, seats. Use for "buses from Tehran to Shiraz tomorrow". Prices are Toman per adult. `from_terminal` is the terminal of that departure (Tehran has several). Bus tickets carry no arrival time on the site.

List the lowest bus price and the number of buses for each day from a start date (the site has no bus calendar). Use before al_buses when the date is flexible. It runs one search per day, so keep `days` small. Prices are Toman per adult for buses with a free seat; a day with none shows no price.

Show which seats are free on one bus: counts per status and the free seat numbers (no booking). Use after al_buses when the user cares where they sit or asks how full a bus is. Pick the bus by its departure time (and company). `layout` gives each seat's row and column (columns 1-2 left of the aisle, 4-5 right) so pairs can be found; statuses mean Available, booked for a male or female passenger, or Blocked (not for sale).

Search domestic flights between two Iranian airports on one day: airline, flight number, times, fare, seats. Use for "flights from Tehran to Shiraz on 2026-11-12". Prices are Toman per adult (`child_price_toman` and `infant_price_toman` for the others); one flight can appear several times with different fare classes. Pass return_date for a round trip, refund_rules for the cancellation fee table, adults/children/infants for a group. For other days call al_flights_cheapest first. For flights abroad use al_flights_international.

List the lowest domestic fare for each day from a start date, to pick the cheapest day to fly. Use before al_flights when the date is flexible. Prices are Toman per adult; a day with no flight is missing.

Search international flights between Iran and abroad (or any two cities Alibaba sells) on one day. Use for "flights from Tehran to Istanbul on 2026-11-16". Returns airline, flight numbers, times, stops, baggage and the price per adult in Toman (`total_toman` is for the whole group); cheapest first by default. Pass return_date for a round trip: each fare then has a `return` leg. Cities and codes come from al_cities with international=true (THRALL = all Tehran airports). Charter fares are sold as one fare class. It can take 10-20 seconds because airlines answer one by one (at most 12 polls per call). To buy, send the user to alibaba.ir.

Search villas, suites, cottages and other holiday homes for rent in a city, with price, rating and capacity. Use for "a villa in Masuleh for 4 people next weekend". Prices are Toman: `price_per_night_toman` is the average for the stay, `price_total_toman` the whole stay (VAT not included). The sort applies to the first 100 places the site returns (`found` is the full count). Call al_stay_detail with an `id` for the calendar, rules and amenities. The listings are Jabama's, sold through alibaba.ir.

Show one villa or holiday home in full: capacity, beds, amenities, house rules, cancellation terms, calendar, reviews. Use after al_stays when the user wants to decide on a place. Prices are Toman per night (`price_base` weekday, `price_weekend`, `price_holiday`); `calendar` lists the next days with `available` or not and the night's price. Guest names are left out.

Search hotels in a city for a stay: stars, rating, price for the whole stay, meal plan, perks (domestic and abroad). Use for "a 4-star hotel in Mashhad for 2 nights from 1405-08-21". Prices are Toman for the room for all nights (`price_per_night_toman` is the average). The site's own page shows the same list and count. It can take up to a few seconds while hotels answer.

Search tour packages (round trip plus hotel) from a city to a destination such as Kish, Mashhad, Istanbul or Dubai. Use for "a 3-night Kish tour for two from Tehran next week". Each result is a hotel with the cheapest package: hotel, stars, rating, room, meal plan, how you travel, and the price per person and for the whole group in Toman. Results come in after a few seconds (at most 15 polls per call). To buy, send the user to alibaba.ir.

List the lowest tour price per person for 11 departure days around a date (5 before, 5 after), to pick the cheapest day. Use before al_tours when the date is flexible. Prices are Toman per person for a tour of `nights` nights; a day without tours is missing. Then call al_tours for the chosen day.