# Vietnam Transit Scraper - VNR Trains & Intercity Bus (`jungle_synthesizer/vietnam-transit-scraper`) Actor Vietnam transit via Vexere: Vietnam Railways (Reunification Express, Hà Nội-Sa Pa sleeper) with train numbers, seat-class fares in VND, bilingual VI/EN station names, plus intercity buses with sleeper-bed/cabin types and pickup/dropoff points. - **URL**: https://apify.com/jungle\_synthesizer/vietnam-transit-scraper.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Travel, Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Vietnam Transit Scraper — VNR Trains & Intercity Bus Scrape Vietnam transit data from the [Vexere aggregator](https://vexere.com/), the largest Vietnamese ticket platform. Returns Vietnam Railways (VNR) train schedules — including the Reunification Express Hà Nội ↔ HCMC and the Hà Nội ↔ Sa Pa sleeper — alongside intercity bus services across major operators, with bilingual Vietnamese / English station names and fares in Vietnamese đồng. --- ### Vietnam Transit Scraper Features - Returns Vietnam Railways (VNR) services with train numbers (SE1, SE3, SE5, SNT2, ...) and seat-class information. - Surfaces intercity buses across major Vietnamese carriers (Phương Trang/Futa, Hoàng Long, The Sinh Tourist, Mai Linh) with bus-type detail — Sleeper Bed, Sleeper Cabin, Seat 45, Limousine 9. - Three modes — `daily_summary` for aggregate counts and fare ranges, `train_search` for per-train listings, `bus_search` for per-trip listings. Pick what you need, skip what you don't. - Bilingual fields: every station carries a Vietnamese name with diacritics and an English fallback. The data isn't useful if half your team can't read it. - Sleeper detection — flags overnight services so you can filter to the trains and cabin buses people actually book for the journey. - Bus pickup and dropoff points include district names and lat/lon coordinates. Geocoded out of the box. - No browser, no proxy required. Pure JSON API, fast and cheap. - Pay-per-event pricing: $0.10 per actor start + $0.001 per record. --- ### What Can You Do With Vietnam Transit Data? - **Travel apps & itinerary planners** — Power Hà Nội ↔ Sa Pa sleeper bookings or Reunification Express search without scraping the official VNR site, which is gated behind login plus an obfuscated payload cipher. - **Tourism platforms** — Track inventory, fare ranges, and seat-class availability for popular backpacker corridors (Hà Nội–HCMC, Đà Nẵng–Huế, HCMC–Đà Lạt). - **MaaS startups** — Index intercity bus operators across Vietnam in one schema. Vexere covers ~500 carriers; you'd otherwise need to scrape each operator's site. - **Price-tracking dashboards** — Daily summary mode emits min/max/avg fares per A→B/date. Run it nightly, plot the curve. - **SE Asia rail enthusiasts** — Pull the full SE1–SE10 + SNT timetable on any date. The dataset includes carriage types and distances. --- ### How Vietnam Transit Scraper Works 1. Pick a mode — `daily_summary`, `train_search`, or `bus_search`. 2. Provide an origin and destination by city name (English, Vietnamese, with or without diacritics) or numeric Vexere city ID. The scraper resolves Hà Nội, HCMC, Đà Nẵng, Sa Pa, Đà Lạt, Nha Trang, Huế, Hội An, and 20+ other cities out of the box. 3. The scraper hits Vexere's `internal-vroute.vexere.com` API with a static FE Bearer token and polls until inventory populates (a few seconds for fresh queries). It handles the polling for you. 4. Records flow into the dataset with a stable schema, ready for export to CSV, JSON, or Excel. --- ### Input ```json { "mode": "train_search", "origin": "Hanoi", "destination": "Ho Chi Minh City", "date": "", "sleeperOnly": false, "maxItems": 15 } ```` | Field | Type | Default | Description | |-------|------|---------|-------------| | `mode` | string | `train_search` | One of `daily_summary`, `train_search`, `bus_search`. | | `origin` | string | `Hanoi` | Origin city. English, Vietnamese with or without diacritics. | | `destination` | string | `Ho Chi Minh City` | Destination city, same format as origin. | | `originCityId` | integer | (none) | Override: numeric Vexere city ID. Use when the city isn't in the lookup table. | | `destinationCityId` | integer | (none) | Override: numeric Vexere city ID. | | `date` | string | today + 7 (ICT) | Travel date, `YYYY-MM-DD`. Empty defaults to a week out. | | `sleeperOnly` | boolean | `false` | Filter to overnight sleeper trains and sleeper-cabin buses. | | `maxItems` | integer | `15` | Maximum records returned. Tester runs the default; raise for production. | | `proxyConfiguration` | object | `{ "useApifyProxy": false }` | Proxy not required. | Bus search example (Hà Nội → Sa Pa): ```json { "mode": "bus_search", "origin": "Hanoi", "destination": "Sapa", "maxItems": 50 } ``` Daily summary example (HCMC → Nha Trang): ```json { "mode": "daily_summary", "origin": "Ho Chi Minh City", "destination": "Nha Trang", "date": "2026-06-15" } ``` *** ### Vietnam Transit Scraper Output Fields #### Train search (`mode: "train_search"`) ```json { "record_type": "train", "service_id": "VNR|SE7|2026-05-08|06:00|HNO|SGO", "operator": "Vietnam Railways Corporation", "operator_code": "VNR", "service_type": "rail", "origin_station": "Hà Nội", "origin_station_en": "Ha Noi", "origin_station_code": "HNO", "destination_station": "Sài Gòn", "destination_station_en": "Saigon", "destination_station_code": "SGO", "departure_date": "2026-05-08", "departure_time": "06:00", "arrival_date": "2026-05-09", "arrival_time": "17:35", "duration_minutes": 2495, "train_number": "SE7", "seats_available": 117, "distance_km": 1726, "is_sleeper": true, "route_url": "https://vexere.com/", "scraped_at": "2026-05-01T16:38:29.217Z" } ``` | Field | Type | Description | |-------|------|-------------| | `record_type` | string | `train`. | | `service_id` | string | Vexere idIndex — `VNR\|\|\|