diff --git a/algoliasearch/src/main/java/com/algolia/model/recommend/SearchRecommendRulesParams.java b/algoliasearch/src/main/java/com/algolia/model/recommend/SearchRecommendRulesParams.java
index fb009c44..4b56af34 100644
--- a/algoliasearch/src/main/java/com/algolia/model/recommend/SearchRecommendRulesParams.java
+++ b/algoliasearch/src/main/java/com/algolia/model/recommend/SearchRecommendRulesParams.java
@@ -63,7 +63,16 @@ public SearchRecommendRulesParams setPage(Integer page) {
     return this;
   }
 
-  /** Requested page of the API response. minimum: 0 */
+  /**
+   * Requested page of the API response. Algolia uses `page` and `hitsPerPage` to control how search
+   * results are displayed
+   * ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).
+   * - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`:
+   * specifies the page number of the search results you want to retrieve. Page numbering starts at
+   * 0, so the first page is `page=0`, the second is `page=1`, and so on. For example, to display 10
+   * results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2.
+   * minimum: 0
+   */
   @javax.annotation.Nullable
   public Integer getPage() {
     return page;
@@ -74,7 +83,16 @@ public SearchRecommendRulesParams setHitsPerPage(Integer hitsPerPage) {
     return this;
   }
 
-  /** Maximum number of hits per page. minimum: 1 maximum: 1000 */
+  /**
+   * Maximum number of hits per page. Algolia uses `page` and `hitsPerPage` to control how search
+   * results are displayed
+   * ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).
+   * - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`:
+   * specifies the page number of the search results you want to retrieve. Page numbering starts at
+   * 0, so the first page is `page=0`, the second is `page=1`, and so on. For example, to display 10
+   * results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2.
+   * minimum: 1 maximum: 1000
+   */
   @javax.annotation.Nullable
   public Integer getHitsPerPage() {
     return hitsPerPage;
diff --git a/algoliasearch/src/main/java/com/algolia/model/search/SearchDictionaryEntriesResponse.java b/algoliasearch/src/main/java/com/algolia/model/search/SearchDictionaryEntriesResponse.java
index 85041bb3..23d5eafd 100644
--- a/algoliasearch/src/main/java/com/algolia/model/search/SearchDictionaryEntriesResponse.java
+++ b/algoliasearch/src/main/java/com/algolia/model/search/SearchDictionaryEntriesResponse.java
@@ -45,7 +45,16 @@ public SearchDictionaryEntriesResponse setPage(Integer page) {
     return this;
   }
 
-  /** Requested page of the API response. minimum: 0 */
+  /**
+   * Requested page of the API response. Algolia uses `page` and `hitsPerPage` to control how search
+   * results are displayed
+   * ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).
+   * - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`:
+   * specifies the page number of the search results you want to retrieve. Page numbering starts at
+   * 0, so the first page is `page=0`, the second is `page=1`, and so on. For example, to display 10
+   * results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2.
+   * minimum: 0
+   */
   @javax.annotation.Nonnull
   public Integer getPage() {
     return page;
diff --git a/algoliasearch/src/main/java/com/algolia/model/search/SearchRulesParams.java b/algoliasearch/src/main/java/com/algolia/model/search/SearchRulesParams.java
index 7cbc0b54..f2b87fd6 100644
--- a/algoliasearch/src/main/java/com/algolia/model/search/SearchRulesParams.java
+++ b/algoliasearch/src/main/java/com/algolia/model/search/SearchRulesParams.java
@@ -66,7 +66,16 @@ public SearchRulesParams setPage(Integer page) {
     return this;
   }
 
-  /** Requested page of the API response. minimum: 0 */
+  /**
+   * Requested page of the API response. Algolia uses `page` and `hitsPerPage` to control how search
+   * results are displayed
+   * ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).
+   * - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`:
+   * specifies the page number of the search results you want to retrieve. Page numbering starts at
+   * 0, so the first page is `page=0`, the second is `page=1`, and so on. For example, to display 10
+   * results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2.
+   * minimum: 0
+   */
   @javax.annotation.Nullable
   public Integer getPage() {
     return page;
@@ -77,7 +86,16 @@ public SearchRulesParams setHitsPerPage(Integer hitsPerPage) {
     return this;
   }
 
-  /** Maximum number of hits per page. minimum: 1 maximum: 1000 */
+  /**
+   * Maximum number of hits per page. Algolia uses `page` and `hitsPerPage` to control how search
+   * results are displayed
+   * ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).
+   * - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`:
+   * specifies the page number of the search results you want to retrieve. Page numbering starts at
+   * 0, so the first page is `page=0`, the second is `page=1`, and so on. For example, to display 10
+   * results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2.
+   * minimum: 1 maximum: 1000
+   */
   @javax.annotation.Nullable
   public Integer getHitsPerPage() {
     return hitsPerPage;
diff --git a/algoliasearch/src/main/java/com/algolia/model/search/SearchUserIdsResponse.java b/algoliasearch/src/main/java/com/algolia/model/search/SearchUserIdsResponse.java
index 19adf963..cc8f25cb 100644
--- a/algoliasearch/src/main/java/com/algolia/model/search/SearchUserIdsResponse.java
+++ b/algoliasearch/src/main/java/com/algolia/model/search/SearchUserIdsResponse.java
@@ -70,7 +70,16 @@ public SearchUserIdsResponse setHitsPerPage(Integer hitsPerPage) {
     return this;
   }
 
-  /** Maximum number of hits per page. minimum: 1 maximum: 1000 */
+  /**
+   * Maximum number of hits per page. Algolia uses `page` and `hitsPerPage` to control how search
+   * results are displayed
+   * ([paginated](https://www.algolia.com/doc/guides/building-search-ui/ui-and-ux-patterns/pagination/js/)).
+   * - `hitsPerPage`: sets the number of search results (_hits_) displayed per page. - `page`:
+   * specifies the page number of the search results you want to retrieve. Page numbering starts at
+   * 0, so the first page is `page=0`, the second is `page=1`, and so on. For example, to display 10
+   * results per page starting from the third page, set `hitsPerPage` to 10 and `page` to 2.
+   * minimum: 1 maximum: 1000
+   */
   @javax.annotation.Nonnull
   public Integer getHitsPerPage() {
     return hitsPerPage;