# Expedia Car Rentals Scraper (`xtracto/expedia-cars`) Actor Scrape rental car offers from Expedia by location and dates. Returns vehicle class, model, vendor, per-day and total price, pickup location, ratings and a booking deeplink for every offer. Search by Expedia URL, region ID, or free-text place name. - **URL**: https://apify.com/xtracto/expedia-cars.md - **Developed by:** [Farhan Febrian Nauval](https://apify.com/xtracto) (community) - **Categories:** Travel, Automation - **Stats:** 7 total users, 4 monthly users, 72.7% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.80 / 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.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 ## Expedia Car Rentals Scraper Scrape rental-car offers from Expedia by location and dates. One result = one rental-car offer. ### Why use this actor - No account, no login, and no API key required - Search by place name (e.g. "Los Angeles Airport"), by Expedia region ID, or by pasting a full Expedia car-search link - Every offer: vehicle class & model, rental company, per-day and total price, pickup location, rating, badges, and a direct booking link - Set your own currency and language - Stable JSON output suitable for pipelines, price tracking, or travel analytics ### How it works 1. Tell the actor where and when: one or more pickup locations plus the pickup and drop-off dates and times (or just paste Expedia car-search links). 2. The actor looks up each location and collects the available rental-car offers for those dates. 3. Results stream into your dataset, ready to download as JSON, CSV, or Excel. You don't manage scrapers, browsers, or retries — the actor handles all of that. ### Input ```json { "locations": ["Los Angeles Airport", "4933443"], "pickUpDate": "2026-06-25", "dropOffDate": "2026-06-26", "pickUpTime": "1030AM", "dropOffTime": "1030AM", "currency": "USD", "locale": "en_US", "maxResultsPerSearch": 0, "concurrency": 3, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` | Field | Type | Description | |---|---|---| | `locations` | array | Pickup locations — place names ("Paris, France") or numeric Expedia region IDs. Combined with the dates/times below. | | `pickUpDate` / `dropOffDate` | string | Dates in `YYYY-MM-DD` form, applied to all locations. | | `pickUpTime` / `dropOffTime` | string | Times like `1030AM` or `0230PM`. Default `1030AM`. | | `startUrls` | array | Alternative to `locations`: full Expedia `/carsearch` links (the actor reads the location and dates from each link). | | `currency` | string | Price currency (e.g. `USD`, `EUR`, `GBP`). Default `USD`. | | `locale` | string | Language/region (e.g. `en_US`, `de_DE`). Default `en_US`. | | `maxResultsPerSearch` | integer | Cap offers per search. `0` = no cap (all offers at the location). | | `pageCount` | integer | How many offers to request per search. Default 100 (captures essentially all — car inventory per location is small). | | `concurrency` | integer | How many searches to run in parallel. Default 3. | | `proxyConfiguration` | object | Proxy settings. A residential pool is recommended for reliable results. | ### Output ```json { "_input": "Jakarta, Indonesia", "_source": "S1-graphql", "_scrapedAt": "2026-06-11T15:33:29Z", "recordType": "CAR_OFFER", "searchRegionId": "4933443", "searchPickUpDate": "6/25/2026", "searchDropOffDate": "6/26/2026", "vehicle": { "category": "Economy", "description": "Kia Rio Hatchback or similar", "image": { "url": "https://mediaim.expedia.com/cars/2/f5297e42-....jpg", "description": "Economy" }, "attributes": [ { "text": "5" }, { "text": "5 Doors" }, { "text": "Air Conditioning" }, { "text": "Unlimited mileage" }, { "text": "Automatic" } ] }, "vendor": { "image": { "description": "ACE Rent A Car", "url": "https://mediaim.expedia.com/cars/logos/AC.png" } }, "priceSummary": { "lead": { "price": { "amount": 48.84, "formatted": "$49", "currencyInfo": { "code": "USD" } }, "accessibility": "$49 per day" }, "total": { "price": { "amount": 54.21, "formatted": "$54", "currencyInfo": { "code": "USD" } }, "qualifier": "total" } }, "tripLocations": { "pickUpLocation": { "text": "Counter and car in terminal", "locationId": "CGK-T-2-002" }, "dropOffLocation": null }, "review": { "rating": "0%", "totalCount": null }, "offerBadges": [ { "text": "Great Deal", "theme": "DEAL_GENERIC" } ], "infositeURL": { "relativePath": "/carsearch/details?date1=6%2F25%2F2026&....&dpln=4933443" } } ``` | Field | Type | Description | |---|---|---| | `recordType` | string | Always `CAR_OFFER`. | | `vehicle` | object | Category, model description, image, and attributes (seats, doors, transmission, mileage, A/C). | | `vendor` | object | Rental company name and logo. | | `priceSummary` | object | `lead` = per-day price, `total` = full rental price, with currency. | | `tripLocations` | object | Pickup (and drop-off) counter/location details. | | `review` | object | Rating and review count for the offer, when available. | | `offerBadges` | array | Deal badges shown on the offer (e.g. "Great Deal"). | | `infositeURL` | object | Direct booking link path on Expedia for this offer. | Fields are passed through exactly as Expedia provides them, so new fields flow through without changes. An offer/search that can't be read returns an `_error` record instead of being dropped. ### Notes and limits - **Expedia heavily throttles automated car-search requests.** Expedia strictly limits how often car availability can be requested from outside a normal browser, so live offers are not guaranteed on every run. When a request is throttled, the actor does not fail silently — it emits a clearly marked status record for that search so you always know what happened, instead of returning an empty dataset. - To improve your chances of live results, use a **residential proxy** and let the actor apply its automatic retries. Running fewer locations at a time (low concurrency) also helps. - Every run always produces at least one record: either car offers or a status record explaining why a search returned none — so an empty output never goes unexplained. - Car inventory per location is small (typically 10–50 offers); one search captures essentially all of them, so there are no extra pages to walk. - Prices, badges and availability are point-in-time and change frequently. ### Related actors Part of an Expedia suite — one actor per travel type: Cars, Stays, Flights, Packages, Cruises. # Actor input Schema ## `startUrls` (type: `array`): Full Expedia /carsearch URLs. The actor parses the pickup region (dpln), dates and times out of each URL. Example: https://www.expedia.com/carsearch?locn=Jakarta%2C%20Indonesia%20(CGK-Soekarno-Hatta%20Intl.)\&dpln=4933443\&date1=6/25/2026\&date2=6/26/2026\&time1=1030AM\&time2=1030AM ## `locations` (type: `array`): Pickup locations as free-text place names (e.g. 'Los Angeles Airport', 'Paris, France') resolved via Expedia typeahead, OR numeric Expedia region IDs (gaiaId / dpln). Combined with the pickup/drop-off dates and times below. Leave empty if you use startUrls. ## `pickUpDate` (type: `string`): Pick-up date applied to all 'Locations'. Format YYYY-MM-DD, e.g. 2026-06-25. ## `dropOffDate` (type: `string`): Drop-off date applied to all 'Locations'. Format YYYY-MM-DD, e.g. 2026-06-26. ## `pickUpTime` (type: `string`): Pick-up time, e.g. '1030AM' or '0230PM'. Defaults to 1030AM. ## `dropOffTime` (type: `string`): Drop-off time, e.g. '1030AM'. Defaults to 1030AM. ## `currency` (type: `string`): ISO currency code for prices (e.g. USD, EUR, GBP). ## `locale` (type: `string`): Expedia locale, e.g. en\_US, en\_GB, de\_DE. ## `maxResultsPerSearch` (type: `integer`): Cap car offers emitted per search. 0 = no cap (all offers at the location). ## `pageCount` (type: `integer`): How many offers to request from Expedia per search (selPageCount). Car inventory per location is small; 100 captures essentially all offers. ## `concurrency` (type: `integer`): Max searches run in parallel. Keep low (1-3): Expedia's /graphql applies a per-IP rate limit and each search uses its own proxy IP. ## `proxyConfiguration` (type: `object`): Apify proxy. RESIDENTIAL is strongly recommended — Expedia's /graphql endpoint rate-limits per IP and the actor rotates IP on 429. ## Actor input object example ```json { "startUrls": [ "https://www.expedia.com/carsearch?locn=Jakarta%2C%20Indonesia%20(CGK-Soekarno-Hatta%20Intl.)&pickupIATACode=CGK&dpln=4933443&date1=6/25/2026&date2=6/26/2026&time1=1030AM&time2=1030AM" ], "locations": [], "pickUpDate": "2026-06-25", "dropOffDate": "2026-06-26", "pickUpTime": "1030AM", "dropOffTime": "1030AM", "currency": "USD", "locale": "en_US", "maxResultsPerSearch": 0, "pageCount": 100, "concurrency": 3, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "startUrls": [ "https://www.expedia.com/carsearch?locn=Jakarta%2C%20Indonesia%20(CGK-Soekarno-Hatta%20Intl.)&pickupIATACode=CGK&dpln=4933443&date1=6/25/2026&date2=6/26/2026&time1=1030AM&time2=1030AM" ], "locations": [], "pickUpDate": "2026-06-25", "dropOffDate": "2026-06-26", "pickUpTime": "1030AM", "dropOffTime": "1030AM", "currency": "USD", "locale": "en_US" }; // Run the Actor and wait for it to finish const run = await client.actor("xtracto/expedia-cars").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 = { "startUrls": ["https://www.expedia.com/carsearch?locn=Jakarta%2C%20Indonesia%20(CGK-Soekarno-Hatta%20Intl.)&pickupIATACode=CGK&dpln=4933443&date1=6/25/2026&date2=6/26/2026&time1=1030AM&time2=1030AM"], "locations": [], "pickUpDate": "2026-06-25", "dropOffDate": "2026-06-26", "pickUpTime": "1030AM", "dropOffTime": "1030AM", "currency": "USD", "locale": "en_US", } # Run the Actor and wait for it to finish run = client.actor("xtracto/expedia-cars").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 '{ "startUrls": [ "https://www.expedia.com/carsearch?locn=Jakarta%2C%20Indonesia%20(CGK-Soekarno-Hatta%20Intl.)&pickupIATACode=CGK&dpln=4933443&date1=6/25/2026&date2=6/26/2026&time1=1030AM&time2=1030AM" ], "locations": [], "pickUpDate": "2026-06-25", "dropOffDate": "2026-06-26", "pickUpTime": "1030AM", "dropOffTime": "1030AM", "currency": "USD", "locale": "en_US" }' | apify call xtracto/expedia-cars --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=xtracto/expedia-cars", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Expedia Car Rentals Scraper", "description": "Scrape rental car offers from Expedia by location and dates. Returns vehicle class, model, vendor, per-day and total price, pickup location, ratings and a booking deeplink for every offer. Search by Expedia URL, region ID, or free-text place name.", "version": "0.1", "x-build-id": "s69IdtfAyGvretp8c" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/xtracto~expedia-cars/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-xtracto-expedia-cars", "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/xtracto~expedia-cars/runs": { "post": { "operationId": "runs-sync-xtracto-expedia-cars", "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/xtracto~expedia-cars/run-sync": { "post": { "operationId": "run-sync-xtracto-expedia-cars", "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": { "startUrls": { "title": "Expedia car search URLs", "type": "array", "description": "Full Expedia /carsearch URLs. The actor parses the pickup region (dpln), dates and times out of each URL. Example: https://www.expedia.com/carsearch?locn=Jakarta%2C%20Indonesia%20(CGK-Soekarno-Hatta%20Intl.)&dpln=4933443&date1=6/25/2026&date2=6/26/2026&time1=1030AM&time2=1030AM", "items": { "type": "string" } }, "locations": { "title": "Locations (place name or region ID)", "type": "array", "description": "Pickup locations as free-text place names (e.g. 'Los Angeles Airport', 'Paris, France') resolved via Expedia typeahead, OR numeric Expedia region IDs (gaiaId / dpln). Combined with the pickup/drop-off dates and times below. Leave empty if you use startUrls.", "items": { "type": "string" } }, "pickUpDate": { "title": "Pick-up date (YYYY-MM-DD)", "pattern": "^(\\d{4}-\\d{1,2}-\\d{1,2})?$", "type": "string", "description": "Pick-up date applied to all 'Locations'. Format YYYY-MM-DD, e.g. 2026-06-25." }, "dropOffDate": { "title": "Drop-off date (YYYY-MM-DD)", "pattern": "^(\\d{4}-\\d{1,2}-\\d{1,2})?$", "type": "string", "description": "Drop-off date applied to all 'Locations'. Format YYYY-MM-DD, e.g. 2026-06-26." }, "pickUpTime": { "title": "Pick-up time", "type": "string", "description": "Pick-up time, e.g. '1030AM' or '0230PM'. Defaults to 1030AM.", "default": "1030AM" }, "dropOffTime": { "title": "Drop-off time", "type": "string", "description": "Drop-off time, e.g. '1030AM'. Defaults to 1030AM.", "default": "1030AM" }, "currency": { "title": "Currency", "type": "string", "description": "ISO currency code for prices (e.g. USD, EUR, GBP).", "default": "USD" }, "locale": { "title": "Locale", "type": "string", "description": "Expedia locale, e.g. en_US, en_GB, de_DE.", "default": "en_US" }, "maxResultsPerSearch": { "title": "Max results per search", "minimum": 0, "type": "integer", "description": "Cap car offers emitted per search. 0 = no cap (all offers at the location).", "default": 0 }, "pageCount": { "title": "Offers requested per search", "minimum": 10, "maximum": 200, "type": "integer", "description": "How many offers to request from Expedia per search (selPageCount). Car inventory per location is small; 100 captures essentially all offers.", "default": 100 }, "concurrency": { "title": "Concurrent searches", "minimum": 1, "maximum": 10, "type": "integer", "description": "Max searches run in parallel. Keep low (1-3): Expedia's /graphql applies a per-IP rate limit and each search uses its own proxy IP.", "default": 3 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy. RESIDENTIAL is strongly recommended — Expedia's /graphql endpoint rate-limits per IP and the actor rotates IP on 429.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```