Skip to content
Scrappa Get API key
Trip.com API 1 credit / request

Trip.com Car Rental Locations API Documentation

GET https://scrappa.co/api/tripcom/cars/locations

Trip.com Car Rental Locations API Documentation 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. Only airports are search-ready: for those, search_params 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 search_ready 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.

Trip.com Car Rental Locations API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/tripcom/cars/locations
Auth header
x-api-key
Cost
1 credit / request
query = coffee shops
Response preview
200 OK
{
    "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",
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

1 optional filter available.

query string Required

Place name or airport code. Example: heathrow, bangkok airport or JFK.

Example value coffee shops
locale string Optional

Site language: en, en-gb, de, fr, ja, ko or zh-hk. Default en.

Example value en-US

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

data meta success
JSON Response
200 OK
{
    "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

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A query parameter is missing or invalid. This response is not billable.

{
    "errors": {
        "query": [
            "A search text is required, e.g. heathrow or bangkok airport."
        ]
    },
    "message": "The request validation failed"
}
502

Unexpected Upstream Answer

Trip.com answered with a payload Scrappa cannot read. This response is not billable. Retry later.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "car_locations"
    },
    "error": {
        "code": "PARSER_DRIFT",
        "message": "The Trip.com API is temporarily unavailable. Please retry."
    },
    "success": false
}
503

Upstream Unavailable

Trip.com did not answer, or no capacity was free in time. This response is not billable. Retry later.

{
    "meta": {
        "billable": false,
        "retryable": true,
        "endpoint_family": "car_locations"
    },
    "error": {
        "code": "UPSTREAM_UNAVAILABLE",
        "message": "The Trip.com API is temporarily unavailable. Please retry."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.