algolia 3.4.0 → 3.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a9faf3750eb1a9ce64b6901f3e112776847b50317c804adf7ccc30f76a6392bc
-  data.tar.gz: a5c4e70c12e4530f1b61b79cfca6d5c2962c3b4ea7d45db28d07e21615a213fa
+  metadata.gz: e9200f03830a6a4072814ecf540ec1c2ccd1c820a1302dd12a503f263066645d
+  data.tar.gz: 48ec72d14a23b49eef15e99dfdf4c9a1d46d4efc25020f844abe5f672b1e3acf
 SHA512:
-  metadata.gz: 4794af9dcf6a949e2d8c1da6cfe92098745b4cd8f271a48317347390bafc0872ce518178873b37daf11cc902b5c5e1ede033733804be141d9beafd49304b1aae
-  data.tar.gz: 162393a051eaec3b087b1651038fd9aa296524cfc335a76cbc2cadec3affeab3f87c3846c9decd2d7cdb7473617dd1af8ac96e3be668271f3f5a549f59184815
+  metadata.gz: 91c0f16ed9d08c1ab4b8c8743d72f493441bdc4f1f421c35ba7b7044025fb0ac38cba7928b4660c65abe01b878307ff298431d6ca21536b9a85fd056d1ec7033
+  data.tar.gz: c7118984d0a3e3db25d012ecd6abbe7d4e372360c85df3bff47382476f3a12386f084dbd14424d69ce8e0b6c8f739b218e04972acf7f71d1a02c54db07efa0de

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [3.5.0](https://github.com/algolia/algoliasearch-client-ruby/compare/3.4.0...3.5.0)
+
+- [ad8e3d224](https://github.com/algolia/api-clients-automation/commit/ad8e3d224) fix(specs): update analytics and abtesting max pagination query limit ([#3696](https://github.com/algolia/api-clients-automation/pull/3696)) by [@febeck](https://github.com/febeck/)
+- [bed119166](https://github.com/algolia/api-clients-automation/commit/bed119166) feat(specs): add support for widgets / banners in search for the csharp client ([#3870](https://github.com/algolia/api-clients-automation/pull/3870)) by [@Kalmar99](https://github.com/Kalmar99/)
+- [844e57f35](https://github.com/algolia/api-clients-automation/commit/844e57f35) fix(specs): correct typos is Search API ([#3898](https://github.com/algolia/api-clients-automation/pull/3898)) by [@gazconroy](https://github.com/gazconroy/)
+- [f554e09c3](https://github.com/algolia/api-clients-automation/commit/f554e09c3) chore: revert and fix release ([#3922](https://github.com/algolia/api-clients-automation/pull/3922)) by [@millotp](https://github.com/millotp/)
+
 ## [3.4.0](https://github.com/algolia/algoliasearch-client-ruby/compare/3.3.4...3.4.0)
 
 - [788483537](https://github.com/algolia/api-clients-automation/commit/788483537) chore(clients): add workflow to auto-close PR ([#3834](https://github.com/algolia/api-clients-automation/pull/3834)) by [@shortcuts](https://github.com/shortcuts/)

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    algolia (3.4.0)
+    algolia (3.5.0)
       base64 (>= 0.2.0, < 1)
       faraday (>= 1.0.1, < 3.0)
       faraday-net_http_persistent (>= 0.15, < 3)

data/lib/algolia/api/analytics_client.rb

@@ -800,8 +800,8 @@ module Algolia
     # @param index [String] Index name. (required)
     # @param start_date [String] Start date of the period to analyze, in `YYYY-MM-DD` format.
     # @param end_date [String] End date of the period to analyze, in `YYYY-MM-DD` format.
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the `offset` parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the `limit` parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with `OR` and `AND`. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -819,6 +819,20 @@ module Algolia
         raise ArgumentError, "Parameter `index` is required when calling `get_searches_no_clicks`."
       end
 
+      if @api_client.config.client_side_validation && !limit.nil? && limit > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"limit\"\" when calling AnalyticsClient.get_searches_no_clicks, must be smaller than or equal to 1000."
+        )
+      end
+
+      if @api_client.config.client_side_validation && !offset.nil? && offset > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"offset\"\" when calling AnalyticsClient.get_searches_no_clicks, must be smaller than or equal to 1000."
+        )
+      end
+
       if @api_client.config.client_side_validation && !offset.nil? && offset < 0
         raise(
           ArgumentError,
@@ -858,8 +872,8 @@ module Algolia
     # @param index [String] Index name. (required)
     # @param start_date [String] Start date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [GetSearchesNoClicksResponse]
@@ -894,8 +908,8 @@ module Algolia
     # @param index [String] Index name. (required)
     # @param start_date [String] Start date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -913,6 +927,20 @@ module Algolia
         raise ArgumentError, "Parameter `index` is required when calling `get_searches_no_results`."
       end
 
+      if @api_client.config.client_side_validation && !limit.nil? && limit > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"limit\"\" when calling AnalyticsClient.get_searches_no_results, must be smaller than or equal to 1000."
+        )
+      end
+
+      if @api_client.config.client_side_validation && !offset.nil? && offset > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"offset\"\" when calling AnalyticsClient.get_searches_no_results, must be smaller than or equal to 1000."
+        )
+      end
+
       if @api_client.config.client_side_validation && !offset.nil? && offset < 0
         raise(
           ArgumentError,
@@ -952,8 +980,8 @@ module Algolia
     # @param index [String] Index name. (required)
     # @param start_date [String] Start date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [GetSearchesNoResultsResponse]
@@ -1033,8 +1061,8 @@ module Algolia
     # @param index [String] Index name. (required)
     # @param start_date [String] Start date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -1052,6 +1080,20 @@ module Algolia
         raise ArgumentError, "Parameter `index` is required when calling `get_top_countries`."
       end
 
+      if @api_client.config.client_side_validation && !limit.nil? && limit > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"limit\"\" when calling AnalyticsClient.get_top_countries, must be smaller than or equal to 1000."
+        )
+      end
+
+      if @api_client.config.client_side_validation && !offset.nil? && offset > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"offset\"\" when calling AnalyticsClient.get_top_countries, must be smaller than or equal to 1000."
+        )
+      end
+
       if @api_client.config.client_side_validation && !offset.nil? && offset < 0
         raise(
           ArgumentError,
@@ -1091,8 +1133,8 @@ module Algolia
     # @param index [String] Index name. (required)
     # @param start_date [String] Start date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [GetTopCountriesResponse]
@@ -1120,8 +1162,8 @@ module Algolia
     # @param search [String] Search query.
     # @param start_date [String] Start date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -1140,6 +1182,20 @@ module Algolia
         raise ArgumentError, "Parameter `index` is required when calling `get_top_filter_attributes`."
       end
 
+      if @api_client.config.client_side_validation && !limit.nil? && limit > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"limit\"\" when calling AnalyticsClient.get_top_filter_attributes, must be smaller than or equal to 1000."
+        )
+      end
+
+      if @api_client.config.client_side_validation && !offset.nil? && offset > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"offset\"\" when calling AnalyticsClient.get_top_filter_attributes, must be smaller than or equal to 1000."
+        )
+      end
+
       if @api_client.config.client_side_validation && !offset.nil? && offset < 0
         raise(
           ArgumentError,
@@ -1181,8 +1237,8 @@ module Algolia
     # @param search [String] Search query.
     # @param start_date [String] Start date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [GetTopFilterAttributesResponse]
@@ -1221,8 +1277,8 @@ module Algolia
     # @param search [String] Search query.
     # @param start_date [String] Start date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -1246,6 +1302,20 @@ module Algolia
         raise ArgumentError, "Parameter `index` is required when calling `get_top_filter_for_attribute`."
       end
 
+      if @api_client.config.client_side_validation && !limit.nil? && limit > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"limit\"\" when calling AnalyticsClient.get_top_filter_for_attribute, must be smaller than or equal to 1000."
+        )
+      end
+
+      if @api_client.config.client_side_validation && !offset.nil? && offset > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"offset\"\" when calling AnalyticsClient.get_top_filter_for_attribute, must be smaller than or equal to 1000."
+        )
+      end
+
       if @api_client.config.client_side_validation && !offset.nil? && offset < 0
         raise(
           ArgumentError,
@@ -1288,8 +1358,8 @@ module Algolia
     # @param search [String] Search query.
     # @param start_date [String] Start date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [GetTopFilterForAttributeResponse]
@@ -1329,8 +1399,8 @@ module Algolia
     # @param search [String] Search query.
     # @param start_date [String] Start date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -1349,6 +1419,20 @@ module Algolia
         raise ArgumentError, "Parameter `index` is required when calling `get_top_filters_no_results`."
       end
 
+      if @api_client.config.client_side_validation && !limit.nil? && limit > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"limit\"\" when calling AnalyticsClient.get_top_filters_no_results, must be smaller than or equal to 1000."
+        )
+      end
+
+      if @api_client.config.client_side_validation && !offset.nil? && offset > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"offset\"\" when calling AnalyticsClient.get_top_filters_no_results, must be smaller than or equal to 1000."
+        )
+      end
+
       if @api_client.config.client_side_validation && !offset.nil? && offset < 0
         raise(
           ArgumentError,
@@ -1390,8 +1474,8 @@ module Algolia
     # @param search [String] Search query.
     # @param start_date [String] Start date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [GetTopFiltersNoResultsResponse]
@@ -1431,8 +1515,8 @@ module Algolia
     # @param revenue_analytics [Boolean] Whether to include revenue-related metrics in the response.  If true, metrics related to click and conversion events are also included in the response.  (default to false)
     # @param start_date [String] Start date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -1453,6 +1537,20 @@ module Algolia
         raise ArgumentError, "Parameter `index` is required when calling `get_top_hits`."
       end
 
+      if @api_client.config.client_side_validation && !limit.nil? && limit > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"limit\"\" when calling AnalyticsClient.get_top_hits, must be smaller than or equal to 1000."
+        )
+      end
+
+      if @api_client.config.client_side_validation && !offset.nil? && offset > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"offset\"\" when calling AnalyticsClient.get_top_hits, must be smaller than or equal to 1000."
+        )
+      end
+
       if @api_client.config.client_side_validation && !offset.nil? && offset < 0
         raise(
           ArgumentError,
@@ -1498,8 +1596,8 @@ module Algolia
     # @param revenue_analytics [Boolean] Whether to include revenue-related metrics in the response.  If true, metrics related to click and conversion events are also included in the response.  (default to false)
     # @param start_date [String] Start date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [GetTopHitsResponse]
@@ -1541,8 +1639,8 @@ module Algolia
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param order_by [OrderBy] Attribute by which to order the response items.  If the &#x60;clickAnalytics&#x60; parameter is false, only &#x60;searchCount&#x60; is available.  (default to 'searchCount')
     # @param direction [Direction] Sorting direction of the results: ascending or descending.  (default to 'asc')
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
@@ -1564,6 +1662,20 @@ module Algolia
         raise ArgumentError, "Parameter `index` is required when calling `get_top_searches`."
       end
 
+      if @api_client.config.client_side_validation && !limit.nil? && limit > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"limit\"\" when calling AnalyticsClient.get_top_searches, must be smaller than or equal to 1000."
+        )
+      end
+
+      if @api_client.config.client_side_validation && !offset.nil? && offset > 1000
+        raise(
+          ArgumentError,
+          "invalid value for \"\"offset\"\" when calling AnalyticsClient.get_top_searches, must be smaller than or equal to 1000."
+        )
+      end
+
       if @api_client.config.client_side_validation && !offset.nil? && offset < 0
         raise(
           ArgumentError,
@@ -1611,8 +1723,8 @@ module Algolia
     # @param end_date [String] End date of the period to analyze, in &#x60;YYYY-MM-DD&#x60; format.
     # @param order_by [OrderBy] Attribute by which to order the response items.  If the &#x60;clickAnalytics&#x60; parameter is false, only &#x60;searchCount&#x60; is available.  (default to 'searchCount')
     # @param direction [Direction] Sorting direction of the results: ascending or descending.  (default to 'asc')
-    # @param limit [Integer] Number of items to return. (default to 10)
-    # @param offset [Integer] Position of the first item to return. (default to 0)
+    # @param limit [Integer] Number of items to return.  Combined with the &#x60;offset&#x60; parameter, only the first 1000 items can be retrieved.  (default to 10)
+    # @param offset [Integer] Position of the first item to return.  Combined with the &#x60;limit&#x60; parameter, only the first 1000 items can be retrieved.  (default to 0)
     # @param tags [String] Tags by which to segment the analytics.  You can combine multiple tags with &#x60;OR&#x60; and &#x60;AND&#x60;. Tags must be URL-encoded. For more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments/).
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [GetTopSearchesResponse]

data/lib/algolia/api/search_client.rb

@@ -93,7 +93,7 @@ module Algolia
     #   - addObject
     # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param object_id [String] Unique record identifier. (required)
-    # @param body [Object] The record, a schemaless object with attributes that are useful in the context of search and discovery. (required)
+    # @param body [Object] The record. A schemaless object with attributes that are useful in the context of search and discovery. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def add_or_update_object_with_http_info(index_name, object_id, body, request_options = {})
@@ -138,7 +138,7 @@ module Algolia
     #   - addObject
     # @param index_name [String] Name of the index on which to perform the operation. (required)
     # @param object_id [String] Unique record identifier. (required)
-    # @param body [Object] The record, a schemaless object with attributes that are useful in the context of search and discovery. (required)
+    # @param body [Object] The record. A schemaless object with attributes that are useful in the context of search and discovery. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [UpdatedAtWithObjectIdResponse]
     def add_or_update_object(index_name, object_id, body, request_options = {})
@@ -422,7 +422,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || "Search::UpdatedAtResponse")
     end
 
