# Rome2Rio API Scraper (`rl1987/rome2rio-api-scraper`) Actor

Search Rome2Rio for transport routes between any two places worldwide. Get detailed route options including duration, price, transport modes, operators, segments, and geo coordinates.

- **URL**: https://apify.com/rl1987/rome2rio-api-scraper.md
- **Developed by:** [R.L.](https://apify.com/rl1987) (community)
- **Categories:** Travel
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 route option rows

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Rome2Rio Scraper 🚆 — Scrape Rome2Rio.com Trains, Buses, Flights, Ferries & Fares

**Rome2Rio Scraper** — Find every way to get from A to B worldwide — train, bus, flight, ferry, rideshare, drive and walk — via Rome2Rio's private mobile API. Each route option carries its segments, operators, duration, distance and indicative price, plus optional timetabled departures and bookable fares. It reads Rome2Rio's own API directly, so it's **fast, reliable and complete** — no flaky HTML parsing, no headless browser. Export to **JSON, CSV, Excel, or an API**.

> Get from anywhere to anywhere — compare every train, bus, flight, ferry and drive option between any two places on earth, with real timetables and bookable fares.

***

### ✨ Why use this Rome2Rio Scraper?

- 🟢 **No code required** — set your input, click **Start**, download your data.
- ⚡ **Fast & accurate** — reads Rome2Rio's own private API and returns structured JSON, not scraped HTML.
- 🧾 **Rich, structured data** — every field below, clean and ready to use.
- 🔁 **Batch trips** — queue many origin→destination pairs in one run, up to your `maxItems` cap.
- 💸 **Transparent pay-per-result pricing** — pay only for the rows you get.
- 📤 **Export anywhere** — JSON, CSV, Excel, XML, or pull it live via the Apify API.

***

### 🎯 What can you do with Rome2Rio data?

- **Market & competitor research** — analyse Rome2Rio travel routes at scale.
- **Price & availability monitoring** — track changes over time.
- **Data science & trend analysis** — build clean datasets.
- **Lead generation & enrichment** — feed Rome2Rio data into your own tools.

***

### 📥 What data does the Rome2Rio Scraper extract?

Each row includes: `recordType`, `origin`, `destination`, `routeName`, `modes`, `durationMinutes`, `distanceKm`, `priceLow`, `priceHigh`, `priceCurrency`, `originStation`, `destinationStation`, `segmentCount`, `segments` …and more. See the full **Data table** below.

***

### 🚀 How to scrape Rome2Rio.com (3 steps)

1. **Set your input** — provide `trips` or `origin` (see the table below; defaults work out of the box).
2. **Pick options** — filters, a `proxyConfiguration`, and a `maxItems` cap.
3. **Run & export** — click **Start**, then download the dataset as JSON/CSV/Excel or fetch it via the API.

### 🌐 Proxies — what's actually needed

Measured against the live API (100 requests direct + 105 through Apify Proxy):

| | Success | p50 latency | Throughput @6 concurrent |
|---|---|---|---|
| **Datacenter (default)** | 20/20 (100%) | 0.28 s | ~890 searches/min |
| **Residential** | 94% (75/80 over 4 back-to-back waves) | 1.62 s | ~112 searches/min |

Rome2Rio's mobile API applies **no IP-reputation blocking** — not a single `403`/`429` came back
from datacenter IPs, and a full 8-trip platform run finished in 54 s with zero retries. So the
**default datacenter proxy is the right choice**; it is ~6x faster and doesn't touch your
residential GB quota.

Choose **RESIDENTIAL** only when you want a specific country's pricing/availability. Budget
\~133 KB of residential transfer per trip (with timetables on) — roughly **78,000 trips per 10 GB**.
The residential failures above were transient proxy-side errors (`ProxyError`/`SSLError`), not
target blocks, and the actor's transport retries them automatically. Avoid pinning one sticky
session: a reused residential exit IP died after ~7 requests, while per-request rotation (what
this actor does by default) held at 94–100% indefinitely.

***

### ⚙️ Input

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `trips` | array of string | `['London -> Paris']` | One trip per line as "Origin -> Destination", e.g. "London -> Paris". Place names, addresses, airports or "lat,lng" coordinates all work. Takes priority over the single Origin/Destination fields below. |
| `origin` | string | `London` | Single-trip origin — a place name, address, airport or "lat,lng". Ignored when Trips is set. |
| `destination` | string | `Paris` | Single-trip destination — a place name, address, airport or "lat,lng". Ignored when Trips is set. |
| `includeSchedules` | boolean | `false` | Add real departure times for each schedulable route (train/bus/ferry). One extra API call per route. |
| `includeBookable` | boolean | `false` | Add bookable departures with fares and partner booking deep links (Omio and friends). One extra API call per route. |
| `departureDate` | string | – | Date for the timetables, as YYYY-MM-DD (optionally YYYY-MM-DDTHH:MM). Defaults to now. Only used when departures or fares are enabled. |
| `currency` | string | `USD` | ISO currency code for indicative prices and fares, e.g. USD, EUR, GBP. |
| `language` | string | `en` | ISO language code for place and route names, e.g. en, de, fr. |
| `maxItems` | integer | `100` | Maximum route rows to return across all trips. 0 = no limit. |
| `includeHotels` | boolean | `false` | After the routes for a trip, emit hotel rows for its destination — name, stars, review score and nightly rate from Rome2Rio's hotel provider (Booking.com). Billed as a separate hotel-row event. |
| `checkIn` | string | – | Check-in date as YYYY-MM-DD. Defaults to 30 days from the run. Only used when hotels are enabled. |
| `checkOut` | string | – | Check-out date as YYYY-MM-DD. Defaults to two nights after check-in. Only used when hotels are enabled. |
| `hotelAdults` | integer | `2` | Number of adults for the hotel availability search. |
| `maxHotelsPerTrip` | integer | `20` | How many hotel rows to emit for each destination. |
| `proxyConfiguration` | object | Apify Proxy | Route requests through a proxy (Apify Proxy by default). |

#### Example input

```jsonc
{
  "trips": [
    "London -> Paris"
  ],
  "origin": "London",
  "destination": "Paris",
  "includeSchedules": false,
  "includeBookable": false,
  "currency": "USD",
  "language": "en",
  "maxItems": 100,
  "includeHotels": false,
  "hotelAdults": 2,
  "maxHotelsPerTrip": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

***

### 📤 Output

Each result is a JSON object like this:

```jsonc
{
  "recordType": "route",
  "origin": "London",
  "destination": "Paris",
  "routeName": "Train",
  "modes": [
    "train"
  ],
  "durationMinutes": 148,
  "distanceKm": 450.4,
  "priceLow": 130.0,
  "priceHigh": 230.0,
  "priceCurrency": "EUR",
  "originStation": "London St Pancras Intl",
  "destinationStation": "Paris Nord",
  "segmentCount": 1,
  "segments": [
    {
      "index": 1,
      "modes": [
        "train"
      ],
      "from": "London St Pancras Intl",
      "to": "Paris Nord",
      "durationMinutes": 148,
      "distanceKm": 450.4,
      "operators": [
        "Eurostar"
      ],
      "vehicles": [
        "train"
      ]
    }
  ],
  "operators": [
    "Eurostar"
  ],
  "isConnectable": false,
  "canonicalName": "Train",
  "departures": [
    {
      "departure": "2026-08-21T09:31",
      "arrival": "2026-08-21T12:55",
      "durationMinutes": 144,
      "transitKind": "train",
      "from": "LONDON ST PANCRAS INTL",
      "to": "PARIS NORD",
      "operators": [
        "Eurostar"
      ],
      "changes": 0,
      "itineraryId": "B0D0DFFC"
    },
    {
      "departure": "2026-08-21T10:31",
      "arrival": "2026-08-21T13:53",
      "durationMinutes": 142,
      "transitKind": "train",
      "from": "LONDON ST PANCRAS INTL",
      "to": "PARIS NORD",
      "operators": [
        "Eurostar"
      ],
      "changes": 0,
      "itineraryId": "C0C4897D"
    },
    "…+18 more"
  ],
  "bookableFares": [],
  "bookingLinks": [
    {
      "type": "tickets",
      "providers": [
        "Omio"
      ],
      "urlTemplate": "https://www.rome2rio.com/redirects/omio/?oDateTime={oDateTime}&iDateTime={iDateTime}&adults={adults}&seniors={seniors}&youths={youths}&ages={ages}&checkoutEx…",
      "templatedParameters": [
        "adults",
        "ages",
        "…+5 more"
      ],
      "originCanonical": "London St Pancras Intl",
      "destinationCanonical": "Paris Nord"
    }
  ],
  "searchedAt": "2026-08-21T07:59:26Z"
}
```

***

### 🧾 Data table

| Field | Type | Description |
| --- | --- | --- |
| `recordType` | text | Type |
| `origin` | text | Origin |
| `destination` | text | Destination |
| `routeName` | text | Route |
| `modes` | array | Modes |
| `durationMinutes` | number | Duration (min) |
| `distanceKm` | number | Distance (km) |
| `priceLow` | number | Price low |
| `priceHigh` | number | Price high |
| `priceCurrency` | text | Currency |
| `originStation` | text | Departs from |
| `destinationStation` | text | Arrives at |
| `segmentCount` | number | Segments |
| `segments` | array | Segment detail |
| `operators` | array | Operators |
| `isConnectable` | text | Connectable |
| `canonicalName` | text | Canonical name |
| `departures` | array | Timetabled departures |
| `bookableFares` | array | Bookable fares |
| `bookingLinks` | array | Booking links |
| `searchedAt` | text | Searched at |
| `hotelName` | text | Hotel |
| `hotelId` | text | Hotel ID |
| `hotelRating` | number | Stars |
| `hotelReviewScore` | number | Review score |
| `hotelReviewCount` | number | Reviews |
| `totalRate` | number | Total stay rate |
| `pricePerNight` | number | Price / night |
| `nights` | number | Nights |
| `hotelProvider` | text | Provider |
| `hotelCity` | text | City |
| `latitude` | number | Latitude |
| `longitude` | number | Longitude |
| `checkIn` | text | Check-in |
| `checkOut` | text | Check-out |
| `hotelDistrict` | text | District |
| `freeCancellation` | text | Free cancellation |
| `hotelImage` | link | Image |

***

### 💰 Pricing — pay per result

This actor uses **pay-per-event** pricing: you pay only for the rows it delivers.

| You scrape | Price |
| --- | --- |
| **Route option row** | **$1.00 per 1,000 rows** |
| **Hotel row** | **$1.00 per 1,000 rows** |

***

### 🔌 Use the Rome2Rio Scraper via API

Run it programmatically with the [Apify API](https://docs.apify.com/api/v2):

```bash
curl -X POST "https://api.apify.com/v2/acts/rome2rio-api-scraper/runs?token=YOUR_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "trips": [
    "London -> Paris"
  ],
  "origin": "London",
  "destination": "Paris",
  "includeSchedules": false,
  "includeBookable": false,
  "currency": "USD",
  "language": "en",
  "maxItems": 100,
  "includeHotels": false,
  "hotelAdults": 2,
  "maxHotelsPerTrip": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}'
