Find airports, cities, districts and landmarks for a search text. Each result has the place type, name, IATA code, city, region, country and coordinates. Use the IATA code or the coordinates as pickup_location in the search. Scrappa is not affiliated with Rentalcars.com. This is an unofficial API.
Run this endpoint
Endpoint
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.
2 optional filters available.
string
Required
Search text with 2 to 120 characters. Example: Berlin.
Berlin
string
Optional
Language of the place names. Default: en.
en
string
Optional
Country of residence as a 2-letter code. Default: gb.
example
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
meta
results
search_parameters
Common results fields
city
iata
name
region
{
"meta": {
"attempts": 1,
"duration_ms": 21,
"endpoint_family": "autocomplete"
},
"results": [
{
"city": "Berlin",
"iata": "BER",
"name": "Berlin Brandenburg Airport Willy Brandt",
"region": "Berlin Federal State",
"country": "Germany",
"latitude": 52.362998962402344,
"longitude": 13.510000228881836,
"is_airport": true,
"place_type": "A",
"country_code": "DE",
"search_location": "BER"
},
{
"city": "Berlin",
"iata": null,
"name": "Berlin",
"region": "Berlin Federal State",
"country": "Germany",
"latitude": 52.516212463378906,
"longitude": 13.37681770324707,
"is_airport": false,
"place_type": "C",
"country_code": "DE",
"search_location": "52.516212,13.376818"
},
{
"city": "Berlin",
"iata": null,
"name": "Berlin City Centre",
"region": "Berlin Federal State",
"country": "Germany",
"latitude": 52.51766586303711,
"longitude": 13.37468147277832,
"is_airport": false,
"place_type": "D",
"country_code": "DE",
"search_location": "52.517666,13.374681"
}
],
"search_parameters": {
"term": "Berlin",
"engine": "rentalcars_autocomplete",
"market": "gb",
"language": "en"
}
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. No request is made upstream. Not billed.
{
"errors": {
"pickup_location": [
"A pick-up location is required: an airport IATA code or \"latitude,longitude\"."
]
},
"message": "A pick-up location is required: an airport IATA code or \"latitude,longitude\"."
}Rentalcars Temporarily Unavailable
Rentalcars did not answer in time. Retry after a short pause. Other 503 codes start with rentalcars_ too, for example rentalcars_invalid_response. Not billed.
{
"meta": {
"attempts": 1,
"billable": false,
"retryable": true,
"duration_ms": 900,
"endpoint_family": "autocomplete"
},
"error": {
"code": "rentalcars_upstream_unavailable",
"message": "Rentalcars is temporarily unavailable. Please retry."
}
}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.