-    # Retrieves records from an index, up to 1,000 per request.  While searching retrieves _hits_ (records augmented with attributes for highlighting and ranking details), browsing _just_ returns matching records. This can be useful if you want to export your indices.  - The Analytics API doesn't collect data when using `browse`. - Records are ranked by attributes and custom ranking. - There's no ranking for: typo-tolerance, number of matched words, proximity, geo distance.  Browse requests automatically apply these settings:  - `advancedSyntax`: `false` - `attributesToHighlight`: `[]` - `attributesToSnippet`: `[]` - `distinct`: `false` - `enablePersonalization`: `false` - `enableRules`: `false` - `facets`: `[]` - `getRankingInfo`: `false` - `ignorePlurals`: `false` - `optionalFilters`: `[]` - `typoTolerance`: `true` or `false` (`min` and `strict` is evaluated to `true`)  If you send these parameters with your browse requests, they'll be ignored.
+    # Retrieves records from an index, up to 1,000 per request.  While searching retrieves _hits_ (records augmented with attributes for highlighting and ranking details), browsing _just_ returns matching records. This can be useful if you want to export your indices.  - The Analytics API doesn't collect data when using `browse`. - Records are ranked by attributes and custom ranking. - There's no ranking for: typo-tolerance, number of matched words, proximity, geo distance.  Browse requests automatically apply these settings:  - `advancedSyntax`: `false` - `attributesToHighlight`: `[]` - `attributesToSnippet`: `[]` - `distinct`: `false` - `enablePersonalization`: `false` - `enableRules`: `false` - `facets`: `[]` - `getRankingInfo`: `false` - `ignorePlurals`: `false` - `optionalFilters`: `[]` - `typoTolerance`: `true` or `false` (`min` and `strict` evaluate to `true`)  If you send these parameters with your browse requests, they'll be ignored.
     #
     # Required API Key ACLs:
     #   - browse
