# Trip.com Car Rental Locations API Documentation

<p><strong>Trip.com Car Rental Locations API Documentation</strong> Find car rental pickup places by name. Each place has a code, a type (airport, station or area), a name, the city id and name, the country, coordinates, an address and the Trip.com place ids. <strong>Only airports are search-ready</strong>: for those, <code>search_params</code> holds the five values to copy into the pickup_* or dropoff_* parameters of the Car Rental Search endpoint. Stations and city areas are listed for reference with <code>search_ready</code> false, because the car search returns no offers for them. Hotels are left out. A search without a match is an empty list and costs nothing. Cost: 1 credit per successful call. Failed calls and empty answers cost 0.</p>

- **Documentation:** [https://scrappa.co/docs/tripcom-api/tripcom_cars_locations](https://scrappa.co/docs/tripcom-api/tripcom_cars_locations)
- **API group:** Trip.com API
- **Endpoint:** `GET https://scrappa.co/api/tripcom/cars/locations`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `query` | string | Yes | Place name or airport code. Example: heathrow, bangkok airport or JFK. |
| `locale` | string | No | Site language: en, en-gb, de, fr, ja, ko or zh-hk. Default en. |

## Example response

```json
{
    "data": {
        "query": "heathrow",
        "total": 9,
        "locale": "en",
        "locations": [
            {
                "name": "Heathrow Airport(LHR)",
                "type": "airport",
                "poi_id": "4326152",
                "address": "London, Greater London, United Kingdom",
                "city_id": 338,
                "latitude": 51.46799,
                "city_name": "London",
                "longitude": -0.455047,
                "country_id": 109,
                "location_id": "LHR",
                "car_place_id": "99618905",
                "country_name": "United Kingdom",
                "search_ready": true,
                "search_params": {
                    "city_id": 338,
                    "latitude": 51.46799,
                    "location": "LHR",
                    "longitude": -0.455047,
                    "location_name": "Heathrow Airport(LHR)"
                }
            },
            {
                "name": "Heathrow Terminals 2 & 3",
                "type": "station",
                "poi_id": "27373933",
                "address": "London, Greater London, United Kingdom",
                "city_id": 338,
                "latitude": 51.47209,
                "city_name": "London",
                "longitude": -0.454619,
                "country_id": 109,
                "location_id": "104765441",
                "car_place_id": "104765441",
                "country_name": "United Kingdom",
                "search_ready": false,
                "search_params": null
            }
        ]
    },
    "meta": {
        "billable": true,
        "endpoint_family": "car_locations"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 502 | Unexpected Upstream Answer | Trip.com answered with a payload Scrappa cannot read. This response is not billable. Retry later. |
| 503 | Upstream Unavailable | Trip.com did not answer, or no capacity was free in time. This response is not billable. Retry later. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)