algoliasearch 5.0.0-alpha.107 → 5.0.0-alpha.109

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (178) hide show
  1. package/dist/algoliasearch/builds/browser.d.ts +1 -1
  2. package/dist/algoliasearch/builds/node.d.ts +1 -1
  3. package/dist/algoliasearch.cjs +196 -68
  4. package/dist/algoliasearch.esm.browser.js +197 -69
  5. package/dist/algoliasearch.esm.node.js +196 -68
  6. package/dist/algoliasearch.umd.js +2 -2
  7. package/dist/client-abtesting/model/{currenciesValue.d.ts → currency.d.ts} +2 -2
  8. package/dist/client-abtesting/model/currency.d.ts.map +1 -0
  9. package/dist/client-abtesting/model/index.d.ts +1 -1
  10. package/dist/client-abtesting/model/index.d.ts.map +1 -1
  11. package/dist/client-abtesting/model/variant.d.ts +4 -4
  12. package/dist/client-abtesting/model/variant.d.ts.map +1 -1
  13. package/dist/client-abtesting/src/abtestingClient.d.ts +1 -1
  14. package/dist/client-analytics/model/clickPositionsInner.d.ts +14 -0
  15. package/dist/client-analytics/model/clickPositionsInner.d.ts.map +1 -0
  16. package/dist/client-analytics/model/clientMethodProps.d.ts +96 -25
  17. package/dist/client-analytics/model/clientMethodProps.d.ts.map +1 -1
  18. package/dist/client-analytics/model/currenciesValue.d.ts +14 -0
  19. package/dist/client-analytics/model/currenciesValue.d.ts.map +1 -0
  20. package/dist/client-analytics/model/dailyAddToCartRates.d.ts +19 -0
  21. package/dist/client-analytics/model/dailyAddToCartRates.d.ts.map +1 -0
  22. package/dist/client-analytics/model/dailyAverageClicks.d.ts +15 -0
  23. package/dist/client-analytics/model/dailyAverageClicks.d.ts.map +1 -0
  24. package/dist/client-analytics/model/dailyClickThroughRates.d.ts +19 -0
  25. package/dist/client-analytics/model/dailyClickThroughRates.d.ts.map +1 -0
  26. package/dist/client-analytics/model/dailyConversionRates.d.ts +19 -0
  27. package/dist/client-analytics/model/dailyConversionRates.d.ts.map +1 -0
  28. package/dist/client-analytics/model/dailyNoClickRates.d.ts +19 -0
  29. package/dist/client-analytics/model/dailyNoClickRates.d.ts.map +1 -0
  30. package/dist/client-analytics/model/dailyNoResultsRates.d.ts +19 -0
  31. package/dist/client-analytics/model/dailyNoResultsRates.d.ts.map +1 -0
  32. package/dist/client-analytics/model/dailyPurchaseRates.d.ts +19 -0
  33. package/dist/client-analytics/model/dailyPurchaseRates.d.ts.map +1 -0
  34. package/dist/client-analytics/model/dailyRevenue.d.ts +12 -0
  35. package/dist/client-analytics/model/dailyRevenue.d.ts.map +1 -0
  36. package/dist/client-analytics/model/dailySearches.d.ts +11 -0
  37. package/dist/client-analytics/model/dailySearches.d.ts.map +1 -0
  38. package/dist/client-analytics/model/dailySearchesNoClicks.d.ts +15 -0
  39. package/dist/client-analytics/model/dailySearchesNoClicks.d.ts.map +1 -0
  40. package/dist/client-analytics/model/dailySearchesNoResults.d.ts +15 -0
  41. package/dist/client-analytics/model/dailySearchesNoResults.d.ts.map +1 -0
  42. package/dist/client-analytics/model/dailyUsers.d.ts +11 -0
  43. package/dist/client-analytics/model/dailyUsers.d.ts.map +1 -0
  44. package/dist/client-analytics/model/getAddToCartRateResponse.d.ts +20 -0
  45. package/dist/client-analytics/model/getAddToCartRateResponse.d.ts.map +1 -0
  46. package/dist/client-analytics/model/getAverageClickPositionResponse.d.ts +6 -6
  47. package/dist/client-analytics/model/getAverageClickPositionResponse.d.ts.map +1 -1
  48. package/dist/client-analytics/model/getClickPositionsResponse.d.ts +3 -3
  49. package/dist/client-analytics/model/getClickPositionsResponse.d.ts.map +1 -1
  50. package/dist/client-analytics/model/getClickThroughRateResponse.d.ts +8 -8
  51. package/dist/client-analytics/model/getClickThroughRateResponse.d.ts.map +1 -1
  52. package/dist/client-analytics/model/getConversionRateResponse.d.ts +20 -0
  53. package/dist/client-analytics/model/getConversionRateResponse.d.ts.map +1 -0
  54. package/dist/client-analytics/model/getNoClickRateResponse.d.ts +6 -6
  55. package/dist/client-analytics/model/getNoClickRateResponse.d.ts.map +1 -1
  56. package/dist/client-analytics/model/getNoResultsRateResponse.d.ts +6 -6
  57. package/dist/client-analytics/model/getNoResultsRateResponse.d.ts.map +1 -1
  58. package/dist/client-analytics/model/getPurchaseRateResponse.d.ts +20 -0
  59. package/dist/client-analytics/model/getPurchaseRateResponse.d.ts.map +1 -0
  60. package/dist/client-analytics/model/getRevenue.d.ts +13 -0
  61. package/dist/client-analytics/model/getRevenue.d.ts.map +1 -0
  62. package/dist/client-analytics/model/getSearchesCountResponse.d.ts +3 -3
  63. package/dist/client-analytics/model/getSearchesCountResponse.d.ts.map +1 -1
  64. package/dist/client-analytics/model/getSearchesNoClicksResponse.d.ts +3 -3
  65. package/dist/client-analytics/model/getSearchesNoClicksResponse.d.ts.map +1 -1
  66. package/dist/client-analytics/model/getSearchesNoResultsResponse.d.ts +3 -3
  67. package/dist/client-analytics/model/getSearchesNoResultsResponse.d.ts.map +1 -1
  68. package/dist/client-analytics/model/getStatusResponse.d.ts +2 -2
  69. package/dist/client-analytics/model/getStatusResponse.d.ts.map +1 -1
  70. package/dist/client-analytics/model/getTopCountriesResponse.d.ts +1 -1
  71. package/dist/client-analytics/model/getTopFilterAttributesResponse.d.ts +1 -1
  72. package/dist/client-analytics/model/getTopFilterForAttribute.d.ts +2 -4
  73. package/dist/client-analytics/model/getTopFilterForAttribute.d.ts.map +1 -1
  74. package/dist/client-analytics/model/getTopFiltersNoResultsResponse.d.ts +2 -2
  75. package/dist/client-analytics/model/getTopFiltersNoResultsResponse.d.ts.map +1 -1
  76. package/dist/client-analytics/model/getTopFiltersNoResultsValue.d.ts +2 -4
  77. package/dist/client-analytics/model/getTopFiltersNoResultsValue.d.ts.map +1 -1
  78. package/dist/client-analytics/model/getTopHitsResponse.d.ts +2 -1
  79. package/dist/client-analytics/model/getTopHitsResponse.d.ts.map +1 -1
  80. package/dist/client-analytics/model/getTopSearchesResponse.d.ts +2 -1
  81. package/dist/client-analytics/model/getTopSearchesResponse.d.ts.map +1 -1
  82. package/dist/client-analytics/model/getUsersCountResponse.d.ts +4 -4
  83. package/dist/client-analytics/model/getUsersCountResponse.d.ts.map +1 -1
  84. package/dist/client-analytics/model/index.d.ts +23 -11
  85. package/dist/client-analytics/model/index.d.ts.map +1 -1
  86. package/dist/client-analytics/model/operator.d.ts +5 -0
  87. package/dist/client-analytics/model/operator.d.ts.map +1 -0
  88. package/dist/client-analytics/model/orderBy.d.ts +1 -1
  89. package/dist/client-analytics/model/topCountry.d.ts +1 -1
  90. package/dist/client-analytics/model/topHit.d.ts +1 -1
  91. package/dist/client-analytics/model/topHitWithAnalytics.d.ts +9 -9
  92. package/dist/client-analytics/model/topHitWithAnalytics.d.ts.map +1 -1
  93. package/dist/client-analytics/model/topHitWithRevenueAnalytics.d.ts +52 -0
  94. package/dist/client-analytics/model/topHitWithRevenueAnalytics.d.ts.map +1 -0
  95. package/dist/client-analytics/model/topHitsResponse.d.ts +1 -1
  96. package/dist/client-analytics/model/topHitsResponseWithAnalytics.d.ts +1 -1
  97. package/dist/client-analytics/model/topHitsResponseWithRevenueAnalytics.d.ts +8 -0
  98. package/dist/client-analytics/model/topHitsResponseWithRevenueAnalytics.d.ts.map +1 -0
  99. package/dist/client-analytics/model/topSearch.d.ts +2 -2
  100. package/dist/client-analytics/model/topSearchWithAnalytics.d.ts +17 -12
  101. package/dist/client-analytics/model/topSearchWithAnalytics.d.ts.map +1 -1
  102. package/dist/client-analytics/model/topSearchWithRevenueAnalytics.d.ts +65 -0
  103. package/dist/client-analytics/model/topSearchWithRevenueAnalytics.d.ts.map +1 -0
  104. package/dist/client-analytics/model/topSearchesResponse.d.ts +1 -1
  105. package/dist/client-analytics/model/topSearchesResponseWithAnalytics.d.ts +1 -1
  106. package/dist/client-analytics/model/topSearchesResponseWithRevenueAnalytics.d.ts +8 -0
  107. package/dist/client-analytics/model/topSearchesResponseWithRevenueAnalytics.d.ts.map +1 -0
  108. package/dist/client-analytics/src/analyticsClient.d.ts +97 -50
  109. package/dist/client-analytics/src/analyticsClient.d.ts.map +1 -1
  110. package/dist/client-personalization/src/personalizationClient.d.ts +1 -1
  111. package/dist/client-search/model/baseIndexSettings.d.ts +3 -2
  112. package/dist/client-search/model/baseIndexSettings.d.ts.map +1 -1
  113. package/dist/client-search/model/dictionaryEntry.d.ts +2 -4
  114. package/dist/client-search/model/dictionaryEntry.d.ts.map +1 -1
  115. package/dist/client-search/model/ignorePlurals.d.ts +2 -1
  116. package/dist/client-search/model/ignorePlurals.d.ts.map +1 -1
  117. package/dist/client-search/model/index.d.ts +1 -0
  118. package/dist/client-search/model/index.d.ts.map +1 -1
  119. package/dist/client-search/model/indexSettingsAsSearchParams.d.ts +3 -2
  120. package/dist/client-search/model/indexSettingsAsSearchParams.d.ts.map +1 -1
  121. package/dist/client-search/model/removeStopWords.d.ts +2 -1
  122. package/dist/client-search/model/removeStopWords.d.ts.map +1 -1
  123. package/dist/client-search/model/searchDictionaryEntriesParams.d.ts +2 -4
  124. package/dist/client-search/model/searchDictionaryEntriesParams.d.ts.map +1 -1
  125. package/dist/client-search/model/supportedLanguage.d.ts +5 -0
  126. package/dist/client-search/model/supportedLanguage.d.ts.map +1 -0
  127. package/dist/client-search/src/searchClient.d.ts +1 -1
  128. package/dist/lite/lite.cjs +2 -2
  129. package/dist/lite/lite.esm.browser.js +3 -3
  130. package/dist/lite/lite.esm.node.js +2 -2
  131. package/dist/lite/lite.umd.js +2 -2
  132. package/dist/lite/model/baseIndexSettings.d.ts +3 -2
  133. package/dist/lite/model/baseIndexSettings.d.ts.map +1 -1
  134. package/dist/lite/model/dictionaryEntry.d.ts +2 -4
  135. package/dist/lite/model/dictionaryEntry.d.ts.map +1 -1
  136. package/dist/lite/model/ignorePlurals.d.ts +2 -1
  137. package/dist/lite/model/ignorePlurals.d.ts.map +1 -1
  138. package/dist/lite/model/index.d.ts +1 -0
  139. package/dist/lite/model/index.d.ts.map +1 -1
  140. package/dist/lite/model/indexSettingsAsSearchParams.d.ts +3 -2
  141. package/dist/lite/model/indexSettingsAsSearchParams.d.ts.map +1 -1
  142. package/dist/lite/model/removeStopWords.d.ts +2 -1
  143. package/dist/lite/model/removeStopWords.d.ts.map +1 -1
  144. package/dist/lite/model/supportedLanguage.d.ts +5 -0
  145. package/dist/lite/model/supportedLanguage.d.ts.map +1 -0
  146. package/dist/lite/src/liteClient.d.ts +1 -1
  147. package/lite/model/baseIndexSettings.ts +4 -2
  148. package/lite/model/dictionaryEntry.ts +2 -4
  149. package/lite/model/ignorePlurals.ts +3 -1
  150. package/lite/model/index.ts +1 -0
  151. package/lite/model/indexSettingsAsSearchParams.ts +3 -2
  152. package/lite/model/removeStopWords.ts +3 -1
  153. package/lite/model/supportedLanguage.ts +74 -0
  154. package/lite/src/liteClient.ts +2 -2
  155. package/package.json +13 -13
  156. package/dist/client-abtesting/model/currenciesValue.d.ts.map +0 -1
  157. package/dist/client-analytics/model/averageClickEvent.d.ts +0 -15
  158. package/dist/client-analytics/model/averageClickEvent.d.ts.map +0 -1
  159. package/dist/client-analytics/model/clickPosition.d.ts +0 -11
  160. package/dist/client-analytics/model/clickPosition.d.ts.map +0 -1
  161. package/dist/client-analytics/model/clickThroughRateEvent.d.ts +0 -19
  162. package/dist/client-analytics/model/clickThroughRateEvent.d.ts.map +0 -1
  163. package/dist/client-analytics/model/conversionRateEvent.d.ts +0 -19
  164. package/dist/client-analytics/model/conversionRateEvent.d.ts.map +0 -1
  165. package/dist/client-analytics/model/getConversationRateResponse.d.ts +0 -20
  166. package/dist/client-analytics/model/getConversationRateResponse.d.ts.map +0 -1
  167. package/dist/client-analytics/model/noClickRateEvent.d.ts +0 -19
  168. package/dist/client-analytics/model/noClickRateEvent.d.ts.map +0 -1
  169. package/dist/client-analytics/model/noResultsRateEvent.d.ts +0 -19
  170. package/dist/client-analytics/model/noResultsRateEvent.d.ts.map +0 -1
  171. package/dist/client-analytics/model/searchEvent.d.ts +0 -11
  172. package/dist/client-analytics/model/searchEvent.d.ts.map +0 -1
  173. package/dist/client-analytics/model/searchNoClickEvent.d.ts +0 -15
  174. package/dist/client-analytics/model/searchNoClickEvent.d.ts.map +0 -1
  175. package/dist/client-analytics/model/searchNoResultEvent.d.ts +0 -15
  176. package/dist/client-analytics/model/searchNoResultEvent.d.ts.map +0 -1
  177. package/dist/client-analytics/model/userWithDate.d.ts +0 -11
  178. package/dist/client-analytics/model/userWithDate.d.ts.map +0 -1