@@ -455,7 +455,7 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # Retrieves records from an index, up to 1,000 per request.  While searching retrieves _hits_ (records augmented with attributes for highlighting and ranking details), browsing _just_ returns matching records. This can be useful if you want to export your indices.  - The Analytics API doesn't collect data when using `browse`. - Records are ranked by attributes and custom ranking. - There's no ranking for: typo-tolerance, number of matched words, proximity, geo distance.  Browse requests automatically apply these settings:  - `advancedSyntax`: `false` - `attributesToHighlight`: `[]` - `attributesToSnippet`: `[]` - `distinct`: `false` - `enablePersonalization`: `false` - `enableRules`: `false` - `facets`: `[]` - `getRankingInfo`: `false` - `ignorePlurals`: `false` - `optionalFilters`: `[]` - `typoTolerance`: `true` or `false` (`min` and `strict` is evaluated to `true`)  If you send these parameters with your browse requests, they'll be ignored.
+    # Retrieves records from an index, up to 1,000 per request.  While searching retrieves _hits_ (records augmented with attributes for highlighting and ranking details), browsing _just_ returns matching records. This can be useful if you want to export your indices.  - The Analytics API doesn't collect data when using `browse`. - Records are ranked by attributes and custom ranking. - There's no ranking for: typo-tolerance, number of matched words, proximity, geo distance.  Browse requests automatically apply these settings:  - `advancedSyntax`: `false` - `attributesToHighlight`: `[]` - `attributesToSnippet`: `[]` - `distinct`: `false` - `enablePersonalization`: `false` - `enableRules`: `false` - `facets`: `[]` - `getRankingInfo`: `false` - `ignorePlurals`: `false` - `optionalFilters`: `[]` - `typoTolerance`: `true` or `false` (`min` and `strict` evaluate to `true`)  If you send these parameters with your browse requests, they'll be ignored.
     #
     # Required API Key ACLs:
     #   - browse
