Skip to content

Commit 4963b73

Browse files
chore: update engine schemas
1 parent 8bf299e commit 4963b73

11 files changed

Lines changed: 228 additions & 18 deletions

engines/amazon_product.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -345,6 +345,11 @@
345345
"type": "checkbox",
346346
"description": "Include results from other sellers.",
347347
"group": "advanced_amazon_parameters"
348+
},
349+
"all_related_products": {
350+
"type": "checkbox",
351+
"description": "Set to `true` to retrieve all items in `related_products` and `related_product_sections`, not just the first page. May yield better results but with a longer response time. Defaults to `false`.",
352+
"group": "advanced_amazon_parameters"
348353
}
349354
},
350355
"common_params": {

engines/apple_maps.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@
3939
},
4040
"open_at": {
4141
"type": "number",
42-
"description": "Parameter defines the time at which result locations should be open at. The value must be a Unix timestamp that is in the future, and no more than 24 hours from the current time. (e.g. `1786766046`).",
42+
"description": "Parameter defines the time at which result locations should be open at. The value must be a Unix timestamp that is in the future, and no more than 24 hours from the current time. (e.g. `1787587288`).",
4343
"group": "refinement"
4444
},
4545
"locale": {

engines/baidu.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@
3636
"group": "pagination"
3737
},
3838
"gpc": {
39-
"description": "Parameter defines the time period for results. (e.g., `stf=1786125246,1786730046|stftype=1` only returns results from the past 7 days. First integer within the parameter,`1786125246` is Unix Timestamp for 7 days ago. Second integer,`1786730046` is Unix Timestamp for now.).",
39+
"description": "Parameter defines the time period for results. (e.g., `stf=1786946488,1787551288|stftype=1` only returns results from the past 7 days. First integer within the parameter,`1786946488` is Unix Timestamp for 7 days ago. Second integer,`1787551288` is Unix Timestamp for now.).",
4040
"group": "advanced_filters"
4141
},
4242
"q5": {

engines/google_flights.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -522,11 +522,11 @@
522522
"group": "advanced_google_flights_parameters"
523523
},
524524
"outbound_date": {
525-
"description": "Parameter defines the outbound date. The format is YYYY-MM-DD. e.g. `2026-08-15`",
525+
"description": "Parameter defines the outbound date. The format is YYYY-MM-DD. e.g. `2026-08-25`",
526526
"group": "advanced_google_flights_parameters"
527527
},
528528
"return_date": {
529-
"description": "Parameter defines the return date. The format is YYYY-MM-DD. e.g. `2026-08-21` Parameter is required if type parameter is set to: `1` (Round trip)",
529+
"description": "Parameter defines the return date. The format is YYYY-MM-DD. e.g. `2026-08-31` Parameter is required if type parameter is set to: `1` (Round trip)",
530530
"group": "advanced_google_flights_parameters"
531531
},
532532
"travel_class": {
@@ -553,7 +553,7 @@
553553
"group": "advanced_google_flights_parameters"
554554
},
555555
"multi_city_json": {
556-
"description": "Parameter defines the flight information for multi-city flights. It's a JSON string containing multiple flight information objects. Each object should contain the following fields: `departure_id` - The departure airport code or location kgmid. The format is the same as the main departure\\_id parameter. `arrival_id` - The arrival airport code or location kgmid. The format is the same as the main arrival\\_id parameter. `date` - Flight date. The format is the same as the outbound\\_date parameter. `times` - Time range for the flight. The format is the same as the outbound\\_times parameter. This parameter is optional. Example: `[{\"departure_id\":\"CDG\",\"arrival_id\":\"NRT\",\"date\":\"2026-08-21\"},{\"departure_id\":\"NRT\",\"arrival_id\":\"LAX,SEA\",\"date\":\"2026-08-28\"},{\"departure_id\":\"LAX,SEA\",\"arrival_id\":\"AUS\",\"date\":\"2026-09-04\",\"times\":\"8,18,9,23\"}]` The example is a multi-city flight from `CDG` to `NRT` on `2026-08-21`, then from `NRT` to `LAX` or `SEA` on `2026-08-28`, and finally from `LAX` or `SEA` to `AUS` on `2026-09-04`. The last flight has a departure time range from 8:00 AM to 7:00 PM and an arrival time range from 9:00 AM to 12:00 AM (Midnight).",
556+
"description": "Parameter defines the flight information for multi-city flights. It's a JSON string containing multiple flight information objects. Each object should contain the following fields: `departure_id` - The departure airport code or location kgmid. The format is the same as the main departure\\_id parameter. `arrival_id` - The arrival airport code or location kgmid. The format is the same as the main arrival\\_id parameter. `date` - Flight date. The format is the same as the outbound\\_date parameter. `times` - Time range for the flight. The format is the same as the outbound\\_times parameter. This parameter is optional. Example: `[{\"departure_id\":\"CDG\",\"arrival_id\":\"NRT\",\"date\":\"2026-08-31\"},{\"departure_id\":\"NRT\",\"arrival_id\":\"LAX,SEA\",\"date\":\"2026-09-07\"},{\"departure_id\":\"LAX,SEA\",\"arrival_id\":\"AUS\",\"date\":\"2026-09-14\",\"times\":\"8,18,9,23\"}]` The example is a multi-city flight from `CDG` to `NRT` on `2026-08-31`, then from `NRT` to `LAX` or `SEA` on `2026-09-07`, and finally from `LAX` or `SEA` to `AUS` on `2026-09-14`. The last flight has a departure time range from 8:00 AM to 7:00 PM and an arrival time range from 9:00 AM to 12:00 AM (Midnight).",
557557
"group": "advanced_google_flights_parameters"
558558
},
559559
"show_hidden": {
@@ -696,7 +696,7 @@
696696
"group": "advanced_filters"
697697
},
698698
"selected_flights_json": {
699-
"description": "Parameter pins the itinerary to specific flights, segment by segment. It's a JSON object with an `outbound` key (required) and a `return` key (required for round-trip, forbidden for one-way). Each value is an ordered array of flight segment objects, each containing: `flight_number` - IATA flight number (2-character airline code + 1–4 digits, e.g. `BA591`). `departure_id` - 3-letter IATA airport code for that segment's departure. `arrival_id` - 3-letter IATA airport code for that segment's arrival. `date` - Departure date of that segment, `YYYY-MM-DD`. Within a leg, each segment's `departure_id` must equal the previous segment's `arrival_id`, and dates must be non-decreasing. Example (round-trip `MXP → LHR → MAD` outbound, `MAD → MXP` nonstop return): `{\"outbound\":[{\"flight_number\":\"BA591\",\"departure_id\":\"MXP\",\"arrival_id\":\"LHR\",\"date\":\"2026-08-15\"},{\"flight_number\":\"BA460\",\"departure_id\":\"LHR\",\"arrival_id\":\"MAD\",\"date\":\"2026-08-15\"}],\"return\":[{\"flight_number\":\"IB675\",\"departure_id\":\"MAD\",\"arrival_id\":\"MXP\",\"date\":\"2026-08-21\"}]}` When this parameter is provided, the top-level departure\\_id, arrival\\_id, outbound\\_date and return\\_date are optional and derived from the first/last segments of each leg. If supplied, they must match. Cannot be used together with departure\\_token, booking\\_token, or multi\\_city\\_json (`type` = 3).",
699+
"description": "Parameter pins the itinerary to specific flights, segment by segment. It's a JSON object with an `outbound` key (required) and a `return` key (required for round-trip, forbidden for one-way). Each value is an ordered array of flight segment objects, each containing: `flight_number` - IATA flight number (2-character airline code + 1–4 digits, e.g. `BA591`). `departure_id` - 3-letter IATA airport code for that segment's departure. `arrival_id` - 3-letter IATA airport code for that segment's arrival. `date` - Departure date of that segment, `YYYY-MM-DD`. Within a leg, each segment's `departure_id` must equal the previous segment's `arrival_id`, and dates must be non-decreasing. Example (round-trip `MXP → LHR → MAD` outbound, `MAD → MXP` nonstop return): `{\"outbound\":[{\"flight_number\":\"BA591\",\"departure_id\":\"MXP\",\"arrival_id\":\"LHR\",\"date\":\"2026-08-25\"},{\"flight_number\":\"BA460\",\"departure_id\":\"LHR\",\"arrival_id\":\"MAD\",\"date\":\"2026-08-25\"}],\"return\":[{\"flight_number\":\"IB675\",\"departure_id\":\"MAD\",\"arrival_id\":\"MXP\",\"date\":\"2026-08-31\"}]}` When this parameter is provided, the top-level departure\\_id, arrival\\_id, outbound\\_date and return\\_date are optional and derived from the first/last segments of each leg. If supplied, they must match. Cannot be used together with departure\\_token, booking\\_token, or multi\\_city\\_json (`type` = 3).",
700700
"group": "selected_flights"
701701
},
702702
"departure_token": {

engines/google_flights_deals.json

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -537,11 +537,11 @@
537537
"group": "advanced_google_flights_parameters"
538538
},
539539
"outbound_date": {
540-
"description": "Parameter defines when you want to depart. Use a single YYYY-MM-DD date for an exact departure date, or two comma-separated dates for a flexible departure window. Examples: `2026-08-15` — depart on this exact date `2026-08-15,2026-09-13` — depart anytime within this window With a **single date**: return\\_date (single date) is required for round trip flights. With a **date range**: optionally combine with one of return\\_date (as a range), travel\\_duration, or trip\\_length to control the trip length. If none are provided, deals of any duration are returned. If omitted entirely, deals for any date are returned.",
540+
"description": "Parameter defines when you want to depart. Use a single YYYY-MM-DD date for an exact departure date, or two comma-separated dates for a flexible departure window. Examples: `2026-08-25` — depart on this exact date `2026-08-25,2026-09-23` — depart anytime within this window With a **single date**: return\\_date (single date) is required for round trip flights. With a **date range**: optionally combine with one of return\\_date (as a range), travel\\_duration, or trip\\_length to control the trip length. If none are provided, deals of any duration are returned. If omitted entirely, deals for any date are returned.",
541541
"group": "date_parameters"
542542
},
543543
"return_date": {
544-
"description": "Parameter defines when you want to return. Use a single YYYY-MM-DD date for an exact return date, or two comma-separated dates for a flexible return window. Examples: `2026-08-21` — return on this exact date (use with a single outbound\\_date) `2026-08-21,2026-09-20` — return anytime within this window (use with a range outbound\\_date) Not available for one-way flights (type = `2`). A single return\\_date must be paired with a single outbound\\_date. A range return\\_date must be paired with a range outbound\\_date. Cannot be combined with travel\\_duration or trip\\_length (use one or the other to define trip length).",
544+
"description": "Parameter defines when you want to return. Use a single YYYY-MM-DD date for an exact return date, or two comma-separated dates for a flexible return window. Examples: `2026-08-31` — return on this exact date (use with a single outbound\\_date) `2026-08-31,2026-09-30` — return anytime within this window (use with a range outbound\\_date) Not available for one-way flights (type = `2`). A single return\\_date must be paired with a single outbound\\_date. A range return\\_date must be paired with a range outbound\\_date. Cannot be combined with travel\\_duration or trip\\_length (use one or the other to define trip length).",
545545
"group": "date_parameters"
546546
},
547547
"travel_duration": {
@@ -560,11 +560,11 @@
560560
"2 weeks - 3"
561561
]
562562
],
563-
"description": "Parameter defines a preset trip duration when searching with flexible dates. Available options: `1` - 1 week (default) `2` - Weekend `3` - 2 weeks Can be used alone (deals of this duration, any departure date) or with outbound\\_date as a date range (e.g., `2026-08-15,2026-09-13`) to limit the departure window. Cannot be combined with return\\_date or trip\\_length. Not available for one-way flights (type = `2`).",
563+
"description": "Parameter defines a preset trip duration when searching with flexible dates. Available options: `1` - 1 week (default) `2` - Weekend `3` - 2 weeks Can be used alone (deals of this duration, any departure date) or with outbound\\_date as a date range (e.g., `2026-08-25,2026-09-23`) to limit the departure window. Cannot be combined with return\\_date or trip\\_length. Not available for one-way flights (type = `2`).",
564564
"group": "date_parameters"
565565
},
566566
"trip_length": {
567-
"description": "Parameter defines a custom trip length in days when searching with flexible dates. Provide a single number for an exact duration, or two comma-separated numbers for a min/max range. Examples: `7` — exactly 7 days `5,10` — between 5 and 10 days Can be used alone (deals of this length, any departure date) or with outbound\\_date as a date range (e.g., `2026-08-15,2026-09-13`) to limit the departure window. Cannot be combined with return\\_date or travel\\_duration. Not available for one-way flights (type = `2`). Each value must be at least `1`. When two values are provided, the first (min) must be ≤ the second (max).",
567+
"description": "Parameter defines a custom trip length in days when searching with flexible dates. Provide a single number for an exact duration, or two comma-separated numbers for a min/max range. Examples: `7` — exactly 7 days `5,10` — between 5 and 10 days Can be used alone (deals of this length, any departure date) or with outbound\\_date as a date range (e.g., `2026-08-25,2026-09-23`) to limit the departure window. Cannot be combined with return\\_date or travel\\_duration. Not available for one-way flights (type = `2`). Each value must be at least `1`. When two values are provided, the first (min) must be ≤ the second (max).",
568568
"group": "date_parameters"
569569
},
570570
"adults": {

engines/google_hotels.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -501,12 +501,12 @@
501501
},
502502
"check_in_date": {
503503
"required": true,
504-
"description": "Parameter defines the check-in date. The format is **YYYY-MM-DD**. e.g. `2026-08-15`",
504+
"description": "Parameter defines the check-in date. The format is **YYYY-MM-DD**. e.g. `2026-08-25`",
505505
"group": "advanced_parameters"
506506
},
507507
"check_out_date": {
508508
"required": true,
509-
"description": "Parameter defines the check-out date. The format is **YYYY-MM-DD**. e.g. `2026-08-16`",
509+
"description": "Parameter defines the check-out date. The format is **YYYY-MM-DD**. e.g. `2026-08-26`",
510510
"group": "advanced_parameters"
511511
},
512512
"adults": {

engines/google_play_books.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
"engine": "google_play_books",
33
"params": {
44
"q": {
5-
"description": "Parameter defines the query you want to search in Google Play Books Store.",
5+
"description": "Parameter defines the query you want to search in Google Play Books Store, such as a book title or author. Google also usually accepts ISBN numbers like `9780593135211` if there is an exact match, and if dashes and spaces are excluded.",
66
"group": "search_query"
77
},
88
"gl": {
@@ -878,7 +878,7 @@
878878
"coll_1704",
879879
"coll_1705"
880880
],
881-
"description": "Parameter defines the books store category. Head to the Google Play store Books Categories for a full list of supported Google Play Books store categories.",
881+
"description": "Parameter defines the books store category. See the Google Play Store's book categories for a full list.",
882882
"group": "google_play_categories"
883883
},
884884
"price": {

engines/google_play_movies.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -579,7 +579,7 @@
579579
"Family - Sci-fi & fantasy"
580580
]
581581
],
582-
"description": "Parameter defines the movies store category. Head to the Google Play store Movies Categories for a full list of supported Google Play Books store categories.",
582+
"description": "Parameter defines the movies store category. See the Google Play Store's movie categories for a full list.",
583583
"group": "google_play_categories"
584584
},
585585
"age": {

engines/google_travel_explore.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -523,11 +523,11 @@
523523
"group": "advanced_google_travel_explore_parameters"
524524
},
525525
"outbound_date": {
526-
"description": "Parameter defines the outbound date. The format is YYYY-MM-DD. e.g. `2026-08-15`",
526+
"description": "Parameter defines the outbound date. The format is YYYY-MM-DD. e.g. `2026-08-25`",
527527
"group": "advanced_google_travel_explore_parameters"
528528
},
529529
"return_date": {
530-
"description": "Parameter defines the return date. The format is YYYY-MM-DD. e.g. `2026-08-21` Parameter is required if type parameter is set to: `1` (Round trip)",
530+
"description": "Parameter defines the return date. The format is YYYY-MM-DD. e.g. `2026-08-31` Parameter is required if type parameter is set to: `1` (Round trip)",
531531
"group": "advanced_google_travel_explore_parameters"
532532
},
533533
"month": {

engines/home_depot.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@
8383
},
8484
"ps": {
8585
"type": "number",
86-
"description": "Determines the number of items per page. There are scenarios where The Home Depot overrides the ps value. By default, The Home Depot returns `24` results. The maximum number of results it can return is `48`.",
86+
"description": "Determines the number of items per page. There are scenarios where The Home Depot overrides the ps value. By default, The Home Depot returns `24` (maximum allowed value) results.",
8787
"group": "pagination"
8888
},
8989
"pagesize": {

0 commit comments

Comments
 (0)