@gojinko/api-client 2.19.0 → 2.20.0

package/dist/types/generated.d.ts

@@ -41,9 +41,9 @@ export interface paths {
                     search_window_min?: components["parameters"]["searchWindowMin"];
                     /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
                     search_window_max?: components["parameters"]["searchWindowMax"];
-                    /** @description Snapshot mode only: number of most-recent days of search activity aggregated into the demand level (default 7, max 90 — the cube retains 90 days). Rejected when analysis=trend. */
+                    /** @description Snapshot mode only: number of most-recent days of search activity aggregated into the demand level (min 2, default 7, max 90 — a 1-day window is the current day, whose data is incomplete; the cube retains 90 days). Rejected when analysis=trend. */
                     snapshot_window_days?: components["parameters"]["snapshotWindowDays"];
-                    /** @description Trend mode only: size in days of each of the two adjacent windows compared for growth (default 7, max 45 — a trend spans 2x the window within the cube's 90-day retention). Rejected when analysis=snapshot. */
+                    /** @description Trend mode only: size in days of each of the two adjacent windows compared for growth (min 2, default 7, max 45 — a 1-day window's recent period is the current day, whose data is incomplete; a trend spans 2x the window within the cube's 90-day retention). Rejected when analysis=snapshot. */
                     trend_window_days?: components["parameters"]["trendWindowDays"];
                     /** @description Max rows (1-200, default 20). */
                     limit?: components["parameters"]["limit"];
@@ -129,9 +129,9 @@ export interface paths {
                     search_window_min?: components["parameters"]["searchWindowMin"];
                     /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
                     search_window_max?: components["parameters"]["searchWindowMax"];
-                    /** @description Snapshot mode only: number of most-recent days of search activity aggregated into the demand level (default 7, max 90 — the cube retains 90 days). Rejected when analysis=trend. */
+                    /** @description Snapshot mode only: number of most-recent days of search activity aggregated into the demand level (min 2, default 7, max 90 — a 1-day window is the current day, whose data is incomplete; the cube retains 90 days). Rejected when analysis=trend. */
                     snapshot_window_days?: components["parameters"]["snapshotWindowDays"];
-                    /** @description Trend mode only: size in days of each of the two adjacent windows compared for growth (default 7, max 45 — a trend spans 2x the window within the cube's 90-day retention). Rejected when analysis=snapshot. */
+                    /** @description Trend mode only: size in days of each of the two adjacent windows compared for growth (min 2, default 7, max 45 — a 1-day window's recent period is the current day, whose data is incomplete; a trend spans 2x the window within the cube's 90-day retention). Rejected when analysis=snapshot. */
                     trend_window_days?: components["parameters"]["trendWindowDays"];
                     /** @description Max rows (1-200, default 20). */
                     limit?: components["parameters"]["limit"];
@@ -215,9 +215,9 @@ export interface paths {
                     search_window_min?: components["parameters"]["searchWindowMin"];
                     /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
                     search_window_max?: components["parameters"]["searchWindowMax"];
-                    /** @description Snapshot mode only: number of most-recent days of search activity aggregated into the demand level (default 7, max 90 — the cube retains 90 days). Rejected when analysis=trend. */
+                    /** @description Snapshot mode only: number of most-recent days of search activity aggregated into the demand level (min 2, default 7, max 90 — a 1-day window is the current day, whose data is incomplete; the cube retains 90 days). Rejected when analysis=trend. */
                     snapshot_window_days?: components["parameters"]["snapshotWindowDays"];
-                    /** @description Trend mode only: size in days of each of the two adjacent windows compared for growth (default 7, max 45 — a trend spans 2x the window within the cube's 90-day retention). Rejected when analysis=snapshot. */
+                    /** @description Trend mode only: size in days of each of the two adjacent windows compared for growth (min 2, default 7, max 45 — a 1-day window's recent period is the current day, whose data is incomplete; a trend spans 2x the window within the cube's 90-day retention). Rejected when analysis=snapshot. */
                     trend_window_days?: components["parameters"]["trendWindowDays"];
                     /** @description Max rows (1-200, default 20). */
                     limit?: components["parameters"]["limit"];
@@ -265,6 +265,346 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/evolution": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Daily demand time series for explicit origin/destination pairs
+         * @description Deep dive: returns one daily de-sampled search-volume series per (origin, destination) pair. v1 allows a list on only one side — a single origin with many destinations, or many origins with a single destination.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Pairs endpoint: comma-separated origin selectors `<Level>:<Code>` (e.g. `Country:US,Country:CA`). v1: at most one of origins/destinations may have more than one entry. */
+                    origins: components["parameters"]["origins"];
+                    /** @description Pairs endpoint: comma-separated destination selectors `<Level>:<Code>` (e.g. `Country:FR,Country:DE`). */
+                    destinations: components["parameters"]["destinations"];
+                    /** @description Named departure window (defaults to Next90Days server-side). */
+                    travel_period?: components["parameters"]["travelPeriod"];
+                    /** @description Start of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_from?: components["parameters"]["departureDateFrom"];
+                    /** @description End of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_to?: components["parameters"]["departureDateTo"];
+                    /** @description Optional traveler-type filter. */
+                    traveler_type?: components["parameters"]["travelerType"];
+                    /** @description Optional trip-type filter. */
+                    trip_type?: components["parameters"]["tripType"];
+                    /** @description Minimum trip length in nights (return_date − dep_date). Round-trips only; must be >= 0. */
+                    trip_duration_min?: components["parameters"]["tripDurationMin"];
+                    /** @description Maximum trip length in nights (must be >= trip_duration_min). */
+                    trip_duration_max?: components["parameters"]["tripDurationMax"];
+                    /** @description Minimum advance-purchase window in days (dep_date − search_date): searches made at least this many days before departure. Must be >= 0. */
+                    search_window_min?: components["parameters"]["searchWindowMin"];
+                    /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
+                    search_window_max?: components["parameters"]["searchWindowMax"];
+                    /** @description Size of the evolution window in days (min 2, default 7, max 45). The series spans the last N complete days ending yesterday; the current day is excluded as incomplete. */
+                    trend_window_days?: components["parameters"]["evolutionWindowDays"];
+                    /** @description Bucket size for the returned series: day (default), week, or month. */
+                    granularity?: components["parameters"]["granularity"];
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Per-pair demand time series */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["EvolutionResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/destination/evolution": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Daily demand time series for the top-N destinations
+         * @description Ranks destinations (optionally reachable from origin_market) by within-window growth, then returns each top-N destination's daily series.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Origin market filter as <Level>:<Code>, e.g. Country:US or City:NYC. */
+                    origin_market?: components["parameters"]["originMarket"];
+                    /** @description Optional destination filter as <Level>:<Code>, e.g. Country:TH. */
+                    destination?: components["parameters"]["destinationFilter"];
+                    /** @description Named departure window (defaults to Next90Days server-side). */
+                    travel_period?: components["parameters"]["travelPeriod"];
+                    /** @description Start of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_from?: components["parameters"]["departureDateFrom"];
+                    /** @description End of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_to?: components["parameters"]["departureDateTo"];
+                    /** @description Optional traveler-type filter. */
+                    traveler_type?: components["parameters"]["travelerType"];
+                    /** @description Optional trip-type filter. */
+                    trip_type?: components["parameters"]["tripType"];
+                    /** @description Minimum trip length in nights (return_date − dep_date). Round-trips only; must be >= 0. */
+                    trip_duration_min?: components["parameters"]["tripDurationMin"];
+                    /** @description Maximum trip length in nights (must be >= trip_duration_min). */
+                    trip_duration_max?: components["parameters"]["tripDurationMax"];
+                    /** @description Minimum advance-purchase window in days (dep_date − search_date): searches made at least this many days before departure. Must be >= 0. */
+                    search_window_min?: components["parameters"]["searchWindowMin"];
+                    /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
+                    search_window_max?: components["parameters"]["searchWindowMax"];
+                    /** @description Size of the evolution window in days (min 2, default 7, max 45). The series spans the last N complete days ending yesterday; the current day is excluded as incomplete. */
+                    trend_window_days?: components["parameters"]["evolutionWindowDays"];
+                    /** @description Bucket size for the returned series: day (default), week, or month. */
+                    granularity?: components["parameters"]["granularity"];
+                    /** @description Evolution endpoints: maximum number of series (top-N keys). Default 10, max 50. */
+                    limit?: components["parameters"]["evolutionLimit"];
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Top-N destination time series */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["EvolutionResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/market/evolution": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Daily demand time series for the top-N source markets
+         * @description Ranks source markets for a destination by within-window growth, then returns each top-N market's daily series. `destination` is required.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Destination as <Level>:<Code>, e.g. Country:TH. Required for this endpoint. */
+                    destination: components["parameters"]["destinationRequired"];
+                    /** @description Origin market filter as <Level>:<Code>, e.g. Country:US or City:NYC. */
+                    origin_market?: components["parameters"]["originMarket"];
+                    /** @description Named departure window (defaults to Next90Days server-side). */
+                    travel_period?: components["parameters"]["travelPeriod"];
+                    /** @description Start of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_from?: components["parameters"]["departureDateFrom"];
+                    /** @description End of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_to?: components["parameters"]["departureDateTo"];
+                    /** @description Optional traveler-type filter. */
+                    traveler_type?: components["parameters"]["travelerType"];
+                    /** @description Optional trip-type filter. */
+                    trip_type?: components["parameters"]["tripType"];
+                    /** @description Minimum trip length in nights (return_date − dep_date). Round-trips only; must be >= 0. */
+                    trip_duration_min?: components["parameters"]["tripDurationMin"];
+                    /** @description Maximum trip length in nights (must be >= trip_duration_min). */
+                    trip_duration_max?: components["parameters"]["tripDurationMax"];
+                    /** @description Minimum advance-purchase window in days (dep_date − search_date): searches made at least this many days before departure. Must be >= 0. */
+                    search_window_min?: components["parameters"]["searchWindowMin"];
+                    /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
+                    search_window_max?: components["parameters"]["searchWindowMax"];
+                    /** @description Size of the evolution window in days (min 2, default 7, max 45). The series spans the last N complete days ending yesterday; the current day is excluded as incomplete. */
+                    trend_window_days?: components["parameters"]["evolutionWindowDays"];
+                    /** @description Bucket size for the returned series: day (default), week, or month. */
+                    granularity?: components["parameters"]["granularity"];
+                    /** @description Evolution endpoints: maximum number of series (top-N keys). Default 10, max 50. */
+                    limit?: components["parameters"]["evolutionLimit"];
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Top-N market time series */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["EvolutionResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/audience/evolution": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Daily demand time series for the traveler-type mix
+         * @description Returns a daily series per traveler-type segment (Solo / Couple / Family / Group) of demand for a destination. `destination` is required; `traveler_type` is not a filter here — this endpoint buckets by it.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Destination as <Level>:<Code>, e.g. Country:TH. Required for this endpoint. */
+                    destination: components["parameters"]["destinationRequired"];
+                    /** @description Origin market filter as <Level>:<Code>, e.g. Country:US or City:NYC. */
+                    origin_market?: components["parameters"]["originMarket"];
+                    /** @description Named departure window (defaults to Next90Days server-side). */
+                    travel_period?: components["parameters"]["travelPeriod"];
+                    /** @description Start of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_from?: components["parameters"]["departureDateFrom"];
+                    /** @description End of departure window (YYYY-MM-DD). Required when travel_period=Custom. */
+                    departure_date_to?: components["parameters"]["departureDateTo"];
+                    /** @description Optional trip-type filter. */
+                    trip_type?: components["parameters"]["tripType"];
+                    /** @description Minimum trip length in nights (return_date − dep_date). Round-trips only; must be >= 0. */
+                    trip_duration_min?: components["parameters"]["tripDurationMin"];
+                    /** @description Maximum trip length in nights (must be >= trip_duration_min). */
+                    trip_duration_max?: components["parameters"]["tripDurationMax"];
+                    /** @description Minimum advance-purchase window in days (dep_date − search_date): searches made at least this many days before departure. Must be >= 0. */
+                    search_window_min?: components["parameters"]["searchWindowMin"];
+                    /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
+                    search_window_max?: components["parameters"]["searchWindowMax"];
+                    /** @description Size of the evolution window in days (min 2, default 7, max 45). The series spans the last N complete days ending yesterday; the current day is excluded as incomplete. */
+                    trend_window_days?: components["parameters"]["evolutionWindowDays"];
+                    /** @description Bucket size for the returned series: day (default), week, or month. */
+                    granularity?: components["parameters"]["granularity"];
+                    /** @description Evolution endpoints: maximum number of series (top-N keys). Default 10, max 50. */
+                    limit?: components["parameters"]["evolutionLimit"];
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Per-segment time series */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["EvolutionResponse"];
+                    };
+                };
+                /** @description Authentication required */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+                /** @description Validation error */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["ErrorResponse"];
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/health": {
         parameters: {
             query?: never;
@@ -3256,6 +3596,89 @@ export interface components {
             analysis_type: components["schemas"]["AnalysisType"];
             rows: components["schemas"]["AudienceRow"][];
         };
+        /**
+         * @description Bucket size for an evolution series: day (default), week, or month.
+         * @enum {string}
+         */
+        Granularity: "day" | "week" | "month";
+        EvolutionPoint: {
+            /**
+             * Format: date
+             * @description Bucket start date (YYYY-MM-DD).
+             * @example 2026-06-20
+             */
+            date: string;
+            /**
+             * Format: double
+             * @description De-sampled search volume for the bucket.
+             * @example 1234
+             */
+            value: number;
+        };
+        /** @description Per-series rollup over the returned window. */
+        SeriesSummary: {
+            /**
+             * Format: double
+             * @example 34567
+             */
+            total?: number;
+            /**
+             * Format: double
+             * @example 1191
+             */
+            avg_per_day?: number;
+            /**
+             * Format: double
+             * @description Within-window growth %: recent half vs. prior half. Null when the prior half is empty.
+             * @example 12.3
+             */
+            growth_pct?: number | null;
+            /**
+             * Format: date
+             * @example 2026-06-14
+             */
+            peak_date?: string;
+            /**
+             * Format: double
+             * @example 1890
+             */
+            peak_value?: number;
+        };
+        EvolutionSeries: {
+            /**
+             * @description Ranked dimension value (destination/market/audience endpoints); omitted for the pairs endpoint.
+             * @example Country:FR
+             */
+            label?: string;
+            /**
+             * @description Pairs endpoint only: the origin selector for this series.
+             * @example Country:US
+             */
+            origin?: string;
+            /**
+             * @description Pairs endpoint only: the destination selector for this series.
+             * @example Country:FR
+             */
+            destination?: string;
+            series: components["schemas"]["EvolutionPoint"][];
+            summary?: components["schemas"]["SeriesSummary"];
+        };
+        EvolutionResponse: {
+            granularity: components["schemas"]["Granularity"];
+            /**
+             * Format: date
+             * @description First (inclusive) bucket date of the window.
+             * @example 2026-06-19
+             */
+            from: string;
+            /**
+             * Format: date
+             * @description Last (inclusive) bucket date of the window.
+             * @example 2026-06-25
+             */
+            to: string;
+            series: components["schemas"]["EvolutionSeries"][];
+        };
     };
     responses: never;
     parameters: {
@@ -3285,12 +3708,22 @@ export interface components {
         searchWindowMin: number;
         /** @description Maximum advance-purchase window in days (must be >= search_window_min). */
         searchWindowMax: number;
-        /** @description Snapshot mode only: number of most-recent days of search activity aggregated into the demand level (default 7, max 90 — the cube retains 90 days). Rejected when analysis=trend. */
+        /** @description Snapshot mode only: number of most-recent days of search activity aggregated into the demand level (min 2, default 7, max 90 — a 1-day window is the current day, whose data is incomplete; the cube retains 90 days). Rejected when analysis=trend. */
         snapshotWindowDays: number;
-        /** @description Trend mode only: size in days of each of the two adjacent windows compared for growth (default 7, max 45 — a trend spans 2x the window within the cube's 90-day retention). Rejected when analysis=snapshot. */
+        /** @description Trend mode only: size in days of each of the two adjacent windows compared for growth (min 2, default 7, max 45 — a 1-day window's recent period is the current day, whose data is incomplete; a trend spans 2x the window within the cube's 90-day retention). Rejected when analysis=snapshot. */
         trendWindowDays: number;
         /** @description Max rows (1-200, default 20). */
         limit: number;
+        /** @description Pairs endpoint: comma-separated origin selectors `<Level>:<Code>` (e.g. `Country:US,Country:CA`). v1: at most one of origins/destinations may have more than one entry. */
+        origins: string;
+        /** @description Pairs endpoint: comma-separated destination selectors `<Level>:<Code>` (e.g. `Country:FR,Country:DE`). */
+        destinations: string;
+        /** @description Size of the evolution window in days (min 2, default 7, max 45). The series spans the last N complete days ending yesterday; the current day is excluded as incomplete. */
+        evolutionWindowDays: number;
+        /** @description Bucket size for the returned series: day (default), week, or month. */
+        granularity: components["schemas"]["Granularity"];
+        /** @description Evolution endpoints: maximum number of series (top-N keys). Default 10, max 50. */
+        evolutionLimit: number;
     };
     requestBodies: never;
     headers: never;