@@ -1580,7 +1580,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || "Array<Search::Source>")
     end
 
-    # Retrieves a syonym by its ID. To find the object IDs for your synonyms, use the [&#x60;search&#x60; operation](#tag/Synonyms/operation/searchSynonyms).
+    # Retrieves a synonym by its ID. To find the object IDs for your synonyms, use the [&#x60;search&#x60; operation](#tag/Synonyms/operation/searchSynonyms).
     #
     # Required API Key ACLs:
     #   - settings
@@ -1619,7 +1619,7 @@ module Algolia
       @api_client.call_api(:GET, path, new_options)
     end
 
-    # Retrieves a syonym by its ID. To find the object IDs for your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
+    # Retrieves a synonym by its ID. To find the object IDs for your synonyms, use the [`search` operation](#tag/Synonyms/operation/searchSynonyms).
     #
     # Required API Key ACLs:
     #   - settings
@@ -2030,7 +2030,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || "Search::MultipleBatchResponse")
     end
 
-    # Copies or moves (renames) an index within the same Algolia application.  - Existing destination indices are overwritten, except for their analytics data. - If the destination index doesn&#39;t exist yet, it&#39;ll be created.  **Copy**  - Copying a source index that doesn&#39;t exist creates a new index with 0 records and default settings. - The API keys of the source index are merged with the existing keys in the destination index. - You can&#39;t copy the &#x60;enableReRanking&#x60;, &#x60;mode&#x60;, and &#x60;replicas&#x60; settings. - You can&#39;t copy to a destination index that already has replicas. - Be aware of the [size limits](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits). - Related guide: [Copy indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/copy-indices/)  **Move**  - Moving a source index that doesn&#39;t exist is ignored without returning an error. - When moving an index, the analytics data keep their original name and a new set of analytics data is started for the new name.   To access the original analytics in the dashboard, create an index with the original name. - If the destination index has replicas, moving will overwrite the existing index and copy the data to the replica indices. - Related guide: [Move indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/move-indices/).
+    # Copies or moves (renames) an index within the same Algolia application.  - Existing destination indices are overwritten, except for their analytics data. - If the destination index doesn&#39;t exist yet, it&#39;ll be created.  **Copy**  - Copying a source index that doesn&#39;t exist creates a new index with 0 records and default settings. - The API keys of the source index are merged with the existing keys in the destination index. - You can&#39;t copy the &#x60;enableReRanking&#x60;, &#x60;mode&#x60;, and &#x60;replicas&#x60; settings. - You can&#39;t copy to a destination index that already has replicas. - Be aware of the [size limits](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits). - Related guide: [Copy indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/copy-indices/)  **Move**  - Moving a source index that doesn&#39;t exist is ignored without returning an error. - When moving an index, the analytics data keeps its original name, and a new set of analytics data is started for the new name.   To access the original analytics in the dashboard, create an index with the original name. - If the destination index has replicas, moving will overwrite the existing index and copy the data to the replica indices. - Related guide: [Move indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/move-indices/).
     #
     # Required API Key ACLs:
     #   - addObject
