# Italo Scraper - Italian High-Speed Train Fares (`studio-amba/italo-scraper`) Actor Scrape Italo high-speed train fares, schedules, and availability. Search Italian routes like Roma-Milano, Roma-Napoli, Firenze-Venezia to get train numbers, departure/arrival times, prices by class (Smart, Comfort, Prima, Club Executive), and seat availability. No login or cookies required. - **URL**: https://apify.com/studio-amba/italo-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** Travel - **Stats:** 2 total users, 1 monthly users, 75.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ### What does Italo Scraper do? **Italo Scraper** extracts high-speed train fares, schedules, and seat availability from [Italo](https://www.italotreno.com), Italy's premium private high-speed rail operator. Search any Italo route and get structured data including train numbers, departure and arrival times, journey durations, prices by travel class, and availability status. Italo operates high-speed trains (up to 300 km/h) on major Italian routes including Roma-Milano, Roma-Napoli, Firenze-Venezia, Torino-Napoli, and Bologna-Salerno. This actor extracts the same fare data you see when searching on italotreno.com. No login, cookies, or Italo account required. The actor runs on the [Apify platform](https://apify.com), giving you API access, scheduling, webhooks, and integrations with tools like Zapier, Make, Google Sheets, and Slack. ### Why use Italo Scraper? - **Price monitoring** — Track fare changes on popular routes like Roma-Milano or Roma-Napoli. Schedule daily runs to find the cheapest Italo tickets before they sell out. - **Travel comparison** — Compare Italo fares against Trenitalia (the other Italian high-speed operator) to find the best deal. Build travel aggregation dashboards. - **Revenue management research** — Analyze Italo's dynamic pricing patterns, class distribution, and availability across routes and dates. - **Business intelligence** — Hotels, tour operators, and travel agencies can use Italo schedule data to plan packages, coordinate transfers, and inform guests about train options. - **Academic research** — Study high-speed rail pricing, competition dynamics between Italo and Trenitalia, or Italian transport infrastructure. ### How to scrape Italo data 1. Go to the [Italo Scraper](https://apify.com/studio-amba/italo-scraper) page on Apify Store. 2. Click **Try for free** to open the actor in Apify Console. 3. Enter your **origin** and **destination** (e.g. "Roma" and "Milano"). 4. Optionally set a **departure date** (YYYY-MM-DD format). If omitted, it defaults to 14 days from today. 5. Click **Start** and wait for the run to complete. 6. Download your data as JSON, CSV, Excel, or connect it to your app via the Apify API. ### Input | Field | Type | Description | Default | |-------|------|-------------|---------| | `origin` | string | Departure city or station name | Roma | | `destination` | string | Arrival city or station name | Milano | | `departureDate` | string | Travel date (YYYY-MM-DD) | 14 days from now | | `passengers` | integer | Number of adult passengers (1-9) | 1 | | `maxResults` | integer | Maximum results to return | 50 | | `proxyConfiguration` | object | Proxy settings (IT residential recommended) | Apify Proxy | #### Example input ```json { "origin": "Roma", "destination": "Milano", "departureDate": "2026-07-15", "passengers": 1, "maxResults": 50 } ```` The actor automatically resolves common city names to the correct Italo station. You can use short names like "Roma", "Milano", "Napoli" or full station names like "Roma Termini", "Milano Centrale", "Napoli Centrale". ### Output The actor stores results in a dataset. Each item represents one train service with a specific fare class. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel. #### Example output ```json { "trainNumber": "9921", "departureStation": "Roma Termini", "arrivalStation": "Milano Centrale", "departureTime": "2026-07-15T08:00:00+02:00", "arrivalTime": "2026-07-15T10:55:00+02:00", "duration": "2h 55m", "price": 39.90, "currency": "EUR", "travelClass": "Smart", "availability": "Available", "carrier": "Italo", "url": "https://www.italotreno.com/en", "scrapedAt": "2026-07-01T12:00:00.000Z" } ``` ### Data fields | Field | Type | Description | |-------|------|-------------| | `trainNumber` | string | Italo train service number | | `departureStation` | string | Departure station name | | `arrivalStation` | string | Arrival station name | | `departureTime` | string | Departure date and time | | `arrivalTime` | string | Arrival date and time | | `duration` | string | Journey duration (e.g. "2h 55m") | | `price` | number | Ticket price in EUR (null if unavailable) | | `currency` | string | Currency code (EUR) | | `travelClass` | string | Service class: Smart, Comfort, Prima, Club Executive, Flex, Economy, Low Cost | | `availability` | string | Seat availability: Available, Sold out, Few seats left | | `carrier` | string | Train operator (Italo) | | `url` | string | Search URL on Italo | | `scrapedAt` | string | Timestamp when data was collected | ### Italo travel classes | Class | Description | |-------|-------------| | Smart | Standard class with comfortable seats, Wi-Fi, power outlets | | Comfort | Extra legroom, wider seats, dedicated quiet zone | | Prima | Premium class with leather seats, welcome drink, snacks | | Club Executive | Top-tier: lounge access, meal service, extra-wide leather seats | ### Italo routes covered Italo serves all major Italian cities with high-speed connections: - **Roma Termini** <-> Milano Centrale (2h 55m) - **Roma Termini** <-> Napoli Centrale (1h 10m) - **Roma Termini** <-> Firenze S.M.N. (1h 30m) - **Roma Termini** <-> Venezia Santa Lucia (3h 30m) - **Roma Termini** <-> Torino Porta Nuova (4h 15m) - **Milano Centrale** <-> Bologna Centrale (1h 05m) - **Milano Centrale** <-> Venezia Santa Lucia (2h 15m) - **Napoli Centrale** <-> Firenze S.M.N. (2h 50m) - **Bologna Centrale** <-> Firenze S.M.N. (0h 35m) Plus secondary stops at Salerno, Padova, Verona, Brescia, Reggio Emilia AV, Ferrara, and more. ### How much does it cost to scrape Italo? A typical run searching one route returns 20-80 results (depending on available trains and classes) and uses approximately **0.05-0.20 compute units**. That means you can search hundreds of routes per dollar on the Apify platform. For scheduled monitoring (e.g. checking Roma-Milano prices daily), expect to spend around $1-3 per month depending on how many routes you track. ### Tips - **Use simple city names** — "Roma", "Milano", "Napoli" work fine. The actor resolves them to the correct Italo station automatically. - **Book early for best fares** — Italo's dynamic pricing means fares increase as departure date approaches. Schedule weekly scrapes to track price trends. - **Use IT residential proxies** for the most reliable results. The default Apify Proxy works, but Italian residential proxies avoid geo-blocking and rate limiting. - **Compare with Trenitalia** — Pair this actor with the [Trenitalia Scraper](https://apify.com/studio-amba/trenitalia-scraper) to compare fares between Italy's two high-speed rail operators. - **Schedule runs** to build a price history. Italo fares on Roma-Milano can range from EUR 19.90 (Low Cost) to EUR 129.90 (Club Executive). ### Italo vs Trenitalia Italy has two high-speed rail operators competing on the same routes: | Feature | Italo | Trenitalia | |---------|-------|------------| | Operator | NTV (private) | Trenitalia (state-owned) | | Train | AGV / Pendolino EVO | Frecciarossa / Frecciargento | | Top speed | 300 km/h | 300 km/h | | Roma-Milano | ~2h 55m | ~2h 55m | | Classes | Smart, Comfort, Prima, Club Executive | Standard, Premium, Business, Executive | | Pricing | Dynamic, often cheaper | Dynamic | ### FAQ and support **Is it legal to scrape Italo?** This actor accesses publicly available train schedule and pricing information — the same data you see when searching on italotreno.com. No login or authentication is required. **Why are some prices null?** When a fare class is sold out or not available for a route, the price is returned as null and availability shows "Sold out" or "Check online". **Can I search routes Italo doesn't serve?** Italo only operates on specific high-speed corridors in Italy. If you search a route that Italo doesn't serve (e.g. small regional towns), the actor will return zero results. Check the routes list above. **Results look empty?** Make sure your station names are correct. Try simple names like "Roma" or "Milano". If the date is in the past or too far in the future, Italo may not have fares available yet. For bugs or feature requests, open an issue in the [Issues tab](https://apify.com/studio-amba/italo-scraper/issues). For custom scraping solutions, contact us through the Apify platform. # Actor input Schema ## `origin` (type: `string`): Departure city or station name (e.g. 'Roma', 'Milano', 'Napoli', 'Firenze', 'Venezia', 'Torino', 'Bologna'). Common city names are auto-resolved to the correct Italo station. ## `destination` (type: `string`): Arrival city or station name (e.g. 'Milano', 'Roma', 'Napoli', 'Firenze', 'Venezia'). Common city names are auto-resolved to the correct Italo station. ## `departureDate` (type: `string`): Travel date in YYYY-MM-DD format (e.g. '2026-07-15'). Defaults to 14 days from today if not provided. ## `passengers` (type: `integer`): Number of adult passengers (1-9). ## `maxResults` (type: `integer`): Maximum number of train fare results to return. ## `proxyConfiguration` (type: `object`): Proxy settings. Italian residential proxies recommended for reliable results. ## Actor input object example ```json { "origin": "Roma", "destination": "Milano", "passengers": 1, "maxResults": 50, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IT" } } ``` # 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": "Roma", "destination": "Milano", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IT" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/italo-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": "Roma", "destination": "Milano", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "IT", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/italo-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": "Roma", "destination": "Milano", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "IT" } }' | apify call studio-amba/italo-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/italo-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Italo Scraper - Italian High-Speed Train Fares", "description": "Scrape Italo high-speed train fares, schedules, and availability. Search Italian routes like Roma-Milano, Roma-Napoli, Firenze-Venezia to get train numbers, departure/arrival times, prices by class (Smart, Comfort, Prima, Club Executive), and seat availability. No login or cookies required.", "version": "0.1", "x-build-id": "SYL85KUcda0vchxvs" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~italo-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-italo-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/studio-amba~italo-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-italo-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/studio-amba~italo-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-italo-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", "properties": { "origin": { "title": "Origin Station", "type": "string", "description": "Departure city or station name (e.g. 'Roma', 'Milano', 'Napoli', 'Firenze', 'Venezia', 'Torino', 'Bologna'). Common city names are auto-resolved to the correct Italo station.", "default": "Roma" }, "destination": { "title": "Destination Station", "type": "string", "description": "Arrival city or station name (e.g. 'Milano', 'Roma', 'Napoli', 'Firenze', 'Venezia'). Common city names are auto-resolved to the correct Italo station.", "default": "Milano" }, "departureDate": { "title": "Departure Date", "type": "string", "description": "Travel date in YYYY-MM-DD format (e.g. '2026-07-15'). Defaults to 14 days from today if not provided." }, "passengers": { "title": "Number of Passengers", "minimum": 1, "maximum": 9, "type": "integer", "description": "Number of adult passengers (1-9).", "default": 1 }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of train fare results to return.", "default": 50 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Italian residential proxies recommended for reliable results.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } } ```