> For the complete documentation index, see [llms.txt](https://help.netnut.io/netnut-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.netnut.io/netnut-documentation/netnut-scraper-apis/serp-api/google-scraper/google-flights/response-fields.md).

# Response Fields

### Field Summary

The table below provides a quick overview of the main fields returned by the Google Flights API response.

| Field            | Type    | Description                                                          |
| ---------------- | ------- | -------------------------------------------------------------------- |
| `url`            | string  | The final Google Flights URL used to retrieve the results            |
| `general`        | object  | Metadata describing the request environment and search configuration |
| `input`          | object  | Information about the original request processed by the API          |
| `organic`        | array   | Reserved field; always returned as an empty array                    |
| `flights`        | array   | List of flight result objects extracted from Google Flights          |
| `pagesProcessed` | integer | Number of result pages processed to build the response               |

### Flight Object Fields Summary

Each element inside the `flights` array contains the following fields:

| Field             | Type    | Description                                    |
| ----------------- | ------- | ---------------------------------------------- |
| `departure_time`  | string  | Departure time of the first leg                |
| `total_duration`  | string  | Total journey time including any layovers      |
| `stops`           | integer | Number of stops in the itinerary               |
| `total_emissions` | string  | Estimated CO2 emissions for the full itinerary |
| `price`           | string  | Formatted price string                         |
| `price_raw`       | integer | Numeric price value without formatting         |
| `legs`            | array   | List of individual flight segments             |
| `rank`            | integer | Position of the flight in the returned results |

***

### Top-Level Fields

#### url

The final Google Flights URL used to retrieve the results. This URL reflects the fully constructed search query including route, dates, and encoded Google parameters.

**Example**

```json
"url": "https://www.google.com/travel/flights/search?hl=en&gl=US&tfs=CBwQAhor..."
```

***

#### general

Metadata describing the request environment and search configuration.

**Fields**

| Field          | Type    | Description                                         |
| -------------- | ------- | --------------------------------------------------- |
| `searchEngine` | string  | Always `google_flights`                             |
| `language`     | string  | Language code used for the search                   |
| `device`       | string  | Device type used for the request                    |
| `searchType`   | string  | Type of search performed                            |
| `pageTitle`    | string  | Page title returned by Google                       |
| `timestamp`    | string  | ISO 8601 timestamp of when the request was executed |
| `render`       | boolean | Whether the page was rendered with JavaScript       |

**Example**

```json
"general": {
  "searchEngine": "google_flights",
  "language": "en",
  "device": "desktop",
  "searchType": "text",
  "pageTitle": "New York to Los Angeles | Google Flights",
  "timestamp": "2026-06-01T16:02:22.487780767Z",
  "render": false
}
```

***

#### input

Information about the original request processed by the API.

**Fields**

| Field         | Type   | Description                             |
| ------------- | ------ | --------------------------------------- |
| `originalUrl` | string | The Google Flights URL that was fetched |
| `jobId`       | string | Unique identifier for the API job       |

**Example**

```json
"input": {
  "originalUrl": "https://www.google.com/travel/flights/search?hl=en&gl=US&tfs=CBwQAhor...",
  "jobId": "203e0593-8bfd-49ea-a75c-8136da9d04b5"
}
```

***

### Flights Array

The `flights` field contains a list of flight objects extracted from Google Flights. Each object represents a single itinerary option.

**Example**

```json
"flights": [
  { ...flight object... }
]
```

***

### Flight Object Fields

#### departure\_time

Departure time of the first leg of the itinerary.

```json
"departure_time": "8:05 AM"
```

***

#### total\_duration

Total journey time from origin to destination, including layover time for connecting flights.

```json
"total_duration": "6 hr 15 min"
```

***

#### stops

Number of stops in the itinerary. `0` indicates a nonstop flight.

```json
"stops": 0
```

***

#### total\_emissions

Estimated CO2 emissions for the full itinerary across all legs.

```json
"total_emissions": "277 kg CO2e"
```

***

#### price

Formatted price string for the itinerary.

```json
"price": "$468"
```

***

#### price\_raw

Numeric price value without currency formatting. Useful for sorting and comparison logic.

```json
"price_raw": 468
```

***

#### legs

List of individual flight segments that make up the itinerary. Nonstop flights contain one leg. Connecting flights contain one leg per segment.

```json
"legs": [
  { ...leg object... }
]
```

**Leg Object Fields**

| Field               | Type    | Description                                                                         |
| ------------------- | ------- | ----------------------------------------------------------------------------------- |
| `departure_airport` | object  | Origin airport for this segment. Contains `name`, `id` (IATA code), and `time`      |
| `arrival_airport`   | object  | Destination airport for this segment. Contains `name`, `id` (IATA code), and `time` |
| `duration`          | string  | Flight time for this segment                                                        |
| `overnight`         | boolean | Whether this segment crosses midnight                                               |
| `airplane`          | string  | Aircraft type                                                                       |
| `airline`           | string  | Airline name                                                                        |
| `airline_logo`      | string  | URL to the airline logo image                                                       |
| `travel_class`      | string  | Cabin class (e.g., `Economy`)                                                       |
| `flight_number`     | string  | IATA flight number                                                                  |
| `amenities`         | array   | List of onboard amenities and per-segment emissions data                            |

***

#### rank

Position of the flight in the returned search results, starting from `1`.

```json
"rank": 1
```

***

### Example Flight Objects

#### Nonstop Flight

```json
{
  "departure_time": "8:05 AM",
  "total_duration": "6 hr 15 min",
  "stops": 0,
  "total_emissions": "277 kg CO2e",
  "price": "$468",
  "price_raw": 468,
  "legs": [
    {
      "departure_airport": {
        "name": "John F. Kennedy International Airport",
        "id": "JFK",
        "time": "8:05 AM"
      },
      "arrival_airport": {
        "name": "Los Angeles International Airport",
        "id": "LAX",
        "time": "11:20 AM"
      },
      "duration": "6 hr 15 min",
      "overnight": false,
      "airplane": "Boeing 777",
      "airline": "American",
      "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/AA.png",
      "travel_class": "Economy",
      "flight_number": "AA 255",
      "amenities": [
        "Average legroom (31 in)",
        "Wi-Fi for a fee",
        "On-demand video",
        "Emissions estimate: 277 kg CO2e",
        "Contrail warming potential: Low"
      ]
    }
  ],
  "rank": 1
}
```

#### Connecting Flight

```json
{
  "departure_time": "7:55 AM",
  "total_duration": "10 hr 28 min",
  "stops": 1,
  "total_emissions": "384 kg CO2e",
  "price": "$447",
  "price_raw": 447,
  "legs": [
    {
      "departure_airport": {
        "name": "LaGuardia Airport",
        "id": "LGA",
        "time": "7:55 AM"
      },
      "arrival_airport": {
        "name": "Charlotte Douglas International Airport",
        "id": "CLT",
        "time": "10:01 AM"
      },
      "duration": "2 hr 6 min",
      "overnight": false,
      "airplane": "Airbus A320",
      "airline": "American",
      "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/AA.png",
      "travel_class": "Economy",
      "flight_number": "AA 1023",
      "amenities": [
        "Average legroom (31 in)",
        "Free Wi-Fi",
        "Stream media to your device",
        "Emissions estimate: 106 kg CO2e",
        "Contrail warming potential: Low"
      ]
    },
    {
      "departure_airport": {
        "name": "Charlotte Douglas International Airport",
        "id": "CLT",
        "time": "1:20 PM"
      },
      "arrival_airport": {
        "name": "Los Angeles International Airport",
        "id": "LAX",
        "time": "3:23 PM"
      },
      "duration": "5 hr 3 min",
      "overnight": false,
      "airplane": "Airbus A321",
      "airline": "American",
      "airline_logo": "https://www.gstatic.com/flights/airline_logos/70px/AA.png",
      "travel_class": "Economy",
      "flight_number": "AA 352",
      "amenities": [
        "Average legroom (30 in)",
        "Free Wi-Fi",
        "Stream media to your device",
        "Emissions estimate: 279 kg CO2e",
        "Contrail warming potential: Low"
      ]
    }
  ],
  "rank": 3
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.netnut.io/netnut-documentation/netnut-scraper-apis/serp-api/google-scraper/google-flights/response-fields.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