@@ -2067,7 +2067,7 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # Copies or moves (renames) an index within the same Algolia application.  - Existing destination indices are overwritten, except for their analytics data. - If the destination index doesn't exist yet, it'll be created.  **Copy**  - Copying a source index that doesn't exist creates a new index with 0 records and default settings. - The API keys of the source index are merged with the existing keys in the destination index. - You can't copy the `enableReRanking`, `mode`, and `replicas` settings. - You can't copy to a destination index that already has replicas. - Be aware of the [size limits](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits). - Related guide: [Copy indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/copy-indices/)  **Move**  - Moving a source index that doesn't exist is ignored without returning an error. - When moving an index, the analytics data keep their original name and a new set of analytics data is started for the new name.   To access the original analytics in the dashboard, create an index with the original name. - If the destination index has replicas, moving will overwrite the existing index and copy the data to the replica indices. - Related guide: [Move indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/move-indices/).
+    # Copies or moves (renames) an index within the same Algolia application.  - Existing destination indices are overwritten, except for their analytics data. - If the destination index doesn't exist yet, it'll be created.  **Copy**  - Copying a source index that doesn't exist creates a new index with 0 records and default settings. - The API keys of the source index are merged with the existing keys in the destination index. - You can't copy the `enableReRanking`, `mode`, and `replicas` settings. - You can't copy to a destination index that already has replicas. - Be aware of the [size limits](https://www.algolia.com/doc/guides/scaling/algolia-service-limits/#application-record-and-index-limits). - Related guide: [Copy indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/copy-indices/)  **Move**  - Moving a source index that doesn't exist is ignored without returning an error. - When moving an index, the analytics data keeps its original name, and a new set of analytics data is started for the new name.   To access the original analytics in the dashboard, create an index with the original name. - If the destination index has replicas, moving will overwrite the existing index and copy the data to the replica indices. - Related guide: [Move indices](https://www.algolia.com/doc/guides/sending-and-managing-data/manage-indices-and-apps/manage-indices/how-to/move-indices/).
     #
     # Required API Key ACLs:
     #   - addObject
