# Booking Car Rentals Scraper (`romy/booking-car-rentals-scraper`) Actor

Get car rental search results from Booking. Talks directly to Booking.com's own mobile app API, no login or API key needed. Split from the mature, published booking-all-in-one-api for a focused, single-purpose workflow.

- **URL**: https://apify.com/romy/booking-car-rentals-scraper.md
- **Developed by:** [Romy](https://apify.com/romy) (community)
- **Categories:** Travel
- **Stats:** 2 total users, 1 monthly users, 60.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.60 / 1,000 car rental chargeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

### What does Booking.com Car Rentals Scraper do?

**Booking.com Car Rentals Scraper** searches Booking.com car rentals by pickup location and dates, with real supplier/price/rating data — confirmed live: a real Los Angeles search returned 396 real listings. Free-text pickup locations are resolved to coordinates automatically. Optionally fetches full car detail (specs, what's included, cancellation terms) for every result in one run.

It talks directly to the same internal API the official [Booking.com](https://www.booking.com/) Android app uses, reverse-engineered by capturing live traffic from a real device — car rentals is a genuinely separate backend from hotels, confirmed live by opening the app's own Car rentals tab. No Booking.com account, no API key of your own. This is the car-rentals slice of [Booking.com All-in-One API](https://apify.com/romy/booking-all-in-one-api), split out as its own focused Actor.

### Why use Booking.com Car Rentals Scraper?

- **Real results, confirmed live** — 396 real cars with real supplier names, per-rental prices, and ratings for a real Los Angeles search
- **Automatic location resolution** — pass a plain city name; this Actor resolves it to coordinates for you
- **Optional full car detail in the same run** — specs, what's included, cancellation terms, no separate Actor call needed
- **The same `searchKey` works for every car in a search** — confirmed live, so detail fetches don't need per-vehicle re-derivation
- **No account needed** — every request works fully anonymously
- **Use cases:** car rental price monitoring, travel search products, supplier comparison

### Input

| Field                | Type              | Description                                                                                                                                                                                                              |
| -------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `locationQuery`      | string            | Free-text pickup location, e.g. `Los Angeles`. If `lat`/`lng` aren't also given, this Actor only looks up matching locations and pushes them (no search). If `lat`/`lng` are missing, this is used to auto-resolve them. |
| `location`           | string            | Pickup location name, used with `lat`/`lng`. Auto-filled when resolving from `locationQuery`.                                                                                                                            |
| `lat` / `lng`        | number            | Pickup coordinates. Skips `locationQuery` resolution.                                                                                                                                                                    |
| `pickup` / `dropoff` | string (ISO 8601) | Pickup/drop-off datetime, e.g. `2026-09-24T10:00:00.000Z`.                                                                                                                                                               |
| `driverAge`          | integer           | Default `30`                                                                                                                                                                                                             |
| `currency`           | string            | Default `HOTEL` (account currency). Confirmed live to change returned prices.                                                                                                                                            |
| `includeDetail`      | boolean           | Fetch full specs/inclusions/cancellation-terms detail per car. Default `false`.                                                                                                                                          |
| `maxItems`           | integer           | Stop once this many cars have been pushed. Default: push every result from the search.                                                                                                                                   |

Example (search):

```json
{
    "locationQuery": "Los Angeles",
    "pickup": "2026-09-24T10:00:00.000Z",
    "dropoff": "2026-09-27T10:00:00.000Z",
    "currency": "USD",
    "maxItems": 20
}
```

Example (location lookup only):

```json
{ "locationQuery": "Los Angeles" }
```

### Output

One dataset row per car (trimmed example):

```json
{
    "title": "Nissan Rogue",
    "subtitle": "or similar SUV",
    "supplier": { "name": "Alamo", "rating": { "score": "9.1", "description": "Superb" } },
    "pricing": { "finalPriceDisplay": "US$233", "durationText": "Price for 3 days" },
    "metadata": { "vehicleId": "790637691" },
    "detail": { "...": "full specs/inclusions/cancellation terms, only present when includeDetail is true" }
}
```

### Known limitations

- **Location resolution takes the first suggestion with coordinates.** For an ambiguous `locationQuery`, run a lookup first and pass exact `lat`/`lng` instead.
- **Availability is genuinely route/date-dependent.** Some pickup points (e.g. airports with limited standing inventory, or dates too close to now) can legitimately return zero cars — a real availability constraint, not a bug.
- This is an unofficial, reverse-engineered integration, not affiliated with or endorsed by Booking.com B.V. Behavior may change if Booking.com changes its API.

### Pricing

Pay-per-event: $0.0025 per `car-rental` result (FREE plan; BRONZE/SILVER/GOLD/PLATINUM/DIAMOND get automatic discounts based on your Apify plan). Location suggestion lookups are not charged.

# Actor input Schema

## `locationQuery` (type: `string`):

Free-text pickup location, e.g. "Los Angeles". If pickup/dropoff dates are not also given, this Actor only looks up matching locations and pushes them (no search). If lat/lng are missing but dates are given, this is used to auto-resolve them.

## `location` (type: `string`):

Used together with lat/lng. Auto-filled when resolving from locationQuery.

## `lat` (type: `number`):

Latitude coordinate.

## `lng` (type: `number`):

Longitude coordinate.

## `pickup` (type: `string`):

ISO 8601, e.g. 2026-09-24T10:00:00.000Z

## `dropoff` (type: `string`):

ISO 8601

## `driverAge` (type: `integer`):

Driver's age, used for car rental price/eligibility rules.

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

Confirmed live to change returned prices.

## `includeDetail` (type: `boolean`):

Fetch full specs/inclusions/cancellation-terms detail per car (one extra request per car).

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

Stop once this many cars have been pushed. Leave empty to push every result from the search.

## Actor input object example

```json
{
  "locationQuery": "Los Angeles",
  "pickup": "2026-10-15T10:00:00.000Z",
  "dropoff": "2026-10-18T10:00:00.000Z",
  "driverAge": 30,
  "currency": "USD",
  "includeDetail": false,
  "maxItems": 5
}
```

# Actor output Schema

## `dataset` (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 = {
    "locationQuery": "Los Angeles",
    "pickup": "2026-10-15T10:00:00.000Z",
    "dropoff": "2026-10-18T10:00:00.000Z",
    "maxItems": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("romy/booking-car-rentals-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 = {
    "locationQuery": "Los Angeles",
    "pickup": "2026-10-15T10:00:00.000Z",
    "dropoff": "2026-10-18T10:00:00.000Z",
    "maxItems": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("romy/booking-car-rentals-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 '{
  "locationQuery": "Los Angeles",
  "pickup": "2026-10-15T10:00:00.000Z",
  "dropoff": "2026-10-18T10:00:00.000Z",
  "maxItems": 5
}' |
apify call romy/booking-car-rentals-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,romy/booking-car-rentals-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/DqLME5s11e5qLpOcC/builds/mdnqkDZHbPpryUjj1/openapi.json