@@ -5,7 +5,7 @@ var clientCommon = require('@algolia/client-common');
5
5
  var requesterNodeHttp = require('@algolia/requester-node-http');
6
6
 
7
7
  // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
8
- const apiClientVersion$4 = '5.0.0-alpha.107';
8
+ const apiClientVersion$4 = '5.0.0-alpha.109';
9
9
  const REGIONS$2 = ['de', 'us'];
10
10
  function getDefaultHosts$3(region) {
11
11
  const url = !region
@@ -110,7 +110,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
110
110
  if (!path) {
111
111
  throw new Error('Parameter `path` is required when calling `customDelete`.');
112
112
  }
113
- const requestPath = '/1{path}'.replace('{path}', path);
113
+ const requestPath = '/{path}'.replace('{path}', path);
114
114
  const headers = {};
115
115
  const queryParameters = parameters ? parameters : {};
116
116
  const request = {
@@ -133,7 +133,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
133
133
  if (!path) {
134
134
  throw new Error('Parameter `path` is required when calling `customGet`.');
135
135
  }
136
- const requestPath = '/1{path}'.replace('{path}', path);
136
+ const requestPath = '/{path}'.replace('{path}', path);
137
137
  const headers = {};
138
138
  const queryParameters = parameters ? parameters : {};
139
139
  const request = {
@@ -157,7 +157,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
157
157
  if (!path) {
158
158
  throw new Error('Parameter `path` is required when calling `customPost`.');
159
159
  }
160
- const requestPath = '/1{path}'.replace('{path}', path);
160
+ const requestPath = '/{path}'.replace('{path}', path);
161
161
  const headers = {};
162
162
  const queryParameters = parameters ? parameters : {};
163
163
  const request = {
@@ -182,7 +182,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
182
182
  if (!path) {
183
183
  throw new Error('Parameter `path` is required when calling `customPut`.');
184
184
  }
185
- const requestPath = '/1{path}'.replace('{path}', path);
185
+ const requestPath = '/{path}'.replace('{path}', path);
186
186
  const headers = {};
187
187
  const queryParameters = parameters ? parameters : {};
188
188
  const request = {
@@ -310,7 +310,7 @@ function createAbtestingClient({ appId: appIdOption, apiKey: apiKeyOption, authM
310
310
  }
311
311
 
312
312
  // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
313
- const apiClientVersion$3 = '5.0.0-alpha.107';
313
+ const apiClientVersion$3 = '5.0.0-alpha.109';
314
314
  const REGIONS$1 = ['de', 'us'];
315
315
  function getDefaultHosts$2(region) {
316
316
  const url = !region
@@ -381,7 +381,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
381
381
  if (!path) {
382
382
  throw new Error('Parameter `path` is required when calling `customDelete`.');
383
383
  }
384
- const requestPath = '/1{path}'.replace('{path}', path);
384
+ const requestPath = '/{path}'.replace('{path}', path);
385
385
  const headers = {};
386
386
  const queryParameters = parameters ? parameters : {};
387
387
  const request = {
@@ -404,7 +404,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
404
404
  if (!path) {
405
405
  throw new Error('Parameter `path` is required when calling `customGet`.');
406
406
  }
407
- const requestPath = '/1{path}'.replace('{path}', path);
407
+ const requestPath = '/{path}'.replace('{path}', path);
408
408
  const headers = {};
409
409
  const queryParameters = parameters ? parameters : {};
410
410
  const request = {
@@ -428,7 +428,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
428
428
  if (!path) {
429
429
  throw new Error('Parameter `path` is required when calling `customPost`.');
430
430
  }
431
- const requestPath = '/1{path}'.replace('{path}', path);
431
+ const requestPath = '/{path}'.replace('{path}', path);
432
432
  const headers = {};
433
433
  const queryParameters = parameters ? parameters : {};
434
434
  const request = {
@@ -453,7 +453,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
453
453
  if (!path) {
454
454
  throw new Error('Parameter `path` is required when calling `customPut`.');
455
455
  }
456
- const requestPath = '/1{path}'.replace('{path}', path);
456
+ const requestPath = '/{path}'.replace('{path}', path);
457
457
  const headers = {};
458
458
  const queryParameters = parameters ? parameters : {};
459
459
  const request = {
@@ -466,7 +466,47 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
466
466
  return transporter.request(request, requestOptions);
467
467
  },
468
468
  /**
469
- * Return the average click position for the complete time range and for individual days. > **Note**: If all `positions` have a `clickCount` of `0` or `null`, it means Algolia didn\'t receive any click events for tracked searches. A _tracked_ search is a search request where the `clickAnalytics` parameter is `true`.
469
+ * Retrieves the add-to-cart rate for all of your searches with at least one add-to-cart event, including a daily breakdown. By default, the analyzed period includes the last eight days including the current day.
470
+ *
471
+ * Required API Key ACLs:
472
+ * - analytics.
473
+ *
474
+ * @param getAddToCartRate - The getAddToCartRate object.
475
+ * @param getAddToCartRate.index - Index name.
476
+ * @param getAddToCartRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
477
+ * @param getAddToCartRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
478
+ * @param getAddToCartRate.tags - 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/).
479
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
480
+ */
481
+ getAddToCartRate({ index, startDate, endDate, tags }, requestOptions) {
482
+ if (!index) {
483
+ throw new Error('Parameter `index` is required when calling `getAddToCartRate`.');
484
+ }
485
+ const requestPath = '/2/conversions/addToCartRate';
486
+ const headers = {};
487
+ const queryParameters = {};
488
+ if (index !== undefined) {
489
+ queryParameters.index = index.toString();
490
+ }
491
+ if (startDate !== undefined) {
492
+ queryParameters.startDate = startDate.toString();
493
+ }
494
+ if (endDate !== undefined) {
495
+ queryParameters.endDate = endDate.toString();
496
+ }
497
+ if (tags !== undefined) {
498
+ queryParameters.tags = tags.toString();
499
+ }
500
+ const request = {
501
+ method: 'GET',
502
+ path: requestPath,
503
+ queryParameters,
504
+ headers,
505
+ };
506
+ return transporter.request(request, requestOptions);
507
+ },
508
+ /**
509
+ * Retrieves the average click position of your search results, including a daily breakdown. The average click position is the average of all clicked search results\' positions. For example, if users only ever click on the first result for any search, the average click position is 1. By default, the analyzed period includes the last eight days including the current day.
470
510
  *
471
511
  * Required API Key ACLs:
472
512
  * - analytics.
@@ -475,7 +515,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
475
515
  * @param getAverageClickPosition.index - Index name.
476
516
  * @param getAverageClickPosition.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
477
517
  * @param getAverageClickPosition.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
478
- * @param getAverageClickPosition.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
518
+ * @param getAverageClickPosition.tags - 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/).
479
519
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
480
520
  */
481
521
  getAverageClickPosition({ index, startDate, endDate, tags }, requestOptions) {
@@ -506,7 +546,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
506
546
  return transporter.request(request, requestOptions);
507
547
  },
508
548
  /**
509
- * Show the number of clicks events and their associated position in the search results. > **Note**: If all `positions` have a `clickCount` of `0` or `null`, it means Algolia didn\'t receive any click events for tracked searches. A _tracked_ search is a search request where the `clickAnalytics` parameter is `true`.
549
+ * Retrieves the positions in the search results and their associated number of clicks. This lets you check how many clicks the first, second, or tenth search results receive.
510
550
  *
511
551
  * Required API Key ACLs:
512
552
  * - analytics.
@@ -515,7 +555,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
515
555
  * @param getClickPositions.index - Index name.
516
556
  * @param getClickPositions.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
517
557
  * @param getClickPositions.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
518
- * @param getClickPositions.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
558
+ * @param getClickPositions.tags - 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/).
519
559
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
520
560
  */
521
561
  getClickPositions({ index, startDate, endDate, tags }, requestOptions) {
@@ -546,7 +586,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
546
586
  return transporter.request(request, requestOptions);
547
587
  },
548
588
  /**
549
- * Returns a [click-through rate (CTR)](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#click-through-rate).
589
+ * Retrieves the click-through rate for all of your searches with at least one click event, including a daily breakdown By default, the analyzed period includes the last eight days including the current day.
550
590
  *
551
591
  * Required API Key ACLs:
552
592
  * - analytics.
@@ -555,7 +595,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
555
595
  * @param getClickThroughRate.index - Index name.
556
596
  * @param getClickThroughRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
557
597
  * @param getClickThroughRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
558
- * @param getClickThroughRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
598
+ * @param getClickThroughRate.tags - 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/).
559
599
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
560
600
  */
561
601
  getClickThroughRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -586,21 +626,21 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
586
626
  return transporter.request(request, requestOptions);
587
627
  },
588
628
  /**
589
- * Return a [conversion rate](https://www.algolia.com/doc/guides/search-analytics/concepts/metrics/#conversion-rate).
629
+ * Retrieves the conversion rate for all of your searches with at least one conversion event, including a daily breakdown. By default, the analyzed period includes the last eight days including the current day.
590
630
  *
591
631
  * Required API Key ACLs:
592
632
  * - analytics.
593
633
  *
594
- * @param getConversationRate - The getConversationRate object.
595
- * @param getConversationRate.index - Index name.
596
- * @param getConversationRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
597
- * @param getConversationRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
598
- * @param getConversationRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
634
+ * @param getConversionRate - The getConversionRate object.
635
+ * @param getConversionRate.index - Index name.
636
+ * @param getConversionRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
637
+ * @param getConversionRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
638
+ * @param getConversionRate.tags - 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/).
599
639
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
600
640
  */
601
- getConversationRate({ index, startDate, endDate, tags }, requestOptions) {
641
+ getConversionRate({ index, startDate, endDate, tags }, requestOptions) {
602
642
  if (!index) {
603
- throw new Error('Parameter `index` is required when calling `getConversationRate`.');
643
+ throw new Error('Parameter `index` is required when calling `getConversionRate`.');
604
644
  }
605
645
  const requestPath = '/2/conversions/conversionRate';
606
646
  const headers = {};
@@ -626,7 +666,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
626
666
  return transporter.request(request, requestOptions);
627
667
  },
628
668
  /**
629
- * Returns the rate at which searches don\'t lead to any clicks. The endpoint returns a value for the complete given time range, as well as a value per day. It also returns the count of searches and searches without clicks.
669
+ * Retrieves the fraction of searches that didn\'t lead to any click within a time range, including a daily breakdown. By default, the analyzed period includes the last eight days including the current day.
630
670
  *
631
671
  * Required API Key ACLs:
632
672
  * - analytics.
@@ -635,7 +675,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
635
675
  * @param getNoClickRate.index - Index name.
636
676
  * @param getNoClickRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
637
677
  * @param getNoClickRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
638
- * @param getNoClickRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
678
+ * @param getNoClickRate.tags - 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/).
639
679
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
640
680
  */
641
681
  getNoClickRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -666,7 +706,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
666
706
  return transporter.request(request, requestOptions);
667
707
  },
668
708
  /**
669
- * Returns the rate at which searches didn\'t return any results.
709
+ * Retrieves the fraction of searches that didn\'t return any results within a time range, including a daily breakdown. By default, the analyzed period includes the last eight days including the current day.
670
710
  *
671
711
  * Required API Key ACLs:
672
712
  * - analytics.
@@ -675,7 +715,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
675
715
  * @param getNoResultsRate.index - Index name.
676
716
  * @param getNoResultsRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
677
717
  * @param getNoResultsRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
678
- * @param getNoResultsRate.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
718
+ * @param getNoResultsRate.tags - 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/).
679
719
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
680
720
  */
681
721
  getNoResultsRate({ index, startDate, endDate, tags }, requestOptions) {
@@ -706,7 +746,87 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
706
746
  return transporter.request(request, requestOptions);
707
747
  },
708
748
  /**
709
- * Returns the number of searches within a time range.
749
+ * Retrieves the purchase rate for all of your searches with at least one purchase event, including a daily breakdown. By default, the analyzed period includes the last eight days including the current day.
750
+ *
751
+ * Required API Key ACLs:
752
+ * - analytics.
753
+ *
754
+ * @param getPurchaseRate - The getPurchaseRate object.
755
+ * @param getPurchaseRate.index - Index name.
756
+ * @param getPurchaseRate.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
757
+ * @param getPurchaseRate.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
758
+ * @param getPurchaseRate.tags - 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/).
759
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
760
+ */
761
+ getPurchaseRate({ index, startDate, endDate, tags }, requestOptions) {
762
+ if (!index) {
763
+ throw new Error('Parameter `index` is required when calling `getPurchaseRate`.');
764
+ }
765
+ const requestPath = '/2/conversions/purchaseRate';
766
+ const headers = {};
767
+ const queryParameters = {};
768
+ if (index !== undefined) {
769
+ queryParameters.index = index.toString();
770
+ }
771
+ if (startDate !== undefined) {
772
+ queryParameters.startDate = startDate.toString();
773
+ }
774
+ if (endDate !== undefined) {
775
+ queryParameters.endDate = endDate.toString();
776
+ }
777
+ if (tags !== undefined) {
778
+ queryParameters.tags = tags.toString();
779
+ }
780
+ const request = {
781
+ method: 'GET',
782
+ path: requestPath,
783
+ queryParameters,
784
+ headers,
785
+ };
786
+ return transporter.request(request, requestOptions);
787
+ },
788
+ /**
789
+ * Retrieves revenue-related metrics, such as the total revenue or the average order value. To retrieve revenue-related metrics, sent purchase events. By default, the analyzed period includes the last eight days including the current day.
790
+ *
791
+ * Required API Key ACLs:
792
+ * - analytics.
793
+ *
794
+ * @param getRevenue - The getRevenue object.
795
+ * @param getRevenue.index - Index name.
796
+ * @param getRevenue.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
797
+ * @param getRevenue.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
798
+ * @param getRevenue.tags - 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/).
799
+ * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
800
+ */
801
+ getRevenue({ index, startDate, endDate, tags }, requestOptions) {
802
+ if (!index) {
803
+ throw new Error('Parameter `index` is required when calling `getRevenue`.');
804
+ }
805
+ const requestPath = '/2/conversions/revenue';
806
+ const headers = {};
807
+ const queryParameters = {};
808
+ if (index !== undefined) {
809
+ queryParameters.index = index.toString();
810
+ }
811
+ if (startDate !== undefined) {
812
+ queryParameters.startDate = startDate.toString();
813
+ }
814
+ if (endDate !== undefined) {
815
+ queryParameters.endDate = endDate.toString();
816
+ }
817
+ if (tags !== undefined) {
818
+ queryParameters.tags = tags.toString();
819
+ }
820
+ const request = {
821
+ method: 'GET',
822
+ path: requestPath,
823
+ queryParameters,
824
+ headers,
825
+ };
826
+ return transporter.request(request, requestOptions);
827
+ },
828
+ /**
829
+ * Retrieves the number of searches within a time range, including a daily breakdown. By default, the analyzed period includes the last eight days including the current day.
710
830
  *
711
831
  * Required API Key ACLs:
712
832
  * - analytics.
@@ -715,7 +835,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
715
835
  * @param getSearchesCount.index - Index name.
716
836
  * @param getSearchesCount.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
717
837
  * @param getSearchesCount.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
718
- * @param getSearchesCount.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
838
+ * @param getSearchesCount.tags - 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/).
719
839
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
720
840
  */
721
841
  getSearchesCount({ index, startDate, endDate, tags }, requestOptions) {
@@ -746,7 +866,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
746
866
  return transporter.request(request, requestOptions);
747
867
  },
748
868
  /**
749
- * Return the most popular of the last 1,000 searches that didn\'t lead to any clicks.
869
+ * Retrieves the most popular searches that didn\'t lead to any clicks, from the 1,000 most frequent searches.
750
870
  *
751
871
  * Required API Key ACLs:
752
872
  * - analytics.
@@ -757,7 +877,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
757
877
  * @param getSearchesNoClicks.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
758
878
  * @param getSearchesNoClicks.limit - Number of items to return.
759
879
  * @param getSearchesNoClicks.offset - Position of the first item to return.
760
- * @param getSearchesNoClicks.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
880
+ * @param getSearchesNoClicks.tags - 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/).
761
881
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
762
882
  */
763
883
  getSearchesNoClicks({ index, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -794,7 +914,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
794
914
  return transporter.request(request, requestOptions);
795
915
  },
796
916
  /**
797
- * Returns the most popular of the latest 1,000 searches that didn\'t return any results.
917
+ * Retrieves the most popular searches that didn\'t return any results.
798
918
  *
799
919
  * Required API Key ACLs:
800
920
  * - analytics.
@@ -805,7 +925,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
805
925
  * @param getSearchesNoResults.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
806
926
  * @param getSearchesNoResults.limit - Number of items to return.
807
927
  * @param getSearchesNoResults.offset - Position of the first item to return.
808
- * @param getSearchesNoResults.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
928
+ * @param getSearchesNoResults.tags - 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/).
809
929
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
810
930
  */
811
931
  getSearchesNoResults({ index, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -842,7 +962,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
842
962
  return transporter.request(request, requestOptions);
843
963
  },
844
964
  /**
845
- * Return the latest update time of the Analytics API for an index. If the index has been recently created or no search has been performed yet, `updatedAt` will be `null`. > **Note**: The Analytics API is updated every 5 minutes.
965
+ * Retrieves the time when the Analytics data for the specified index was last updated. The Analytics data is updated every 5 minutes.
846
966
  *
847
967
  * Required API Key ACLs:
848
968
  * - analytics.
@@ -870,7 +990,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
870
990
  return transporter.request(request, requestOptions);
871
991
  },
872
992
  /**
873
- * Returns top countries. Limited to the 1,000 most frequent ones.
993
+ * Retrieves the countries with the most searches to your index.
874
994
  *
875
995
  * Required API Key ACLs:
876
996
  * - analytics.
@@ -881,7 +1001,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
881
1001
  * @param getTopCountries.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
882
1002
  * @param getTopCountries.limit - Number of items to return.
883
1003
  * @param getTopCountries.offset - Position of the first item to return.
884
- * @param getTopCountries.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1004
+ * @param getTopCountries.tags - 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/).
885
1005
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
886
1006
  */
887
1007
  getTopCountries({ index, startDate, endDate, limit, offset, tags }, requestOptions) {
@@ -918,19 +1038,19 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
918
1038
  return transporter.request(request, requestOptions);
919
1039
  },
920
1040
  /**
921
- * Return the most popular [filterable attributes](https://www.algolia.com/doc/guides/managing-results/refine-results/filtering/) in the 1,000 most recently used filters.
1041
+ * Retrieves the most frequently used filter attributes. These are attributes of your records that you included in the `attributesForFaceting` setting.
922
1042
  *
923
1043
  * Required API Key ACLs:
924
1044
  * - analytics.
925
1045
  *
926
1046
  * @param getTopFilterAttributes - The getTopFilterAttributes object.
927
1047
  * @param getTopFilterAttributes.index - Index name.
928
- * @param getTopFilterAttributes.search - User query.
1048
+ * @param getTopFilterAttributes.search - Search query.
929
1049
  * @param getTopFilterAttributes.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
930
1050
  * @param getTopFilterAttributes.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
931
1051
  * @param getTopFilterAttributes.limit - Number of items to return.
932
1052
  * @param getTopFilterAttributes.offset - Position of the first item to return.
933
- * @param getTopFilterAttributes.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1053
+ * @param getTopFilterAttributes.tags - 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/).
934
1054
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
935
1055
  */
936
1056
  getTopFilterAttributes({ index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -970,7 +1090,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
970
1090
  return transporter.request(request, requestOptions);
971
1091
  },
972
1092
  /**
973
- * Returns the most popular filter values for an attribute in the 1,000 most recently used filters.
1093
+ * Retrieves the most frequent filter (facet) values for a filter attribute. These are attributes of your records that you included in the `attributesForFaceting` setting.
974
1094
  *
975
1095
  * Required API Key ACLs:
976
1096
  * - analytics.
@@ -978,12 +1098,12 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
978
1098
  * @param getTopFilterForAttribute - The getTopFilterForAttribute object.
979
1099
  * @param getTopFilterForAttribute.attribute - Attribute name.
980
1100
  * @param getTopFilterForAttribute.index - Index name.
981
- * @param getTopFilterForAttribute.search - User query.
1101
+ * @param getTopFilterForAttribute.search - Search query.
982
1102
  * @param getTopFilterForAttribute.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
983
1103
  * @param getTopFilterForAttribute.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
984
1104
  * @param getTopFilterForAttribute.limit - Number of items to return.
985
1105
  * @param getTopFilterForAttribute.offset - Position of the first item to return.
986
- * @param getTopFilterForAttribute.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1106
+ * @param getTopFilterForAttribute.tags - 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/).
987
1107
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
988
1108
  */
989
1109
  getTopFilterForAttribute({ attribute, index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1026,19 +1146,19 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1026
1146
  return transporter.request(request, requestOptions);
1027
1147
  },
1028
1148
  /**
1029
- * Returns top filters for filter-enabled searches that don\'t return results. Limited to the 1,000 most recently used filters.
1149
+ * Retrieves the most frequently used filters for a search that didn\'t return any results. To get the most frequent searches without results, use the [Retrieve searches without results](#tag/search/operation/getSearchesNoResults) operation.
1030
1150
  *
1031
1151
  * Required API Key ACLs:
1032
1152
  * - analytics.
1033
1153
  *
1034
1154
  * @param getTopFiltersNoResults - The getTopFiltersNoResults object.
1035
1155
  * @param getTopFiltersNoResults.index - Index name.
1036
- * @param getTopFiltersNoResults.search - User query.
1156
+ * @param getTopFiltersNoResults.search - Search query.
1037
1157
  * @param getTopFiltersNoResults.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1038
1158
  * @param getTopFiltersNoResults.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1039
1159
  * @param getTopFiltersNoResults.limit - Number of items to return.
1040
1160
  * @param getTopFiltersNoResults.offset - Position of the first item to return.
1041
- * @param getTopFiltersNoResults.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1161
+ * @param getTopFiltersNoResults.tags - 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/).
1042
1162
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1043
1163
  */
1044
1164
  getTopFiltersNoResults({ index, search, startDate, endDate, limit, offset, tags, }, requestOptions) {
@@ -1078,23 +1198,24 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1078
1198
  return transporter.request(request, requestOptions);
1079
1199
  },
1080
1200
  /**
1081
- * Return the most popular clicked results in the last 1,000 searches.
1201
+ * Retrieves the object IDs of the most frequent search results.
1082
1202
  *
1083
1203
  * Required API Key ACLs:
1084
1204
  * - analytics.
1085
1205
  *
1086
1206
  * @param getTopHits - The getTopHits object.
1087
1207
  * @param getTopHits.index - Index name.
1088
- * @param getTopHits.search - User query.
1089
- * @param getTopHits.clickAnalytics - Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
1208
+ * @param getTopHits.search - Search query.
1209
+ * @param getTopHits.clickAnalytics - Whether to include metrics related to click and conversion events in the response.
1210
+ * @param getTopHits.revenueAnalytics - Whether to include revenue-related metrics in the response. If true, metrics related to click and conversion events are also included in the response.
1090
1211
  * @param getTopHits.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1091
1212
  * @param getTopHits.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1092
1213
  * @param getTopHits.limit - Number of items to return.
1093
1214
  * @param getTopHits.offset - Position of the first item to return.
1094
- * @param getTopHits.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1215
+ * @param getTopHits.tags - 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/).
1095
1216
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1096
1217
  */
1097
- getTopHits({ index, search, clickAnalytics, startDate, endDate, limit, offset, tags, }, requestOptions) {
1218
+ getTopHits({ index, search, clickAnalytics, revenueAnalytics, startDate, endDate, limit, offset, tags, }, requestOptions) {
1098
1219
  if (!index) {
1099
1220
  throw new Error('Parameter `index` is required when calling `getTopHits`.');
1100
1221
  }
@@ -1110,6 +1231,9 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1110
1231
  if (clickAnalytics !== undefined) {
1111
1232
  queryParameters.clickAnalytics = clickAnalytics.toString();
1112
1233
  }
1234
+ if (revenueAnalytics !== undefined) {
1235
+ queryParameters.revenueAnalytics = revenueAnalytics.toString();
1236
+ }
1113
1237
  if (startDate !== undefined) {
1114
1238
  queryParameters.startDate = startDate.toString();
1115
1239
  }
@@ -1134,24 +1258,25 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1134
1258
  return transporter.request(request, requestOptions);
1135
1259
  },
1136
1260
  /**
1137
- * Returns the most popular of the latest 1,000 searches. For each search, also returns the number of hits.
1261
+ * Returns the most popular search terms.
1138
1262
  *
1139
1263
  * Required API Key ACLs:
1140
1264
  * - analytics.
1141
1265
  *
1142
1266
  * @param getTopSearches - The getTopSearches object.
1143
1267
  * @param getTopSearches.index - Index name.
1144
- * @param getTopSearches.clickAnalytics - Whether to include [click and conversion](https://www.algolia.com/doc/guides/sending-events/getting-started/) rates for a search.
1268
+ * @param getTopSearches.clickAnalytics - Whether to include metrics related to click and conversion events in the response.
1269
+ * @param getTopSearches.revenueAnalytics - Whether to include revenue-related metrics in the response. If true, metrics related to click and conversion events are also included in the response.
1145
1270
  * @param getTopSearches.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1146
1271
  * @param getTopSearches.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1147
- * @param getTopSearches.orderBy - Reorder the results.
1272
+ * @param getTopSearches.orderBy - Attribute by which to order the response items. If the `clickAnalytics` parameter is false, only `searchCount` is available.
1148
1273
  * @param getTopSearches.direction - Sorting direction of the results: ascending or descending.
1149
1274
  * @param getTopSearches.limit - Number of items to return.
1150
1275
  * @param getTopSearches.offset - Position of the first item to return.
1151
- * @param getTopSearches.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1276
+ * @param getTopSearches.tags - 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/).
1152
1277
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1153
1278
  */
1154
- getTopSearches({ index, clickAnalytics, startDate, endDate, orderBy, direction, limit, offset, tags, }, requestOptions) {
1279
+ getTopSearches({ index, clickAnalytics, revenueAnalytics, startDate, endDate, orderBy, direction, limit, offset, tags, }, requestOptions) {
1155
1280
  if (!index) {
1156
1281
  throw new Error('Parameter `index` is required when calling `getTopSearches`.');
1157
1282
  }
@@ -1164,6 +1289,9 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1164
1289
  if (clickAnalytics !== undefined) {
1165
1290
  queryParameters.clickAnalytics = clickAnalytics.toString();
1166
1291
  }
1292
+ if (revenueAnalytics !== undefined) {
1293
+ queryParameters.revenueAnalytics = revenueAnalytics.toString();
1294
+ }
1167
1295
  if (startDate !== undefined) {
1168
1296
  queryParameters.startDate = startDate.toString();
1169
1297
  }
@@ -1194,7 +1322,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1194
1322
  return transporter.request(request, requestOptions);
1195
1323
  },
1196
1324
  /**
1197
- * Return the count of unique users.
1325
+ * Retrieves the number of unique users within a time range, including a daily breakdown. Since this endpoint returns the number of unique users, the sum of the daily values might be different from the total number. By default, Algolia distinguishes search users by their IP address, _unless_ you include a pseudonymous user identifier in your search requests with the `userToken` API parameter or `x-algolia-usertoken` request header. By default, the analyzed period includes the last eight days including the current day.
1198
1326
  *
1199
1327
  * Required API Key ACLs:
1200
1328
  * - analytics.
@@ -1203,7 +1331,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1203
1331
  * @param getUsersCount.index - Index name.
1204
1332
  * @param getUsersCount.startDate - Start date (`YYYY-MM-DD`) of the period to analyze.
1205
1333
  * @param getUsersCount.endDate - End date (`YYYY-MM-DD`) of the period to analyze.
1206
- * @param getUsersCount.tags - Filter analytics on the [`analyticsTags`](https://www.algolia.com/doc/api-reference/api-parameters/analyticsTags/) set at search time. Multiple tags can be combined with the operators OR and AND. If a tag contains characters like spaces or parentheses, it must be URL-encoded.
1334
+ * @param getUsersCount.tags - 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/).
1207
1335
  * @param requestOptions - The requestOptions to send along with the query, they will be merged with the transporter requestOptions.
1208
1336
  */
1209
1337
  getUsersCount({ index, startDate, endDate, tags }, requestOptions) {
@@ -1237,7 +1365,7 @@ function createAnalyticsClient({ appId: appIdOption, apiKey: apiKeyOption, authM
1237
1365
  }
1238
1366
 
1239
1367
  // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
1240
- const apiClientVersion$2 = '5.0.0-alpha.107';
1368
+ const apiClientVersion$2 = '5.0.0-alpha.109';
1241
1369
  const REGIONS = ['eu', 'us'];
1242
1370
  function getDefaultHosts$1(region) {
1243
1371
  const url = 'personalization.{region}.algolia.com'.replace('{region}', region);
@@ -1306,7 +1434,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1306
1434
  if (!path) {
1307
1435
  throw new Error('Parameter `path` is required when calling `customDelete`.');
1308
1436
  }
1309
- const requestPath = '/1{path}'.replace('{path}', path);
1437
+ const requestPath = '/{path}'.replace('{path}', path);
1310
1438
  const headers = {};
1311
1439
  const queryParameters = parameters ? parameters : {};
1312
1440
  const request = {
@@ -1329,7 +1457,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1329
1457
  if (!path) {
1330
1458
  throw new Error('Parameter `path` is required when calling `customGet`.');
1331
1459
  }
1332
- const requestPath = '/1{path}'.replace('{path}', path);
1460
+ const requestPath = '/{path}'.replace('{path}', path);
1333
1461
  const headers = {};
1334
1462
  const queryParameters = parameters ? parameters : {};
1335
1463
  const request = {
@@ -1353,7 +1481,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1353
1481
  if (!path) {
1354
1482
  throw new Error('Parameter `path` is required when calling `customPost`.');
1355
1483
  }
1356
- const requestPath = '/1{path}'.replace('{path}', path);
1484
+ const requestPath = '/{path}'.replace('{path}', path);
1357
1485
  const headers = {};
1358
1486
  const queryParameters = parameters ? parameters : {};
1359
1487
  const request = {
@@ -1378,7 +1506,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1378
1506
  if (!path) {
1379
1507
  throw new Error('Parameter `path` is required when calling `customPut`.');
1380
1508
  }
1381
- const requestPath = '/1{path}'.replace('{path}', path);
1509
+ const requestPath = '/{path}'.replace('{path}', path);
1382
1510
  const headers = {};
1383
1511
  const queryParameters = parameters ? parameters : {};
1384
1512
  const request = {
@@ -1498,7 +1626,7 @@ function createPersonalizationClient({ appId: appIdOption, apiKey: apiKeyOption,
1498
1626
  }
1499
1627
 
1500
1628
  // Code generated by OpenAPI Generator (https://openapi-generator.tech), manual changes will be lost - read more on https://github.com/algolia/api-clients-automation. DO NOT EDIT.
1501
- const apiClientVersion$1 = '5.0.0-alpha.107';
1629
+ const apiClientVersion$1 = '5.0.0-alpha.109';
1502
1630
  function getDefaultHosts(appId) {
1503
1631
  return [
1504
1632
  {
@@ -2187,7 +2315,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2187
2315
  if (!path) {
2188
2316
  throw new Error('Parameter `path` is required when calling `customDelete`.');
2189
2317
  }
2190
- const requestPath = '/1{path}'.replace('{path}', path);
2318
+ const requestPath = '/{path}'.replace('{path}', path);
2191
2319
  const headers = {};
2192
2320
  const queryParameters = parameters ? parameters : {};
2193
2321
  const request = {
@@ -2210,7 +2338,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2210
2338
  if (!path) {
2211
2339
  throw new Error('Parameter `path` is required when calling `customGet`.');
2212
2340
  }
2213
- const requestPath = '/1{path}'.replace('{path}', path);
2341
+ const requestPath = '/{path}'.replace('{path}', path);
2214
2342
  const headers = {};
2215
2343
  const queryParameters = parameters ? parameters : {};
2216
2344
  const request = {
@@ -2234,7 +2362,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2234
2362
  if (!path) {
2235
2363
  throw new Error('Parameter `path` is required when calling `customPost`.');
2236
2364
  }
2237
- const requestPath = '/1{path}'.replace('{path}', path);
2365
+ const requestPath = '/{path}'.replace('{path}', path);
2238
2366
  const headers = {};
2239
2367
  const queryParameters = parameters ? parameters : {};
2240
2368
  const request = {
@@ -2259,7 +2387,7 @@ function createSearchClient({ appId: appIdOption, apiKey: apiKeyOption, authMode
2259
2387
  if (!path) {
2260
2388
  throw new Error('Parameter `path` is required when calling `customPut`.');
2261
2389
  }
2262
- const requestPath = '/1{path}'.replace('{path}', path);
2390
+ const requestPath = '/{path}'.replace('{path}', path);
2263
2391
  const headers = {};
2264
2392
  const queryParameters = parameters ? parameters : {};
2265
2393
  const request = {