@@ -2080,7 +2080,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || "Search::UpdatedAtResponse")
     end
 
-    # Adds new attributes to a record, or update existing ones.  - If a record with the specified object ID doesn&#39;t exist,   a new record is added to the index **if** &#x60;createIfNotExists&#x60; is true. - If the index doesn&#39;t exist yet, this method creates a new index. - You can use any first-level attribute but not nested attributes.   If you specify a nested attribute, the engine treats it as a replacement for its first-level ancestor.  To update an attribute without pushing the entire record, you can use these built-in operations. These operations can be helpful if you don&#39;t have access to your initial data.  - Increment: increment a numeric attribute - Decrement: decrement a numeric attribute - Add: append a number or string element to an array attribute - Remove: remove all matching number or string elements from an array attribute made of numbers or strings - AddUnique: add a number or string element to an array attribute made of numbers or strings only if it&#39;s not already present - IncrementFrom: increment a numeric integer attribute only if the provided value matches the current value, and otherwise ignore the whole object update. For example, if you pass an IncrementFrom value of 2 for the version attribute, but the current value of the attribute is 1, the engine ignores the update. If the object doesn&#39;t exist, the engine only creates it if you pass an IncrementFrom value of 0. - IncrementSet: increment a numeric integer attribute only if the provided value is greater than the current value, and otherwise ignore the whole object update. For example, if you pass an IncrementSet value of 2 for the version attribute, and the current value of the attribute is 1, the engine updates the object. If the object doesn&#39;t exist yet, the engine only creates it if you pass an IncrementSet value that&#39;s greater than 0.  You can specify an operation by providing an object with the attribute to update as the key and its value being an object with the following properties:  - _operation: the operation to apply on the attribute - value: the right-hand side argument to the operation, for example, increment or decrement step, value to add or remove.
+    # Adds new attributes to a record, or updates existing ones.  - If a record with the specified object ID doesn&#39;t exist,   a new record is added to the index **if** &#x60;createIfNotExists&#x60; is true. - If the index doesn&#39;t exist yet, this method creates a new index. - You can use any first-level attribute but not nested attributes.   If you specify a nested attribute, the engine treats it as a replacement for its first-level ancestor.  To update an attribute without pushing the entire record, you can use these built-in operations. These operations can be helpful if you don&#39;t have access to your initial data.  - Increment: increment a numeric attribute - Decrement: decrement a numeric attribute - Add: append a number or string element to an array attribute - Remove: remove all matching number or string elements from an array attribute made of numbers or strings - AddUnique: add a number or string element to an array attribute made of numbers or strings only if it&#39;s not already present - IncrementFrom: increment a numeric integer attribute only if the provided value matches the current value, and otherwise ignore the whole object update. For example, if you pass an IncrementFrom value of 2 for the version attribute, but the current value of the attribute is 1, the engine ignores the update. If the object doesn&#39;t exist, the engine only creates it if you pass an IncrementFrom value of 0. - IncrementSet: increment a numeric integer attribute only if the provided value is greater than the current value, and otherwise ignore the whole object update. For example, if you pass an IncrementSet value of 2 for the version attribute, and the current value of the attribute is 1, the engine updates the object. If the object doesn&#39;t exist yet, the engine only creates it if you pass an IncrementSet value greater than 0.  You can specify an operation by providing an object with the attribute to update as the key and its value being an object with the following properties:  - _operation: the operation to apply on the attribute - value: the right-hand side argument to the operation, for example, increment or decrement step, value to add or remove.
     #
     # Required API Key ACLs:
     #   - addObject