```

Or with the Apify CLI: `apify call rome2rio-api-scraper -i input.json -o`.

***

### ❓ FAQ

**Do I need an account or API key for Rome2Rio?**

No. The actor talks to Rome2Rio's public/mobile API for you — you only need an Apify account.

**Do I need a proxy?**

A proxy is recommended for reliable runs; set `proxyConfiguration` (Residential is safest for geo-restricted or bot-protected sites).

**What export formats are supported?**

JSON, CSV, Excel, XML, JSONL, RSS, or live via the Apify API and dataset endpoints.

**Is scraping this legal?**

You are responsible for how you use the data. Scrape only public travel route data and comply with Rome2Rio.com's Terms and applicable law (e.g. GDPR/CCPA for personal data).

***

### 🛠️ How it works

The actor impersonates Rome2Rio's official app/site and calls its private API the same way the app does, then normalises each response into the flat record above. No browser, no HTML scraping — just clean, structured data.

***

### 📌 Good to know

- Scrape only public travel route data and respect Rome2Rio.com's Terms of Service and robots policy.
- For personal data, comply with GDPR/CCPA and applicable law — you are the data controller.
- Fields can be `null` when Rome2Rio doesn't expose them for a given record.

***

### ⭐ Found this useful?

Give the **Rome2Rio Scraper** a star on Apify and check out my other `apify-*-api-scraper` actors.

# Actor input Schema

## `trips` (type: `array`):

One trip per line as "Origin -> Destination", e.g. "London -> Paris". Place names, addresses, airports or "lat,lng" coordinates all work. Takes priority over the single Origin/Destination fields below.

## `origin` (type: `string`):

Single-trip origin — a place name, address, airport or "lat,lng". Ignored when Trips is set.

## `destination` (type: `string`):

Single-trip destination — a place name, address, airport or "lat,lng". Ignored when Trips is set.

## `includeSchedules` (type: `boolean`):

Add real departure times for each schedulable route (train/bus/ferry). One extra API call per route.

## `includeBookable` (type: `boolean`):

Add bookable departures with fares and partner booking deep links (Omio and friends). One extra API call per route.

## `departureDate` (type: `string`):

Date for the timetables, as YYYY-MM-DD (optionally YYYY-MM-DDTHH:MM). Defaults to now. Only used when departures or fares are enabled.

## `currency` (type: `string`):

ISO currency code for indicative prices and fares, e.g. USD, EUR, GBP.

## `language` (type: `string`):

ISO language code for place and route names, e.g. en, de, fr.

## `maxItems` (type: `integer`):

Maximum route rows to return across all trips. 0 = no limit.

## `includeHotels` (type: `boolean`):

After the routes for a trip, emit hotel rows for its destination — name, stars, review score and nightly rate from Rome2Rio's hotel provider (Booking.com). Billed as a separate hotel-row event.

## `checkIn` (type: `string`):

Check-in date as YYYY-MM-DD. Defaults to 30 days from the run. Only used when hotels are enabled.

## `checkOut` (type: `string`):

Check-out date as YYYY-MM-DD. Defaults to two nights after check-in. Only used when hotels are enabled.

## `hotelAdults` (type: `integer`):

Number of adults for the hotel availability search.

## `maxHotelsPerTrip` (type: `integer`):

How many hotel rows to emit for each destination.

## `proxyConfiguration` (type: `object`):

Route requests through Apify Proxy. The default (datacenter) is measured to work fine — Rome2Rio's mobile API applies no IP-reputation blocking, and datacenter runs ~6x faster than residential (p50 0.28s vs 1.62s). Pick RESIDENTIAL only if you need a specific country's pricing/availability; it also draws on your residential GB quota (~133 KB per trip).

## Actor input object example

```json
{
  "trips": [
    "London -> Paris"
  ],
  "origin": "London",
  "destination": "Paris",
  "includeSchedules": false,
  "includeBookable": false,
  "currency": "USD",
  "language": "en",
  "maxItems": 100,
  "includeHotels": false,
  "hotelAdults": 2,
  "maxHotelsPerTrip": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "trips": [
        "London -> Paris"
    ],
    "origin": "London",
    "destination": "Paris",
    "departureDate": "",
    "checkIn": "",
    "checkOut": "",
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("rl1987/rome2rio-api-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "trips": ["London -> Paris"],
    "origin": "London",
    "destination": "Paris",
    "departureDate": "",
    "checkIn": "",
    "checkOut": "",
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("rl1987/rome2rio-api-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "trips": [
    "London -> Paris"
  ],
  "origin": "London",
  "destination": "Paris",
  "departureDate": "",
  "checkIn": "",
  "checkOut": "",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call rl1987/rome2rio-api-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rl1987/rome2rio-api-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/DAuX497eQnfu2Ir8w/builds/hQsFbBJnn1uio9QT9/openapi.json