JustSERPDocs
Google

Google Flights Location Search

The suggestions of the "Where from?" and "Where to?" boxes of Google Flights for some typed letters, answered as the document with `locations`: cities with their airports and, for the arrival box, regions and countries.

GET
/v1/google/flights/location-search

The suggestions of the "Where from?" and "Where to?" boxes of Google Flights for some typed letters, answered as the document with locations: cities with their airports and, for the arrival box, regions and countries. Five suggestions at most. A typed airport code answers the airport alone (type: airport). The kgmid and airport_code are the departure_id / arrival_id forms the flights engines take.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
q*string

The letters typed.

Length1 <= length <= 200
search_type?string

arrival adds regions.

Default"departure"
Value in"departure""arrival"
hl?string

Language code.

Default"en"

Response Body

The suggestions, as the document. When the page could not be parsed, the usual envelope.

application/json
  1. response

The first three keys of every parsed 200 (the answer is the document itself, no success/data envelope): what the search was (search_metadata), what it asked (search_parameters), the parser's own search_information ({} when it has none). The engine's blocks follow, at the same level. An engine whose answer is a list puts it under results.

search_metadata*
search_parameters*

The request's own fields as sent, engine first, without cancel_token.

search_information*

The parser's own, e.g. yelp_search's; otherwise {}.

locations?array<>
Itemsitems <= 5
[key: string]?any
Example Request
curl -X GET 'https://api.justserp.com/v1/google/flights/location-search?q=New&search_type=departure'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {},  "locations": [    {      "type": "string",      "kgmid": "string",      "full_name": "string",      "short_name": "string",      "description": "string",      "airports": [        {          "type": "string",          "kgmid": "string",          "airport_code": "string",          "title": "string",          "city": "string",          "distance": "string"        }      ]    }  ]}