@@ -2132,7 +2132,7 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # Adds new attributes to a record, or update existing ones.  - If a record with the specified object ID doesn't exist,   a new record is added to the index **if** `createIfNotExists` is true. - If the index doesn't exist yet, this method creates a new index. - You can use any first-level attribute but not nested attributes.   If you specify a nested attribute, the engine treats it as a replacement for its first-level ancestor.  To update an attribute without pushing the entire record, you can use these built-in operations. These operations can be helpful if you don't have access to your initial data.  - Increment: increment a numeric attribute - Decrement: decrement a numeric attribute - Add: append a number or string element to an array attribute - Remove: remove all matching number or string elements from an array attribute made of numbers or strings - AddUnique: add a number or string element to an array attribute made of numbers or strings only if it's not already present - IncrementFrom: increment a numeric integer attribute only if the provided value matches the current value, and otherwise ignore the whole object update. For example, if you pass an IncrementFrom value of 2 for the version attribute, but the current value of the attribute is 1, the engine ignores the update. If the object doesn't exist, the engine only creates it if you pass an IncrementFrom value of 0. - IncrementSet: increment a numeric integer attribute only if the provided value is greater than the current value, and otherwise ignore the whole object update. For example, if you pass an IncrementSet value of 2 for the version attribute, and the current value of the attribute is 1, the engine updates the object. If the object doesn't exist yet, the engine only creates it if you pass an IncrementSet value that's greater than 0.  You can specify an operation by providing an object with the attribute to update as the key and its value being an object with the following properties:  - _operation: the operation to apply on the attribute - value: the right-hand side argument to the operation, for example, increment or decrement step, value to add or remove.
+    # Adds new attributes to a record, or updates existing ones.  - If a record with the specified object ID doesn't exist,   a new record is added to the index **if** `createIfNotExists` is true. - If the index doesn't exist yet, this method creates a new index. - You can use any first-level attribute but not nested attributes.   If you specify a nested attribute, the engine treats it as a replacement for its first-level ancestor.  To update an attribute without pushing the entire record, you can use these built-in operations. These operations can be helpful if you don't have access to your initial data.  - Increment: increment a numeric attribute - Decrement: decrement a numeric attribute - Add: append a number or string element to an array attribute - Remove: remove all matching number or string elements from an array attribute made of numbers or strings - AddUnique: add a number or string element to an array attribute made of numbers or strings only if it's not already present - IncrementFrom: increment a numeric integer attribute only if the provided value matches the current value, and otherwise ignore the whole object update. For example, if you pass an IncrementFrom value of 2 for the version attribute, but the current value of the attribute is 1, the engine ignores the update. If the object doesn't exist, the engine only creates it if you pass an IncrementFrom value of 0. - IncrementSet: increment a numeric integer attribute only if the provided value is greater than the current value, and otherwise ignore the whole object update. For example, if you pass an IncrementSet value of 2 for the version attribute, and the current value of the attribute is 1, the engine updates the object. If the object doesn't exist yet, the engine only creates it if you pass an IncrementSet value greater than 0.  You can specify an operation by providing an object with the attribute to update as the key and its value being an object with the following properties:  - _operation: the operation to apply on the attribute - value: the right-hand side argument to the operation, for example, increment or decrement step, value to add or remove.
     #
     # Required API Key ACLs:
     #   - addObject
