# Virail Train & Bus Trip Scraper (`crawlerbros/omio-scraper`) Actor Scrape Virail - a free multi-modal travel search comparison site. Search real train and bus trip options between any two cities with prices, times, and operators. - **URL**: https://apify.com/crawlerbros/omio-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Travel, Automation, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Virail Train & Bus Trip Scraper Scrape **Virail** — a free multi-modal travel search comparison site — for real train and bus trip options between any two cities. Get departure/arrival stations and times, operators, and prices. No login, no cookies required. ### Data Source & Usage Notes **Read this before running a large job.** - **No login required.** Virail's route pages are server-rendered and embed every trip option directly in the page's own schema.org structured data — no login, cookies, or API key needed. - **Conservative by design.** The actor only ever uses Apify's free datacenter (AUTO) proxy group — never a paid residential proxy. - **Not affiliated with Virail.** This is an independent third-party tool using the source's own public, no-login route pages. #### Why Virail instead of Omio? This actor was originally scoped as an Omio (omio.com) multi-modal trip search. Live verification (including from Apify's own cloud infrastructure, with and without the AUTO proxy group) showed omio.com returns Cloudflare 403 challenges on every route request, from every tested IP — a persistent platform-level block, not a transient rate limit. Per this project's zero-cost reliability policy, the target was replaced with Virail — a comparable free, no-login, multi-modal (train/bus) trip search site, confirmed live and returning real structured trip data from Apify's cloud infrastructure. ### What this actor does - **Train and/or bus search** between any two cities, in one search - **Full trip detail** for every option Virail lists: operator, departure/arrival stations and times, and price - **Sort by** recommended (site order), price low-to-high, or departure time - **Max price filter** - **Empty fields are omitted** — a field only appears on a record when real data was found for it ### Output per trip option - `transportType` — `train` or `bus` - `origin`, `destination` — as given in the search input - `sourceUrl` — the Virail route page this trip was scraped from - `operator` — the carrier running this specific trip (e.g. "Eurostar", "BlaBlaCar Bus") - `departureStation`, `departureTime` - `arrivalStation`, `arrivalTime` - `price`, `currency` - `availability` — e.g. `InStock`, when Virail publishes it - `recordType: "trip"`, `scrapedAt` ### Input | Field | Type | Default | Description | |---|---|---|---| | `origin` | string | `London` | Departure city | | `destination` | string | `Paris` | Arrival city | | `transport` | string | `train` | `train` / `bus` / `both` | | `sortBy` | string | `recommended` | `recommended` / `priceLowToHigh` / `departureTime` | | `maxPrice` | number | – | Only return trips at or below this price | | `maxItems` | int | `20` | Hard cap (1–200) | #### Example: search trains between two cities ```json { "origin": "London", "destination": "Paris", "transport": "train", "maxItems": 20 } ```` #### Example: search both train and bus, cheapest first ```json { "origin": "Berlin", "destination": "Amsterdam", "transport": "both", "sortBy": "priceLowToHigh", "maxItems": 30 } ``` #### Example: filter by max price ```json { "origin": "Madrid", "destination": "Barcelona", "transport": "train", "maxPrice": 50, "maxItems": 20 } ``` ### Use cases - **Travel planning** — compare real train/bus options and prices between two cities - **Price monitoring** — track fares for a route over time - **Fare research** — see which operators serve a given route and at what price ### FAQ **What's the data source?** Virail's own free public trip search at `virail.com`. This actor is an independent third-party tool and is not affiliated with Virail. **Why did my run return 0 results?** Virail genuinely has no listed route between the two cities you searched (common for far-apart or poorly-connected city pairs), or the city name didn't resolve to one Virail recognizes — try a well-known city name, e.g. "Paris" rather than a small suburb. **Are prices live?** Prices reflect what Virail's own page shows at the moment of the search, aggregated from the operators Virail tracks for that route — always verify the final price on the operator's own booking page before purchasing (this actor does not book tickets). **How fresh is the data?** Real-time — the search reflects Virail's own route page as of the moment of the search. # Actor input Schema ## `origin` (type: `string`): Departure city, e.g. 'London'. ## `destination` (type: `string`): Arrival city, e.g. 'Paris'. ## `transport` (type: `string`): Which mode(s) to search. ## `sortBy` (type: `string`): How to order results. ## `maxPrice` (type: `number`): Only return trips at or below this price (in the currency Virail itself returns, typically USD). Leave blank for no limit. ## `maxItems` (type: `integer`): Hard cap on the number of trip options to return. ## Actor input object example ```json { "origin": "London", "destination": "Paris", "transport": "train", "sortBy": "recommended", "maxItems": 20 } ``` # Actor output Schema ## `trips` (type: `string`): Dataset containing all scraped Virail trip options. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "origin": "London", "destination": "Paris", "transport": "train", "sortBy": "recommended", "maxItems": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/omio-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "origin": "London", "destination": "Paris", "transport": "train", "sortBy": "recommended", "maxItems": 20, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/omio-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "origin": "London", "destination": "Paris", "transport": "train", "sortBy": "recommended", "maxItems": 20 }' | apify call crawlerbros/omio-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/omio-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Virail Train & Bus Trip Scraper", "description": "Scrape Virail - a free multi-modal travel search comparison site. Search real train and bus trip options between any two cities with prices, times, and operators.", "version": "1.0", "x-build-id": "Vkdz9quLTz9eLzmEj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~omio-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-omio-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/crawlerbros~omio-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-omio-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/crawlerbros~omio-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-omio-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "origin", "destination" ], "properties": { "origin": { "title": "Origin", "type": "string", "description": "Departure city, e.g. 'London'.", "default": "London" }, "destination": { "title": "Destination", "type": "string", "description": "Arrival city, e.g. 'Paris'.", "default": "Paris" }, "transport": { "title": "Transport mode", "enum": [ "train", "bus", "both" ], "type": "string", "description": "Which mode(s) to search.", "default": "train" }, "sortBy": { "title": "Sort order", "enum": [ "recommended", "priceLowToHigh", "departureTime" ], "type": "string", "description": "How to order results.", "default": "recommended" }, "maxPrice": { "title": "Max price", "type": "number", "description": "Only return trips at or below this price (in the currency Virail itself returns, typically USD). Leave blank for no limit." }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 200, "type": "integer", "description": "Hard cap on the number of trip options to return.", "default": 20 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```