DataBlue / Docs / Endpoint
POST/v1/data/google/flights
Google Flights
Search Google Flights for one-way or round-trip routes. Returns best/other flight listings with airline, flight number, timings, stops, duration, aircraft, emissions, and price metadata.
Execution Model
Live request
Runtime depends on endpoint, target, pagination, rendering mode, and active plan limits.
Credit Weight
Live catalog
Current weights are managed from the Data API Weights admin table and shown on pricing before use.
Parameters
| Name | Type | Requirement | Description |
|---|---|---|---|
| origin | string | REQUIRED | Origin IATA airport code, e.g. MAA or JFK. |
| destination | string | REQUIRED | Destination IATA airport code, e.g. BLR or LAX. |
| departure_date | string | REQUIRED | Departure date in YYYY-MM-DD format. |
| return_date | string | optional | Return date in YYYY-MM-DD format. Omit for one-way. |
| adults | number | optional | Adult passenger count (1-9). |
| children | number | optional | Child passenger count (0-8). |
| infants_in_seat | number | optional | Infants with own seat (0-4). |
| infants_on_lap | number | optional | Lap infants (0-4). |
| seat | string | optional | Cabin class: economy, premium_economy, business, first. |
| max_stops | number | optional | Maximum stops, where 0 means nonstop. |
| language | string | optional | Google UI language code. |
| currency | string | optional | Currency code, e.g. USD, INR, EUR. |
| country | string | optional | Country code for geo-targeting. |
Response Fields
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the request completed successfully. |
| origin / destination | string | Requested airport codes. |
| trip_type | string | one_way or round_trip. |
| price_trend | string | Price trend indicator when available. |
| flights | array | Flight rows with airline, flight_number, times, duration, stops, price, aircraft, delay, and emissions. |
| search_url | string | Google Flights URL used. |
| time_taken | number | API response time in seconds. |
cURL Example
curl -X POST "https://api.datablue.dev/v1/data/google/flights" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"origin": "MAA",
"destination": "BLR",
"departure_date": "2026-08-12",
"adults": 1,
"seat": "economy",
"currency": "INR",
"country": "IN"
}'System Responses
200 OK
Request processed successfully.
401 UNAUTHORIZED
Missing or invalid API key.
429 RATE LIMIT
System capacity exceeded.
500 SYSTEM FAILURE
Internal core exception.
EXAMPLE RESPONSE
{
"success": true,
"origin": "MAA",
"destination": "BLR",
"departure_date": "2026-08-12",
"trip_type": "one_way",
"adults": 1,
"seat": "economy",
"total_results": 8,
"price_trend": "typical",
"time_taken": 3.42,
"flights": [
{
"position": 1,
"is_best": true,
"airline": "IndiGo",
"flight_number": "6E 123",
"origin": "MAA",
"destination": "BLR",
"departure_time": "6:30 AM",
"arrival_time": "7:35 AM",
"duration": "1 hr 5 min",
"duration_minutes": 65,
"stops": 0,
"price": "₹4,213",
"price_value": 4213
}
]
}