@gojinko/api-client 2.20.0 → 2.21.0

package/dist/types/generated.d.ts

@@ -16,9 +16,7 @@ export interface paths {
          */
         get: {
             parameters: {
-                query: {
-                    /** @description Analysis mode. `trend` is accepted but currently returns snapshot-shaped data. */
-                    analysis: components["parameters"]["analysis"];
+                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. */
@@ -41,10 +39,8 @@ 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 (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. */
+                    /** @description 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). */
                     snapshot_window_days?: components["parameters"]["snapshotWindowDays"];
-                    /** @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"];
                 };
@@ -105,8 +101,6 @@ export interface paths {
         get: {
             parameters: {
                 query: {
-                    /** @description Analysis mode. `trend` is accepted but currently returns snapshot-shaped data. */
-                    analysis: components["parameters"]["analysis"];
                     /** @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. */
@@ -129,10 +123,8 @@ 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 (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. */
+                    /** @description 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). */
                     snapshot_window_days?: components["parameters"]["snapshotWindowDays"];
-                    /** @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"];
                 };
@@ -193,8 +185,6 @@ export interface paths {
         get: {
             parameters: {
                 query: {
-                    /** @description Analysis mode. `trend` is accepted but currently returns snapshot-shaped data. */
-                    analysis: components["parameters"]["analysis"];
                     /** @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. */
@@ -215,10 +205,8 @@ 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 (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. */
+                    /** @description 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). */
                     snapshot_window_days?: components["parameters"]["snapshotWindowDays"];
-                    /** @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,7 +253,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/evolution": {
+    "/v1/trend": {
         parameters: {
             query?: never;
             header?: never;
@@ -273,8 +261,8 @@ export interface paths {
             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.
+         * Demand time series for explicit origin/destination pairs
+         * @description Deep dive: returns one 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: {
@@ -301,9 +289,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 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. */
+                    /** @description Number of buckets N in the chosen granularity's own unit (min 2; max depends on granularity: day <= 60, week <= 52, month <= 12; default 12 applied server-side). The series spans the last N complete buckets, excluding the in-progress one. */
+                    trend_window?: components["parameters"]["trendWindow"];
+                    /** @description Bucket size for the returned series: week (default), day, or month. */
                     granularity?: components["parameters"]["granularity"];
                 };
                 header?: never;
@@ -318,7 +306,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["EvolutionResponse"];
+                        "application/json": components["schemas"]["TrendResponse"];
                     };
                 };
                 /** @description Authentication required */
@@ -349,7 +337,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/destination/evolution": {
+    "/v1/destination/trend": {
         parameters: {
             query?: never;
             header?: never;
@@ -357,8 +345,8 @@ export interface paths {
             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.
+         * 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 series.
          */
         get: {
             parameters: {
@@ -385,12 +373,12 @@ 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 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. */
+                    /** @description Number of buckets N in the chosen granularity's own unit (min 2; max depends on granularity: day <= 60, week <= 52, month <= 12; default 12 applied server-side). The series spans the last N complete buckets, excluding the in-progress one. */
+                    trend_window?: components["parameters"]["trendWindow"];
+                    /** @description Bucket size for the returned series: week (default), day, or month. */
                     granularity?: components["parameters"]["granularity"];
-                    /** @description Evolution endpoints: maximum number of series (top-N keys). Default 10, max 50. */
-                    limit?: components["parameters"]["evolutionLimit"];
+                    /** @description Trend endpoints: maximum number of series (top-N keys). Default 10, max 50. */
+                    limit?: components["parameters"]["trendLimit"];
                 };
                 header?: never;
                 path?: never;
@@ -404,7 +392,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["EvolutionResponse"];
+                        "application/json": components["schemas"]["TrendResponse"];
                     };
                 };
                 /** @description Authentication required */
@@ -435,7 +423,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/market/evolution": {
+    "/v1/market/trend": {
         parameters: {
             query?: never;
             header?: never;
@@ -443,8 +431,8 @@ export interface paths {
             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.
+         * 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 series. `destination` is required.
          */
         get: {
             parameters: {
@@ -471,12 +459,12 @@ 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 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. */
+                    /** @description Number of buckets N in the chosen granularity's own unit (min 2; max depends on granularity: day <= 60, week <= 52, month <= 12; default 12 applied server-side). The series spans the last N complete buckets, excluding the in-progress one. */
+                    trend_window?: components["parameters"]["trendWindow"];
+                    /** @description Bucket size for the returned series: week (default), day, or month. */
                     granularity?: components["parameters"]["granularity"];
-                    /** @description Evolution endpoints: maximum number of series (top-N keys). Default 10, max 50. */
-                    limit?: components["parameters"]["evolutionLimit"];
+                    /** @description Trend endpoints: maximum number of series (top-N keys). Default 10, max 50. */
+                    limit?: components["parameters"]["trendLimit"];
                 };
                 header?: never;
                 path?: never;
@@ -490,7 +478,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["EvolutionResponse"];
+                        "application/json": components["schemas"]["TrendResponse"];
                     };
                 };
                 /** @description Authentication required */
@@ -521,7 +509,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/audience/evolution": {
+    "/v1/audience/trend": {
         parameters: {
             query?: never;
             header?: never;
@@ -529,8 +517,8 @@ export interface paths {
             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.
+         * Demand time series for the traveler-type mix
+         * @description Returns a 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: {
@@ -555,12 +543,12 @@ 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 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. */
+                    /** @description Number of buckets N in the chosen granularity's own unit (min 2; max depends on granularity: day <= 60, week <= 52, month <= 12; default 12 applied server-side). The series spans the last N complete buckets, excluding the in-progress one. */
+                    trend_window?: components["parameters"]["trendWindow"];
+                    /** @description Bucket size for the returned series: week (default), day, or month. */
                     granularity?: components["parameters"]["granularity"];
-                    /** @description Evolution endpoints: maximum number of series (top-N keys). Default 10, max 50. */
-                    limit?: components["parameters"]["evolutionLimit"];
+                    /** @description Trend endpoints: maximum number of series (top-N keys). Default 10, max 50. */
+                    limit?: components["parameters"]["trendLimit"];
                 };
                 header?: never;
                 path?: never;
@@ -574,7 +562,7 @@ export interface paths {
                         [name: string]: unknown;
                     };
                     content: {
-                        "application/json": components["schemas"]["EvolutionResponse"];
+                        "application/json": components["schemas"]["TrendResponse"];
                     };
                 };
                 /** @description Authentication required */
@@ -3544,8 +3532,6 @@ export interface components {
             last_name?: string;
         };
         /** @enum {string} */
-        AnalysisType: "snapshot" | "trend";
-        /** @enum {string} */
         TravelPeriod: "Summer" | "Winter" | "Christmas" | "Easter" | "Next30Days" | "Next90Days" | "Custom";
         /** @enum {string} */
         TravelerType: "Solo" | "Couple" | "Group" | "Family";
@@ -3556,52 +3542,34 @@ export interface components {
             destination: string;
             /** Format: double */
             share?: number;
-            /**
-             * Format: double
-             * @description Growth % in trend mode (analysis=trend); omitted in snapshot.
-             */
-            growth?: number;
         };
         MarketRow: {
             rank?: number;
             market: string;
             /** Format: double */
             share?: number;
-            /**
-             * Format: double
-             * @description Growth % in trend mode (analysis=trend); omitted in snapshot.
-             */
-            growth?: number;
         };
         AudienceRow: {
             rank?: number;
             audience: string;
             /** Format: double */
             share?: number;
-            /**
-             * Format: double
-             * @description Growth % in trend mode (analysis=trend); omitted in snapshot.
-             */
-            growth?: number;
         };
         DestinationResponse: {
-            analysis_type: components["schemas"]["AnalysisType"];
             rows: components["schemas"]["DestinationRow"][];
         };
         MarketResponse: {
-            analysis_type: components["schemas"]["AnalysisType"];
             rows: components["schemas"]["MarketRow"][];
         };
         AudienceResponse: {
-            analysis_type: components["schemas"]["AnalysisType"];
             rows: components["schemas"]["AudienceRow"][];
         };
         /**
-         * @description Bucket size for an evolution series: day (default), week, or month.
+         * @description Bucket size for a trend series: week (default), day, or month.
          * @enum {string}
          */
         Granularity: "day" | "week" | "month";
-        EvolutionPoint: {
+        TrendPoint: {
             /**
              * Format: date
              * @description Bucket start date (YYYY-MM-DD).
@@ -3644,7 +3612,7 @@ export interface components {
              */
             peak_value?: number;
         };
-        EvolutionSeries: {
+        TrendSeries: {
             /**
              * @description Ranked dimension value (destination/market/audience endpoints); omitted for the pairs endpoint.
              * @example Country:FR
@@ -3660,10 +3628,10 @@ export interface components {
              * @example Country:FR
              */
             destination?: string;
-            series: components["schemas"]["EvolutionPoint"][];
+            series: components["schemas"]["TrendPoint"][];
             summary?: components["schemas"]["SeriesSummary"];
         };
-        EvolutionResponse: {
+        TrendResponse: {
             granularity: components["schemas"]["Granularity"];
             /**
              * Format: date
@@ -3677,13 +3645,11 @@ export interface components {
              * @example 2026-06-25
              */
             to: string;
-            series: components["schemas"]["EvolutionSeries"][];
+            series: components["schemas"]["TrendSeries"][];
         };
     };
     responses: never;
     parameters: {
-        /** @description Analysis mode. `trend` is accepted but currently returns snapshot-shaped data. */
-        analysis: components["schemas"]["AnalysisType"];
         /** @description Origin market filter as <Level>:<Code>, e.g. Country:US or City:NYC. */
         originMarket: string;
         /** @description Optional destination filter as <Level>:<Code>, e.g. Country:TH. */
@@ -3708,22 +3674,20 @@ 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 (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. */
+        /** @description 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). */
         snapshotWindowDays: number;
-        /** @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. */
+        /** @description Number of buckets N in the chosen granularity's own unit (min 2; max depends on granularity: day <= 60, week <= 52, month <= 12; default 12 applied server-side). The series spans the last N complete buckets, excluding the in-progress one. */
+        trendWindow: number;
+        /** @description Bucket size for the returned series: week (default), day, or month. */
         granularity: components["schemas"]["Granularity"];
-        /** @description Evolution endpoints: maximum number of series (top-N keys). Default 10, max 50. */
-        evolutionLimit: number;
+        /** @description Trend endpoints: maximum number of series (top-N keys). Default 10, max 50. */
+        trendLimit: number;
     };
     requestBodies: never;
     headers: never;