@@ -2307,7 +2307,7 @@ module Algolia
     # Required API Key ACLs:
     #   - addObject
     # @param index_name [String] Name of the index on which to perform the operation. (required)
-    # @param body [Object] The record, a schemaless object with attributes that are useful in the context of search and discovery. (required)
+    # @param body [Object] The record. A schemaless object with attributes that are useful in the context of search and discovery. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [Http::Response] the response
     def save_object_with_http_info(index_name, body, request_options = {})
@@ -2344,7 +2344,7 @@ module Algolia
     # Required API Key ACLs:
     #   - addObject
     # @param index_name [String] Name of the index on which to perform the operation. (required)
-    # @param body [Object] The record, a schemaless object with attributes that are useful in the context of search and discovery. (required)
+    # @param body [Object] The record. A schemaless object with attributes that are useful in the context of search and discovery. (required)
     # @param request_options: The request options to send along with the query, they will be merged with the transporter base parameters (headers, query params, timeouts, etc.). (optional)
     # @return [SaveObjectResponse]
     def save_object(index_name, body, request_options = {})
@@ -2616,7 +2616,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || "Search::UpdatedAtResponse")
     end
 
-    # Sends multiple search request to one or more indices.  This can be useful in these cases:  - Different indices for different purposes, such as, one index for products, another one for marketing content. - Multiple searches to the same index—for example, with different filters.
+    # Sends multiple search requests to one or more indices.  This can be useful in these cases:  - Different indices for different purposes, such as, one index for products, another one for marketing content. - Multiple searches to the same index—for example, with different filters.
     #
     # Required API Key ACLs:
     #   - search
@@ -2648,7 +2648,7 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # Sends multiple search request to one or more indices.  This can be useful in these cases:  - Different indices for different purposes, such as, one index for products, another one for marketing content. - Multiple searches to the same index—for example, with different filters.
+    # Sends multiple search requests to one or more indices.  This can be useful in these cases:  - Different indices for different purposes, such as, one index for products, another one for marketing content. - Multiple searches to the same index—for example, with different filters.
     #
     # Required API Key ACLs:
     #   - search
@@ -2840,7 +2840,7 @@ module Algolia
       @api_client.deserialize(response.body, request_options[:debug_return_type] || "Search::SearchRulesResponse")
     end
 
-    # Searches a single index and return matching search results (_hits_).  This method lets you retrieve up to 1,000 hits. If you need more, use the [&#x60;browse&#x60; operation](#tag/Search/operation/browse) or increase the &#x60;paginatedLimitedTo&#x60; index setting.
+    # Searches a single index and returns matching search results (_hits_).  This method lets you retrieve up to 1,000 hits. If you need more, use the [&#x60;browse&#x60; operation](#tag/Search/operation/browse) or increase the &#x60;paginatedLimitedTo&#x60; index setting.
     #
     # Required API Key ACLs:
     #   - search
@@ -2873,7 +2873,7 @@ module Algolia
       @api_client.call_api(:POST, path, new_options)
     end
 
-    # Searches a single index and return matching search results (_hits_).  This method lets you retrieve up to 1,000 hits. If you need more, use the [`browse` operation](#tag/Search/operation/browse) or increase the `paginatedLimitedTo` index setting.
+    # Searches a single index and returns matching search results (_hits_).  This method lets you retrieve up to 1,000 hits. If you need more, use the [`browse` operation](#tag/Search/operation/browse) or increase the `paginatedLimitedTo` index setting.
     #
     # Required API Key ACLs:
     #   - search