feat(flights): add sort_by (top|price) for full price-sorted inventory

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.22.0] - 2026-07-23
+
+### Added
+
+- **Google Flights `sort_by`** — `client.google.flights.search({ ..., sort_by: "price" })` now returns the FULL price-sorted inventory (every carrier, the cheap long-layover fares) plus Google's own price floor, typical range, and price history, instead of only the ~6-8 "best" preview. Default `sort_by: "top"` keeps the fast best-picks behaviour. (SCR-123)
+
 ## [0.21.0] - 2026-07-17
 
 ### Added

package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrapebadger",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Official Node.js SDK for ScrapeBadger - Async web scraping APIs for Twitter, Google, Vinted, Reddit, and more",
   "type": "module",
   "main": "./dist/index.js",

src/google/index.ts

@@ -32,6 +32,7 @@ export type {
   AutocompleteParams,
   FinanceQuoteParams,
   FlightsSearchParams,
+  FlightsSortBy,
   FlightsStopsFilter,
   FlightsTravelClass,
   FlightsTripType,

src/google/types.ts

@@ -647,6 +647,8 @@ export type FlightsTripType = "round_trip" | "one_way" | "multi_city";
 export type FlightsTravelClass = "economy" | "premium_economy" | "business" | "first";
 export type FlightsStopsFilter = "any" | "nonstop" | "one_stop" | "two_stops";
 
+export type FlightsSortBy = "top" | "price";
+
 export interface FlightsSearchParams {
   /** Departure airport IATA code (e.g. "JFK") or location ID. */
   departure_id: string;
@@ -673,4 +675,12 @@ export interface FlightsSearchParams {
   stops?: FlightsStopsFilter;
   /** Upper price filter. */
   max_price?: number;
+  /**
+   * `"top"` (default) returns Google's ~6-8 "best" picks (fast). `"price"`
+   * returns the FULL price-sorted inventory (every carrier, the cheap
+   * long-layover fares) plus Google's own price floor, typical range, and
+   * price history — slower, and falls back to the "top" set under load.
+   * Round-trip initial search only.
+   */
+  sort_by?: FlightsSortBy;
 }

src/index.ts

@@ -142,6 +142,7 @@ export type {
   AutocompleteParams,
   FinanceQuoteParams,
   FlightsSearchParams,
+  FlightsSortBy,
   FlightsStopsFilter,
   FlightsTravelClass,
   FlightsTripType,

src/internal/version.ts

@@ -6,4 +6,4 @@
  *
  * @internal
  */
-export const SDK_VERSION = "0.16.0";
+export const SDK_VERSION = "0.22.0";