@algolia/n8n-nodes-algolia 0.6.0 → 0.7.0
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.
- package/README.md +66 -55
- package/dist/nodes/Algolia/Algolia.node.js +1918 -1996
- package/dist/nodes/Algolia/specs/abtesting-v3.json +43 -155
- package/dist/nodes/Algolia/specs/abtesting.json +35 -122
- package/dist/nodes/Algolia/specs/advanced-personalization.json +64 -238
- package/dist/nodes/Algolia/specs/analytics.json +107 -366
- package/dist/nodes/Algolia/specs/composition.json +237 -716
- package/dist/nodes/Algolia/specs/crawler.json +181 -536
- package/dist/nodes/Algolia/specs/ingestion.json +245 -992
- package/dist/nodes/Algolia/specs/insights.json +56 -222
- package/dist/nodes/Algolia/specs/monitoring.json +17 -57
- package/dist/nodes/Algolia/specs/personalization.json +24 -74
- package/dist/nodes/Algolia/specs/query-suggestions.json +26 -79
- package/dist/nodes/Algolia/specs/recommend.json +219 -688
- package/dist/nodes/Algolia/specs/search.json +459 -1428
- package/package.json +1 -1
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
"openapi": "3.0.2",
|
|
3
3
|
"info": {
|
|
4
4
|
"title": "Analytics API",
|
|
5
|
-
"description": "The Analytics API gives you access to metrics related to your Algolia search experience.\n\n## Base URLs\n\nThe base URLs for requests to the Analytics API are:\n\n- `https://analytics.us.algolia.com`\n- `https://analytics.de.algolia.com`\n- `https://analytics.algolia.com` (alias of `analytics.us.algolia.com`)\n\nUse the URL that matches your [analytics region](https://dashboard.algolia.com/account/infrastructure/analytics).\n\n**All requests must use HTTPS.**\n\n## Availability and authentication\n\nAccess to the Analytics API is available as part of the [Premium or Elevate plans](https://www.algolia.com/pricing).\n\nTo authenticate your API requests, add these headers:\n\n- `x-algolia-application-id`. Your Algolia application ID.\n- `x-algolia-api-key`. An API key with the necessary permissions to make the request.\n The required access control list (ACL) to make a request is listed in each endpoint's reference.\n\nYou can find your application ID and API key in the [Algolia dashboard](https://dashboard.algolia.com/account).\n\n## Rate limits\n\nYou can make up to **100 requests per minute per app** to the Analytics API.\nThe response includes headers with information about the limits.\n\n## Parameters\n\nQuery parameters must be [URL-encoded](https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding).\nNon-ASCII characters must be UTF-8 encoded.\nPlus characters (`+`) are interpreted as spaces.\n\n## Response status and errors\n\nThe Analytics API returns JSON responses.\nSince JSON doesn't guarantee any specific ordering, don't rely on the order of attributes in the API response.\n\n- Successful responses return a `2xx` status\n- Client errors return a `4xx` status\n- Server errors are indicated by a `5xx` status.\n\nError responses have a `message` property with more information.\n\n## Version\n\nThe current version of the Analytics API is version 2, as indicated by the `/2/` in each endpoint's URL.\n\n## Query aggregation\n\nAlgolia accepts queries on each keystroke.\nTo ensure you have relevant analytics data, however, the series of keystrokes is aggregated to keep only the latest (final) user query.\nThis is called \"prefix\" aggregation.\n\nFor more information, see [Query agggregation and processing](https://www.algolia.com/doc/guides/search-analytics/concepts/query-aggregation
|
|
5
|
+
"description": "The Analytics API gives you access to metrics related to your Algolia search experience.\n\n## Base URLs\n\nThe base URLs for requests to the Analytics API are:\n\n- `https://analytics.us.algolia.com`\n- `https://analytics.de.algolia.com`\n- `https://analytics.algolia.com` (alias of `analytics.us.algolia.com`)\n\nUse the URL that matches your [analytics region](https://dashboard.algolia.com/account/infrastructure/analytics).\n\n**All requests must use HTTPS.**\n\n## Availability and authentication\n\nAccess to the Analytics API is available as part of the [Premium or Elevate plans](https://www.algolia.com/pricing).\n\nTo authenticate your API requests, add these headers:\n\n- `x-algolia-application-id`. Your Algolia application ID.\n- `x-algolia-api-key`. An API key with the necessary permissions to make the request.\n The required access control list (ACL) to make a request is listed in each endpoint's reference.\n\nYou can find your application ID and API key in the [Algolia dashboard](https://dashboard.algolia.com/account).\n\n## Rate limits\n\nYou can make up to **100 requests per minute per app** to the Analytics API.\nThe response includes headers with information about the limits.\n\n## Parameters\n\nQuery parameters must be [URL-encoded](https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding).\nNon-ASCII characters must be UTF-8 encoded.\nPlus characters (`+`) are interpreted as spaces.\n\n## Response status and errors\n\nThe Analytics API returns JSON responses.\nSince JSON doesn't guarantee any specific ordering, don't rely on the order of attributes in the API response.\n\n- Successful responses return a `2xx` status\n- Client errors return a `4xx` status\n- Server errors are indicated by a `5xx` status.\n\nError responses have a `message` property with more information.\n\n## Version\n\nThe current version of the Analytics API is version 2, as indicated by the `/2/` in each endpoint's URL.\n\n## Query aggregation\n\nAlgolia accepts queries on each keystroke.\nTo ensure you have relevant analytics data, however, the series of keystrokes is aggregated to keep only the latest (final) user query.\nThis is called \"prefix\" aggregation.\n\nFor more information, see [Query agggregation and processing](https://www.algolia.com/doc/guides/search-analytics/concepts/query-aggregation).\n\nSee the analytics implementation overview for more information about query aggregation.\n",
|
|
6
6
|
"version": "2.0.0"
|
|
7
7
|
},
|
|
8
8
|
"servers": [
|
|
@@ -11,10 +11,7 @@
|
|
|
11
11
|
"variables": {
|
|
12
12
|
"region": {
|
|
13
13
|
"description": "The region where your Algolia application is hosted.",
|
|
14
|
-
"enum": [
|
|
15
|
-
"us",
|
|
16
|
-
"de"
|
|
17
|
-
],
|
|
14
|
+
"enum": ["us", "de"],
|
|
18
15
|
"default": "us"
|
|
19
16
|
}
|
|
20
17
|
}
|
|
@@ -62,8 +59,8 @@
|
|
|
62
59
|
}
|
|
63
60
|
],
|
|
64
61
|
"externalDocs": {
|
|
65
|
-
"url": "https://www.algolia.com/doc/guides/search-analytics/overview
|
|
66
|
-
"description": "
|
|
62
|
+
"url": "https://www.algolia.com/doc/guides/search-analytics/overview",
|
|
63
|
+
"description": "Search analytics."
|
|
67
64
|
},
|
|
68
65
|
"paths": {
|
|
69
66
|
"/{path}": {
|
|
@@ -238,16 +235,12 @@
|
|
|
238
235
|
},
|
|
239
236
|
"/2/searches": {
|
|
240
237
|
"get": {
|
|
241
|
-
"tags": [
|
|
242
|
-
"search"
|
|
243
|
-
],
|
|
238
|
+
"tags": ["search"],
|
|
244
239
|
"operationId": "getTopSearches",
|
|
245
240
|
"x-mcp-tool": true,
|
|
246
|
-
"x-acl": [
|
|
247
|
-
"analytics"
|
|
248
|
-
],
|
|
241
|
+
"x-acl": ["analytics"],
|
|
249
242
|
"summary": "Retrieve top searches",
|
|
250
|
-
"description": "Returns the most popular searches. For each search, it also includes the average number of hits.\n\nIf you set the `clickAnalytics` query parameter to `true`, the response also includes\n\n- Tracked searches count. Tracked searches are Search API requests with the `clickAnalytics` parameter set to `true`. This differs from the response's `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`.\n- Click count\n- Click-through rate (CTR)\n- Conversion count\n- Conversion rate (CR)\n- Average click position\n\nIf you set the `revenueAnalytics` query parameter to `true`, the response also includes:\n\n- Add-to-cart count\n- Add-to-cart rate (ATCR)\n- Purchase count\n- Purchase rate\n- Revenue details for each currency\n\n**There's a difference between 0% rates and null rates:**\n\n- **Null** means there were no queries: since Algolia didn't receive any events, the rates (CTR, CR, ATCR, purchase rate) are null.\n- **0% rates** mean there _were_ queries but no [click or conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
243
|
+
"description": "Returns the most popular searches. For each search, it also includes the average number of hits.\n\nIf you set the `clickAnalytics` query parameter to `true`, the response also includes\n\n- Tracked searches count. Tracked searches are Search API requests with the `clickAnalytics` parameter set to `true`. This differs from the response's `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`.\n- Click count\n- Click-through rate (CTR)\n- Conversion count\n- Conversion rate (CR)\n- Average click position\n\nIf you set the `revenueAnalytics` query parameter to `true`, the response also includes:\n\n- Add-to-cart count\n- Add-to-cart rate (ATCR)\n- Purchase count\n- Purchase rate\n- Revenue details for each currency\n\n**There's a difference between 0% rates and null rates:**\n\n- **Null** means there were no queries: since Algolia didn't receive any events, the rates (CTR, CR, ATCR, purchase rate) are null.\n- **0% rates** mean there _were_ queries but no [click or conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.\n",
|
|
251
244
|
"parameters": [
|
|
252
245
|
{
|
|
253
246
|
"$ref": "#/components/parameters/Index"
|
|
@@ -319,13 +312,9 @@
|
|
|
319
312
|
},
|
|
320
313
|
"/2/searches/count": {
|
|
321
314
|
"get": {
|
|
322
|
-
"tags": [
|
|
323
|
-
"search"
|
|
324
|
-
],
|
|
315
|
+
"tags": ["search"],
|
|
325
316
|
"operationId": "getSearchesCount",
|
|
326
|
-
"x-acl": [
|
|
327
|
-
"analytics"
|
|
328
|
-
],
|
|
317
|
+
"x-acl": ["analytics"],
|
|
329
318
|
"summary": "Retrieve number of searches",
|
|
330
319
|
"description": "Retrieves the number of searches within a time range, including a daily breakdown.\n\nBy default, the analyzed period includes the last eight days including the current day.\n",
|
|
331
320
|
"parameters": [
|
|
@@ -362,10 +351,7 @@
|
|
|
362
351
|
"title": "getSearchesCountResponse",
|
|
363
352
|
"type": "object",
|
|
364
353
|
"additionalProperties": false,
|
|
365
|
-
"required": [
|
|
366
|
-
"dates",
|
|
367
|
-
"count"
|
|
368
|
-
],
|
|
354
|
+
"required": ["dates", "count"],
|
|
369
355
|
"properties": {
|
|
370
356
|
"count": {
|
|
371
357
|
"$ref": "#/components/schemas/parameters_count"
|
|
@@ -377,10 +363,7 @@
|
|
|
377
363
|
"title": "dailySearches",
|
|
378
364
|
"type": "object",
|
|
379
365
|
"additionalProperties": false,
|
|
380
|
-
"required": [
|
|
381
|
-
"date",
|
|
382
|
-
"count"
|
|
383
|
-
],
|
|
366
|
+
"required": ["date", "count"],
|
|
384
367
|
"properties": {
|
|
385
368
|
"date": {
|
|
386
369
|
"$ref": "#/components/schemas/date"
|
|
@@ -413,13 +396,9 @@
|
|
|
413
396
|
},
|
|
414
397
|
"/2/searches/noResults": {
|
|
415
398
|
"get": {
|
|
416
|
-
"tags": [
|
|
417
|
-
"search"
|
|
418
|
-
],
|
|
399
|
+
"tags": ["search"],
|
|
419
400
|
"operationId": "getSearchesNoResults",
|
|
420
|
-
"x-acl": [
|
|
421
|
-
"analytics"
|
|
422
|
-
],
|
|
401
|
+
"x-acl": ["analytics"],
|
|
423
402
|
"summary": "Retrieve the most frequent searches without results",
|
|
424
403
|
"description": "Retrieves the 1,000 most frequent searches that produced zero results.",
|
|
425
404
|
"parameters": [
|
|
@@ -462,9 +441,7 @@
|
|
|
462
441
|
"title": "getSearchesNoResultsResponse",
|
|
463
442
|
"type": "object",
|
|
464
443
|
"additionalProperties": false,
|
|
465
|
-
"required": [
|
|
466
|
-
"searches"
|
|
467
|
-
],
|
|
444
|
+
"required": ["searches"],
|
|
468
445
|
"properties": {
|
|
469
446
|
"searches": {
|
|
470
447
|
"type": "array",
|
|
@@ -473,11 +450,7 @@
|
|
|
473
450
|
"title": "dailySearchesNoResults",
|
|
474
451
|
"type": "object",
|
|
475
452
|
"additionalProperties": false,
|
|
476
|
-
"required": [
|
|
477
|
-
"search",
|
|
478
|
-
"count",
|
|
479
|
-
"withFilterCount"
|
|
480
|
-
],
|
|
453
|
+
"required": ["search", "count", "withFilterCount"],
|
|
481
454
|
"properties": {
|
|
482
455
|
"search": {
|
|
483
456
|
"$ref": "#/components/schemas/search"
|
|
@@ -513,13 +486,9 @@
|
|
|
513
486
|
},
|
|
514
487
|
"/2/searches/noClicks": {
|
|
515
488
|
"get": {
|
|
516
|
-
"tags": [
|
|
517
|
-
"click"
|
|
518
|
-
],
|
|
489
|
+
"tags": ["click"],
|
|
519
490
|
"operationId": "getSearchesNoClicks",
|
|
520
|
-
"x-acl": [
|
|
521
|
-
"analytics"
|
|
522
|
-
],
|
|
491
|
+
"x-acl": ["analytics"],
|
|
523
492
|
"summary": "Retrieve top searches without clicks",
|
|
524
493
|
"description": "Retrieves the most popular searches that didn't lead to any clicks, from the 1,000 most frequent searches.\n\nFor each search, it also returns the number of displayed search results that remained unclicked.\n",
|
|
525
494
|
"parameters": [
|
|
@@ -562,9 +531,7 @@
|
|
|
562
531
|
"title": "getSearchesNoClicksResponse",
|
|
563
532
|
"type": "object",
|
|
564
533
|
"additionalProperties": false,
|
|
565
|
-
"required": [
|
|
566
|
-
"searches"
|
|
567
|
-
],
|
|
534
|
+
"required": ["searches"],
|
|
568
535
|
"properties": {
|
|
569
536
|
"searches": {
|
|
570
537
|
"type": "array",
|
|
@@ -573,11 +540,7 @@
|
|
|
573
540
|
"title": "dailySearchesNoClicks",
|
|
574
541
|
"type": "object",
|
|
575
542
|
"additionalProperties": false,
|
|
576
|
-
"required": [
|
|
577
|
-
"search",
|
|
578
|
-
"count",
|
|
579
|
-
"nbHits"
|
|
580
|
-
],
|
|
543
|
+
"required": ["search", "count", "nbHits"],
|
|
581
544
|
"properties": {
|
|
582
545
|
"search": {
|
|
583
546
|
"$ref": "#/components/schemas/search"
|
|
@@ -616,14 +579,10 @@
|
|
|
616
579
|
},
|
|
617
580
|
"/2/searches/noResultRate": {
|
|
618
581
|
"get": {
|
|
619
|
-
"tags": [
|
|
620
|
-
"search"
|
|
621
|
-
],
|
|
582
|
+
"tags": ["search"],
|
|
622
583
|
"operationId": "getNoResultsRate",
|
|
623
584
|
"x-mcp-tool": true,
|
|
624
|
-
"x-acl": [
|
|
625
|
-
"analytics"
|
|
626
|
-
],
|
|
585
|
+
"x-acl": ["analytics"],
|
|
627
586
|
"summary": "Retrieve no results rate",
|
|
628
587
|
"description": "Retrieves the fraction of searches that didn't return any results within a time range, including a daily breakdown.\nIt also returns the count of searches and searches without results used to compute the rates.\n\nBy default, the analyzed period includes the last eight days including the current day.\n",
|
|
629
588
|
"parameters": [
|
|
@@ -660,12 +619,7 @@
|
|
|
660
619
|
"title": "getNoResultsRateResponse",
|
|
661
620
|
"type": "object",
|
|
662
621
|
"additionalProperties": false,
|
|
663
|
-
"required": [
|
|
664
|
-
"rate",
|
|
665
|
-
"count",
|
|
666
|
-
"noResultCount",
|
|
667
|
-
"dates"
|
|
668
|
-
],
|
|
622
|
+
"required": ["rate", "count", "noResultCount", "dates"],
|
|
669
623
|
"properties": {
|
|
670
624
|
"rate": {
|
|
671
625
|
"$ref": "#/components/schemas/noResultsRate"
|
|
@@ -683,12 +637,7 @@
|
|
|
683
637
|
"title": "dailyNoResultsRates",
|
|
684
638
|
"type": "object",
|
|
685
639
|
"additionalProperties": false,
|
|
686
|
-
"required": [
|
|
687
|
-
"date",
|
|
688
|
-
"noResultCount",
|
|
689
|
-
"count",
|
|
690
|
-
"rate"
|
|
691
|
-
],
|
|
640
|
+
"required": ["date", "noResultCount", "count", "rate"],
|
|
692
641
|
"properties": {
|
|
693
642
|
"date": {
|
|
694
643
|
"$ref": "#/components/schemas/date"
|
|
@@ -727,13 +676,9 @@
|
|
|
727
676
|
},
|
|
728
677
|
"/2/searches/noClickRate": {
|
|
729
678
|
"get": {
|
|
730
|
-
"tags": [
|
|
731
|
-
"click"
|
|
732
|
-
],
|
|
679
|
+
"tags": ["click"],
|
|
733
680
|
"operationId": "getNoClickRate",
|
|
734
|
-
"x-acl": [
|
|
735
|
-
"analytics"
|
|
736
|
-
],
|
|
681
|
+
"x-acl": ["analytics"],
|
|
737
682
|
"summary": "Retrieve no click rate",
|
|
738
683
|
"description": "Retrieves the fraction of searches that didn't lead to any click within a time range, including a daily breakdown.\nIt also returns the number of tracked searches and tracked searches without clicks.\n\nBy default, the analyzed period includes the last eight days including the current day.\n",
|
|
739
684
|
"parameters": [
|
|
@@ -770,12 +715,7 @@
|
|
|
770
715
|
"title": "getNoClickRateResponse",
|
|
771
716
|
"type": "object",
|
|
772
717
|
"additionalProperties": false,
|
|
773
|
-
"required": [
|
|
774
|
-
"dates",
|
|
775
|
-
"count",
|
|
776
|
-
"noClickCount",
|
|
777
|
-
"rate"
|
|
778
|
-
],
|
|
718
|
+
"required": ["dates", "count", "noClickCount", "rate"],
|
|
779
719
|
"properties": {
|
|
780
720
|
"rate": {
|
|
781
721
|
"$ref": "#/components/schemas/noClickRate"
|
|
@@ -793,12 +733,7 @@
|
|
|
793
733
|
"title": "dailyNoClickRates",
|
|
794
734
|
"type": "object",
|
|
795
735
|
"additionalProperties": false,
|
|
796
|
-
"required": [
|
|
797
|
-
"rate",
|
|
798
|
-
"count",
|
|
799
|
-
"noClickCount",
|
|
800
|
-
"date"
|
|
801
|
-
],
|
|
736
|
+
"required": ["rate", "count", "noClickCount", "date"],
|
|
802
737
|
"properties": {
|
|
803
738
|
"rate": {
|
|
804
739
|
"$ref": "#/components/schemas/noClickRate"
|
|
@@ -837,16 +772,12 @@
|
|
|
837
772
|
},
|
|
838
773
|
"/2/hits": {
|
|
839
774
|
"get": {
|
|
840
|
-
"tags": [
|
|
841
|
-
"search"
|
|
842
|
-
],
|
|
775
|
+
"tags": ["search"],
|
|
843
776
|
"operationId": "getTopHits",
|
|
844
777
|
"x-mcp-tool": true,
|
|
845
|
-
"x-acl": [
|
|
846
|
-
"analytics"
|
|
847
|
-
],
|
|
778
|
+
"x-acl": ["analytics"],
|
|
848
779
|
"summary": "Retrieve top search results",
|
|
849
|
-
"description": "Retrieves the object IDs of the 1,000 most frequent search results.\n\nIf you set the `clickAnalytics` query parameter to true, the response also includes:\n\n- Tracked searches count. Tracked searches are Search API requests with the `clickAnalytics` parameter set to `true`. This differs from the response's `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`.\n- Click count\n- Click-through rate (CTR)\n- Conversion count\n- Conversion rate (CR)\n- Average click position\n\nIf you set the `revenueAnalytics` parameter to `true`, the response also includes:\n\n- Add-to-cart count\n- Add-to-cart rate (ATCR)\n- Purchase count\n- Purchase rate\n- Revenue details for each currency\n\n**There's a difference between 0% rates and null rates:**\n\n- **Null** means there were no queries: since Algolia didn't receive any events, the rates (CTR, CR, ATCR, purchase rate) are null.\n- **0% rates** mean there _were_ queries but no [click or conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
780
|
+
"description": "Retrieves the object IDs of the 1,000 most frequent search results.\n\nIf you set the `clickAnalytics` query parameter to true, the response also includes:\n\n- Tracked searches count. Tracked searches are Search API requests with the `clickAnalytics` parameter set to `true`. This differs from the response's `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`.\n- Click count\n- Click-through rate (CTR)\n- Conversion count\n- Conversion rate (CR)\n- Average click position\n\nIf you set the `revenueAnalytics` parameter to `true`, the response also includes:\n\n- Add-to-cart count\n- Add-to-cart rate (ATCR)\n- Purchase count\n- Purchase rate\n- Revenue details for each currency\n\n**There's a difference between 0% rates and null rates:**\n\n- **Null** means there were no queries: since Algolia didn't receive any events, the rates (CTR, CR, ATCR, purchase rate) are null.\n- **0% rates** mean there _were_ queries but no [click or conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.\n",
|
|
850
781
|
"parameters": [
|
|
851
782
|
{
|
|
852
783
|
"$ref": "#/components/parameters/Index"
|
|
@@ -915,18 +846,14 @@
|
|
|
915
846
|
},
|
|
916
847
|
"/2/users/count": {
|
|
917
848
|
"get": {
|
|
918
|
-
"tags": [
|
|
919
|
-
"user"
|
|
920
|
-
],
|
|
849
|
+
"tags": ["user"],
|
|
921
850
|
"operationId": "getUsersCount",
|
|
922
|
-
"x-acl": [
|
|
923
|
-
"analytics"
|
|
924
|
-
],
|
|
851
|
+
"x-acl": ["analytics"],
|
|
925
852
|
"summary": "Retrieve number of users",
|
|
926
853
|
"description": "Retrieves the number of unique users within a time range, including a daily breakdown.\n\nSince it returns the number of unique users, the sum of the daily values might be different from the total number.\n\nBy default:\n\n- 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.\n- The analyzed period includes the last eight days including the current day.\n",
|
|
927
854
|
"externalDocs": {
|
|
928
|
-
"url": "https://www.algolia.com/doc/guides/search-analytics/guides/usertoken
|
|
929
|
-
"description": "
|
|
855
|
+
"url": "https://www.algolia.com/doc/guides/search-analytics/guides/usertoken",
|
|
856
|
+
"description": "Distinguish users for analytics."
|
|
930
857
|
},
|
|
931
858
|
"parameters": [
|
|
932
859
|
{
|
|
@@ -962,10 +889,7 @@
|
|
|
962
889
|
"title": "getUsersCountResponse",
|
|
963
890
|
"type": "object",
|
|
964
891
|
"additionalProperties": false,
|
|
965
|
-
"required": [
|
|
966
|
-
"dates",
|
|
967
|
-
"count"
|
|
968
|
-
],
|
|
892
|
+
"required": ["dates", "count"],
|
|
969
893
|
"properties": {
|
|
970
894
|
"count": {
|
|
971
895
|
"type": "integer",
|
|
@@ -978,10 +902,7 @@
|
|
|
978
902
|
"title": "dailyUsers",
|
|
979
903
|
"type": "object",
|
|
980
904
|
"additionalProperties": false,
|
|
981
|
-
"required": [
|
|
982
|
-
"date",
|
|
983
|
-
"count"
|
|
984
|
-
],
|
|
905
|
+
"required": ["date", "count"],
|
|
985
906
|
"properties": {
|
|
986
907
|
"date": {
|
|
987
908
|
"$ref": "#/components/schemas/date"
|
|
@@ -1015,13 +936,9 @@
|
|
|
1015
936
|
},
|
|
1016
937
|
"/2/filters": {
|
|
1017
938
|
"get": {
|
|
1018
|
-
"tags": [
|
|
1019
|
-
"filter"
|
|
1020
|
-
],
|
|
939
|
+
"tags": ["filter"],
|
|
1021
940
|
"operationId": "getTopFilterAttributes",
|
|
1022
|
-
"x-acl": [
|
|
1023
|
-
"analytics"
|
|
1024
|
-
],
|
|
941
|
+
"x-acl": ["analytics"],
|
|
1025
942
|
"summary": "Retrieve top filters",
|
|
1026
943
|
"description": "Retrieves the 1,000 most frequently used filter attributes.\n\nThese are attributes of your records that you included in the `attributesForFaceting` setting.\n",
|
|
1027
944
|
"parameters": [
|
|
@@ -1086,13 +1003,9 @@
|
|
|
1086
1003
|
},
|
|
1087
1004
|
"/2/filters/{attribute}": {
|
|
1088
1005
|
"get": {
|
|
1089
|
-
"tags": [
|
|
1090
|
-
"filter"
|
|
1091
|
-
],
|
|
1006
|
+
"tags": ["filter"],
|
|
1092
1007
|
"operationId": "getTopFilterForAttribute",
|
|
1093
|
-
"x-acl": [
|
|
1094
|
-
"analytics"
|
|
1095
|
-
],
|
|
1008
|
+
"x-acl": ["analytics"],
|
|
1096
1009
|
"summary": "Retrieve top filter values",
|
|
1097
1010
|
"description": "Retrieves the 1,000 most frequent filter (facet) values for a filter attribute.\n\nThese are attributes of your records that you included in the `attributesForFaceting` setting.\n",
|
|
1098
1011
|
"parameters": [
|
|
@@ -1160,15 +1073,11 @@
|
|
|
1160
1073
|
},
|
|
1161
1074
|
"/2/filters/noResults": {
|
|
1162
1075
|
"get": {
|
|
1163
|
-
"tags": [
|
|
1164
|
-
"filter"
|
|
1165
|
-
],
|
|
1076
|
+
"tags": ["filter"],
|
|
1166
1077
|
"operationId": "getTopFiltersNoResults",
|
|
1167
|
-
"x-acl": [
|
|
1168
|
-
"analytics"
|
|
1169
|
-
],
|
|
1078
|
+
"x-acl": ["analytics"],
|
|
1170
1079
|
"summary": "Retrieve top filters for a search without results",
|
|
1171
|
-
"description": "Retrieves the 1,000 most frequently used filters for a search that didn't return any results.\n\nTo get the most frequent searches without results, use the [Retrieve searches without results](
|
|
1080
|
+
"description": "Retrieves the 1,000 most frequently used filters for a search that didn't return any results.\n\nTo get the most frequent searches without results, use the [Retrieve searches without results](https://www.algolia.com/doc/rest-api/analytics/get-searches-no-results) operation.\n",
|
|
1172
1081
|
"parameters": [
|
|
1173
1082
|
{
|
|
1174
1083
|
"$ref": "#/components/parameters/Index"
|
|
@@ -1231,13 +1140,9 @@
|
|
|
1231
1140
|
},
|
|
1232
1141
|
"/2/countries": {
|
|
1233
1142
|
"get": {
|
|
1234
|
-
"tags": [
|
|
1235
|
-
"user"
|
|
1236
|
-
],
|
|
1143
|
+
"tags": ["user"],
|
|
1237
1144
|
"operationId": "getTopCountries",
|
|
1238
|
-
"x-acl": [
|
|
1239
|
-
"analytics"
|
|
1240
|
-
],
|
|
1145
|
+
"x-acl": ["analytics"],
|
|
1241
1146
|
"summary": "Retrieve top countries",
|
|
1242
1147
|
"description": "Retrieves the countries with the most searches in your index.",
|
|
1243
1148
|
"parameters": [
|
|
@@ -1280,9 +1185,7 @@
|
|
|
1280
1185
|
"title": "getTopCountriesResponse",
|
|
1281
1186
|
"type": "object",
|
|
1282
1187
|
"additionalProperties": false,
|
|
1283
|
-
"required": [
|
|
1284
|
-
"countries"
|
|
1285
|
-
],
|
|
1188
|
+
"required": ["countries"],
|
|
1286
1189
|
"properties": {
|
|
1287
1190
|
"countries": {
|
|
1288
1191
|
"type": "array",
|
|
@@ -1291,10 +1194,7 @@
|
|
|
1291
1194
|
"title": "topCountry",
|
|
1292
1195
|
"type": "object",
|
|
1293
1196
|
"additionalProperties": false,
|
|
1294
|
-
"required": [
|
|
1295
|
-
"country",
|
|
1296
|
-
"count"
|
|
1297
|
-
],
|
|
1197
|
+
"required": ["country", "count"],
|
|
1298
1198
|
"properties": {
|
|
1299
1199
|
"country": {
|
|
1300
1200
|
"description": "Country code.",
|
|
@@ -1329,15 +1229,11 @@
|
|
|
1329
1229
|
},
|
|
1330
1230
|
"/2/clicks/averageClickPosition": {
|
|
1331
1231
|
"get": {
|
|
1332
|
-
"tags": [
|
|
1333
|
-
"click"
|
|
1334
|
-
],
|
|
1232
|
+
"tags": ["click"],
|
|
1335
1233
|
"operationId": "getAverageClickPosition",
|
|
1336
|
-
"x-acl": [
|
|
1337
|
-
"analytics"
|
|
1338
|
-
],
|
|
1234
|
+
"x-acl": ["analytics"],
|
|
1339
1235
|
"summary": "Retrieve average click position",
|
|
1340
|
-
"description": "Retrieves the average click position of your search results, including a daily breakdown.\n\nThe average click position is the average of all clicked search result positions.\nFor example, if users only ever click on the first result for any search, the average click position is 1.\nBy default, the analyzed period includes the last eight days including the current day.\n\nAn average of `null` when `clickAnalytics` is enabled means Algolia didn't receive any [click events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
1236
|
+
"description": "Retrieves the average click position of your search results, including a daily breakdown.\n\nThe average click position is the average of all clicked search result positions.\nFor example, if users only ever click on the first result for any search, the average click position is 1.\nBy default, the analyzed period includes the last eight days including the current day.\n\nAn average of `null` when `clickAnalytics` is enabled means Algolia didn't receive any [click events](https://www.algolia.com/doc/guides/sending-events/getting-started) for the queries.\nThe average is `null` until Algolia receives at least one click event.\n",
|
|
1341
1237
|
"parameters": [
|
|
1342
1238
|
{
|
|
1343
1239
|
"$ref": "#/components/parameters/Index"
|
|
@@ -1372,11 +1268,7 @@
|
|
|
1372
1268
|
"title": "getAverageClickPositionResponse",
|
|
1373
1269
|
"type": "object",
|
|
1374
1270
|
"additionalProperties": false,
|
|
1375
|
-
"required": [
|
|
1376
|
-
"average",
|
|
1377
|
-
"clickCount",
|
|
1378
|
-
"dates"
|
|
1379
|
-
],
|
|
1271
|
+
"required": ["average", "clickCount", "dates"],
|
|
1380
1272
|
"properties": {
|
|
1381
1273
|
"average": {
|
|
1382
1274
|
"$ref": "#/components/schemas/averageClickPosition"
|
|
@@ -1391,11 +1283,7 @@
|
|
|
1391
1283
|
"title": "dailyAverageClicks",
|
|
1392
1284
|
"type": "object",
|
|
1393
1285
|
"additionalProperties": false,
|
|
1394
|
-
"required": [
|
|
1395
|
-
"average",
|
|
1396
|
-
"clickCount",
|
|
1397
|
-
"date"
|
|
1398
|
-
],
|
|
1286
|
+
"required": ["average", "clickCount", "date"],
|
|
1399
1287
|
"properties": {
|
|
1400
1288
|
"average": {
|
|
1401
1289
|
"$ref": "#/components/schemas/averageClickPosition"
|
|
@@ -1431,15 +1319,11 @@
|
|
|
1431
1319
|
},
|
|
1432
1320
|
"/2/clicks/positions": {
|
|
1433
1321
|
"get": {
|
|
1434
|
-
"tags": [
|
|
1435
|
-
"click"
|
|
1436
|
-
],
|
|
1322
|
+
"tags": ["click"],
|
|
1437
1323
|
"operationId": "getClickPositions",
|
|
1438
|
-
"x-acl": [
|
|
1439
|
-
"analytics"
|
|
1440
|
-
],
|
|
1324
|
+
"x-acl": ["analytics"],
|
|
1441
1325
|
"summary": "Retrieve click positions",
|
|
1442
|
-
"description": "Retrieves the positions in the search results and their associated number of clicks.\n\nThis lets you check how many clicks the first, second, or tenth search results receive.\n\nAn average of `0` when `clickAnalytics` is enabled means Algolia didn't receive any [click events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
1326
|
+
"description": "Retrieves the positions in the search results and their associated number of clicks.\n\nThis lets you check how many clicks the first, second, or tenth search results receive.\n\nAn average of `0` when `clickAnalytics` is enabled means Algolia didn't receive any [click events](https://www.algolia.com/doc/guides/sending-events/getting-started) for the queries.\n",
|
|
1443
1327
|
"parameters": [
|
|
1444
1328
|
{
|
|
1445
1329
|
"$ref": "#/components/parameters/Index"
|
|
@@ -1474,9 +1358,7 @@
|
|
|
1474
1358
|
"title": "getClickPositionsResponse",
|
|
1475
1359
|
"type": "object",
|
|
1476
1360
|
"additionalProperties": false,
|
|
1477
|
-
"required": [
|
|
1478
|
-
"positions"
|
|
1479
|
-
],
|
|
1361
|
+
"required": ["positions"],
|
|
1480
1362
|
"properties": {
|
|
1481
1363
|
"positions": {
|
|
1482
1364
|
"$ref": "#/components/schemas/clickPositions"
|
|
@@ -1503,15 +1385,11 @@
|
|
|
1503
1385
|
},
|
|
1504
1386
|
"/2/clicks/clickThroughRate": {
|
|
1505
1387
|
"get": {
|
|
1506
|
-
"tags": [
|
|
1507
|
-
"click"
|
|
1508
|
-
],
|
|
1388
|
+
"tags": ["click"],
|
|
1509
1389
|
"operationId": "getClickThroughRate",
|
|
1510
|
-
"x-acl": [
|
|
1511
|
-
"analytics"
|
|
1512
|
-
],
|
|
1390
|
+
"x-acl": ["analytics"],
|
|
1513
1391
|
"summary": "Retrieve click-through rate",
|
|
1514
|
-
"description": "Retrieves the click-through rate (CTR) for all your searches with at least one click event, including a daily breakdown.\n\nBy default, the analyzed period includes the last eight days including the current day.\n\n**There's a difference between a 0 and null CTR when `clickAnalytics` is enabled:**\n\n- **Null** means there were no queries: since Algolia didn't receive any events, CTR is null.\n- **0** mean there _were_ queries but no [click events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
1392
|
+
"description": "Retrieves the click-through rate (CTR) for all your searches with at least one click event, including a daily breakdown.\n\nBy default, the analyzed period includes the last eight days including the current day.\n\n**There's a difference between a 0 and null CTR when `clickAnalytics` is enabled:**\n\n- **Null** means there were no queries: since Algolia didn't receive any events, CTR is null.\n- **0** mean there _were_ queries but no [click events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.\n",
|
|
1515
1393
|
"parameters": [
|
|
1516
1394
|
{
|
|
1517
1395
|
"$ref": "#/components/parameters/Index"
|
|
@@ -1546,12 +1424,7 @@
|
|
|
1546
1424
|
"title": "getClickThroughRateResponse",
|
|
1547
1425
|
"type": "object",
|
|
1548
1426
|
"additionalProperties": false,
|
|
1549
|
-
"required": [
|
|
1550
|
-
"dates",
|
|
1551
|
-
"clickCount",
|
|
1552
|
-
"trackedSearchCount",
|
|
1553
|
-
"rate"
|
|
1554
|
-
],
|
|
1427
|
+
"required": ["dates", "clickCount", "trackedSearchCount", "rate"],
|
|
1555
1428
|
"properties": {
|
|
1556
1429
|
"rate": {
|
|
1557
1430
|
"$ref": "#/components/schemas/clickThroughRate"
|
|
@@ -1569,12 +1442,7 @@
|
|
|
1569
1442
|
"title": "dailyClickThroughRates",
|
|
1570
1443
|
"type": "object",
|
|
1571
1444
|
"additionalProperties": false,
|
|
1572
|
-
"required": [
|
|
1573
|
-
"rate",
|
|
1574
|
-
"clickCount",
|
|
1575
|
-
"trackedSearchCount",
|
|
1576
|
-
"date"
|
|
1577
|
-
],
|
|
1445
|
+
"required": ["rate", "clickCount", "trackedSearchCount", "date"],
|
|
1578
1446
|
"properties": {
|
|
1579
1447
|
"rate": {
|
|
1580
1448
|
"$ref": "#/components/schemas/clickThroughRate"
|
|
@@ -1613,15 +1481,11 @@
|
|
|
1613
1481
|
},
|
|
1614
1482
|
"/2/conversions/conversionRate": {
|
|
1615
1483
|
"get": {
|
|
1616
|
-
"tags": [
|
|
1617
|
-
"click"
|
|
1618
|
-
],
|
|
1484
|
+
"tags": ["click"],
|
|
1619
1485
|
"operationId": "getConversionRate",
|
|
1620
|
-
"x-acl": [
|
|
1621
|
-
"analytics"
|
|
1622
|
-
],
|
|
1486
|
+
"x-acl": ["analytics"],
|
|
1623
1487
|
"summary": "Retrieve conversion rate",
|
|
1624
|
-
"description": "Retrieves the conversion rate (CR) for all your searches with at least one conversion event, including a daily breakdown.\n\nBy default, the analyzed period includes the last eight days including the current day.\n\n**There's a difference between a 0 and null CR when `clickAnalytics` is enabled:**\n\n- **Null** means there were no queries: since Algolia didn't receive any events, CR is null.\n- **0** mean there _were_ queries but no [conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
1488
|
+
"description": "Retrieves the conversion rate (CR) for all your searches with at least one conversion event, including a daily breakdown.\n\nBy default, the analyzed period includes the last eight days including the current day.\n\n**There's a difference between a 0 and null CR when `clickAnalytics` is enabled:**\n\n- **Null** means there were no queries: since Algolia didn't receive any events, CR is null.\n- **0** mean there _were_ queries but no [conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.\n",
|
|
1625
1489
|
"parameters": [
|
|
1626
1490
|
{
|
|
1627
1491
|
"$ref": "#/components/parameters/Index"
|
|
@@ -1656,12 +1520,7 @@
|
|
|
1656
1520
|
"title": "getConversionRateResponse",
|
|
1657
1521
|
"type": "object",
|
|
1658
1522
|
"additionalProperties": false,
|
|
1659
|
-
"required": [
|
|
1660
|
-
"dates",
|
|
1661
|
-
"trackedSearchCount",
|
|
1662
|
-
"conversionCount",
|
|
1663
|
-
"rate"
|
|
1664
|
-
],
|
|
1523
|
+
"required": ["dates", "trackedSearchCount", "conversionCount", "rate"],
|
|
1665
1524
|
"properties": {
|
|
1666
1525
|
"rate": {
|
|
1667
1526
|
"$ref": "#/components/schemas/conversionRate"
|
|
@@ -1679,12 +1538,7 @@
|
|
|
1679
1538
|
"title": "dailyConversionRates",
|
|
1680
1539
|
"type": "object",
|
|
1681
1540
|
"additionalProperties": false,
|
|
1682
|
-
"required": [
|
|
1683
|
-
"rate",
|
|
1684
|
-
"trackedSearchCount",
|
|
1685
|
-
"conversionCount",
|
|
1686
|
-
"date"
|
|
1687
|
-
],
|
|
1541
|
+
"required": ["rate", "trackedSearchCount", "conversionCount", "date"],
|
|
1688
1542
|
"properties": {
|
|
1689
1543
|
"rate": {
|
|
1690
1544
|
"$ref": "#/components/schemas/conversionRate"
|
|
@@ -1723,15 +1577,11 @@
|
|
|
1723
1577
|
},
|
|
1724
1578
|
"/2/conversions/addToCartRate": {
|
|
1725
1579
|
"get": {
|
|
1726
|
-
"tags": [
|
|
1727
|
-
"click"
|
|
1728
|
-
],
|
|
1580
|
+
"tags": ["click"],
|
|
1729
1581
|
"operationId": "getAddToCartRate",
|
|
1730
|
-
"x-acl": [
|
|
1731
|
-
"analytics"
|
|
1732
|
-
],
|
|
1582
|
+
"x-acl": ["analytics"],
|
|
1733
1583
|
"summary": "Retrieve add-to-cart rate",
|
|
1734
|
-
"description": "Retrieves the add-to-cart rate for all your searches with at least one add-to-cart event, including a daily breakdown.\n\nBy default, the analyzed period includes the last eight days including the current day.\n\nThe rate is the number of add-to-cart conversion events divided by the number of tracked searches.\nA search is tracked if it returns a queryID (`clickAnalytics` is `true`).\nThis differs from the response's `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`.\n\n**There's a difference between a 0 and null add-to-cart rate when `clickAnalytics` is enabled:**\n\n- **Null** means there were no queries: since Algolia didn't receive any events, the add-to-cart rate is null.\n- **0** mean there _were_ queries but no [add-to-cart events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
1584
|
+
"description": "Retrieves the add-to-cart rate for all your searches with at least one add-to-cart event, including a daily breakdown.\n\nBy default, the analyzed period includes the last eight days including the current day.\n\nThe rate is the number of add-to-cart conversion events divided by the number of tracked searches.\nA search is tracked if it returns a queryID (`clickAnalytics` is `true`).\nThis differs from the response's `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`.\n\n**There's a difference between a 0 and null add-to-cart rate when `clickAnalytics` is enabled:**\n\n- **Null** means there were no queries: since Algolia didn't receive any events, the add-to-cart rate is null.\n- **0** mean there _were_ queries but no [add-to-cart events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.\n",
|
|
1735
1585
|
"parameters": [
|
|
1736
1586
|
{
|
|
1737
1587
|
"$ref": "#/components/parameters/Index"
|
|
@@ -1766,12 +1616,7 @@
|
|
|
1766
1616
|
"title": "getAddToCartRateResponse",
|
|
1767
1617
|
"type": "object",
|
|
1768
1618
|
"additionalProperties": false,
|
|
1769
|
-
"required": [
|
|
1770
|
-
"dates",
|
|
1771
|
-
"trackedSearchCount",
|
|
1772
|
-
"addToCartCount",
|
|
1773
|
-
"rate"
|
|
1774
|
-
],
|
|
1619
|
+
"required": ["dates", "trackedSearchCount", "addToCartCount", "rate"],
|
|
1775
1620
|
"properties": {
|
|
1776
1621
|
"rate": {
|
|
1777
1622
|
"$ref": "#/components/schemas/addToCartRate"
|
|
@@ -1789,12 +1634,7 @@
|
|
|
1789
1634
|
"title": "dailyAddToCartRates",
|
|
1790
1635
|
"type": "object",
|
|
1791
1636
|
"additionalProperties": false,
|
|
1792
|
-
"required": [
|
|
1793
|
-
"rate",
|
|
1794
|
-
"trackedSearchCount",
|
|
1795
|
-
"addToCartCount",
|
|
1796
|
-
"date"
|
|
1797
|
-
],
|
|
1637
|
+
"required": ["rate", "trackedSearchCount", "addToCartCount", "date"],
|
|
1798
1638
|
"properties": {
|
|
1799
1639
|
"rate": {
|
|
1800
1640
|
"$ref": "#/components/schemas/addToCartRate"
|
|
@@ -1833,15 +1673,11 @@
|
|
|
1833
1673
|
},
|
|
1834
1674
|
"/2/conversions/purchaseRate": {
|
|
1835
1675
|
"get": {
|
|
1836
|
-
"tags": [
|
|
1837
|
-
"click"
|
|
1838
|
-
],
|
|
1676
|
+
"tags": ["click"],
|
|
1839
1677
|
"operationId": "getPurchaseRate",
|
|
1840
|
-
"x-acl": [
|
|
1841
|
-
"analytics"
|
|
1842
|
-
],
|
|
1678
|
+
"x-acl": ["analytics"],
|
|
1843
1679
|
"summary": "Retrieve purchase rate",
|
|
1844
|
-
"description": "Retrieves the purchase rate for all your searches with at least one purchase event, including a daily breakdown.\n\nBy default, the analyzed period includes the last eight days including the current day.\n\nThe rate is the number of purchase conversion events divided by the number of tracked searches.\nA search is tracked if it returns a query ID (`clickAnalytics` is `true`).\nThis differs from the response's `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`.\n\n**There's a difference between a 0 and null purchase rate when `clickAnalytics` is enabled:**\n\n- **Null** means there were no queries: since Algolia didn't receive any events, the purchase rate is null.\n- **0** mean there _were_ queries but no [purchase conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started
|
|
1680
|
+
"description": "Retrieves the purchase rate for all your searches with at least one purchase event, including a daily breakdown.\n\nBy default, the analyzed period includes the last eight days including the current day.\n\nThe rate is the number of purchase conversion events divided by the number of tracked searches.\nA search is tracked if it returns a query ID (`clickAnalytics` is `true`).\nThis differs from the response's `count`, which shows the overall number of searches, including those where `clickAnalytics` is `false`.\n\n**There's a difference between a 0 and null purchase rate when `clickAnalytics` is enabled:**\n\n- **Null** means there were no queries: since Algolia didn't receive any events, the purchase rate is null.\n- **0** mean there _were_ queries but no [purchase conversion events](https://www.algolia.com/doc/guides/sending-events/getting-started) were received.\n",
|
|
1845
1681
|
"parameters": [
|
|
1846
1682
|
{
|
|
1847
1683
|
"$ref": "#/components/parameters/Index"
|
|
@@ -1876,12 +1712,7 @@
|
|
|
1876
1712
|
"title": "getPurchaseRateResponse",
|
|
1877
1713
|
"type": "object",
|
|
1878
1714
|
"additionalProperties": false,
|
|
1879
|
-
"required": [
|
|
1880
|
-
"dates",
|
|
1881
|
-
"trackedSearchCount",
|
|
1882
|
-
"purchaseCount",
|
|
1883
|
-
"rate"
|
|
1884
|
-
],
|
|
1715
|
+
"required": ["dates", "trackedSearchCount", "purchaseCount", "rate"],
|
|
1885
1716
|
"properties": {
|
|
1886
1717
|
"rate": {
|
|
1887
1718
|
"$ref": "#/components/schemas/purchaseRate"
|
|
@@ -1899,12 +1730,7 @@
|
|
|
1899
1730
|
"title": "dailyPurchaseRates",
|
|
1900
1731
|
"type": "object",
|
|
1901
1732
|
"additionalProperties": false,
|
|
1902
|
-
"required": [
|
|
1903
|
-
"rate",
|
|
1904
|
-
"trackedSearchCount",
|
|
1905
|
-
"purchaseCount",
|
|
1906
|
-
"date"
|
|
1907
|
-
],
|
|
1733
|
+
"required": ["rate", "trackedSearchCount", "purchaseCount", "date"],
|
|
1908
1734
|
"properties": {
|
|
1909
1735
|
"rate": {
|
|
1910
1736
|
"$ref": "#/components/schemas/purchaseRate"
|
|
@@ -1943,13 +1769,9 @@
|
|
|
1943
1769
|
},
|
|
1944
1770
|
"/2/conversions/revenue": {
|
|
1945
1771
|
"get": {
|
|
1946
|
-
"tags": [
|
|
1947
|
-
"revenue"
|
|
1948
|
-
],
|
|
1772
|
+
"tags": ["revenue"],
|
|
1949
1773
|
"operationId": "getRevenue",
|
|
1950
|
-
"x-acl": [
|
|
1951
|
-
"analytics"
|
|
1952
|
-
],
|
|
1774
|
+
"x-acl": ["analytics"],
|
|
1953
1775
|
"summary": "Retrieve revenue data",
|
|
1954
1776
|
"description": "Retrieves revenue-related metrics, such as the total revenue or the average order value.\n\nTo retrieve revenue-related metrics, send purchase events.\nBy default, the analyzed period includes the last eight days including the current day.\n\nRevenue is based on purchase conversion events (a conversion event with an `eventSubtype` attribute of `purchase`).\nThe revenue is the `price` attribute multiplied by the `quantity` attribute for each object in the event's `objectData` array.\n",
|
|
1955
1777
|
"parameters": [
|
|
@@ -1975,10 +1797,7 @@
|
|
|
1975
1797
|
"title": "getRevenue",
|
|
1976
1798
|
"type": "object",
|
|
1977
1799
|
"additionalProperties": false,
|
|
1978
|
-
"required": [
|
|
1979
|
-
"currencies",
|
|
1980
|
-
"dates"
|
|
1981
|
-
],
|
|
1800
|
+
"required": ["currencies", "dates"],
|
|
1982
1801
|
"properties": {
|
|
1983
1802
|
"currencies": {
|
|
1984
1803
|
"$ref": "#/components/schemas/currencies"
|
|
@@ -1990,10 +1809,7 @@
|
|
|
1990
1809
|
"title": "dailyRevenue",
|
|
1991
1810
|
"type": "object",
|
|
1992
1811
|
"additionalProperties": false,
|
|
1993
|
-
"required": [
|
|
1994
|
-
"currencies",
|
|
1995
|
-
"date"
|
|
1996
|
-
],
|
|
1812
|
+
"required": ["currencies", "date"],
|
|
1997
1813
|
"properties": {
|
|
1998
1814
|
"currencies": {
|
|
1999
1815
|
"$ref": "#/components/schemas/currencies"
|
|
@@ -2026,13 +1842,9 @@
|
|
|
2026
1842
|
},
|
|
2027
1843
|
"/2/status": {
|
|
2028
1844
|
"get": {
|
|
2029
|
-
"tags": [
|
|
2030
|
-
"status"
|
|
2031
|
-
],
|
|
1845
|
+
"tags": ["status"],
|
|
2032
1846
|
"operationId": "getStatus",
|
|
2033
|
-
"x-acl": [
|
|
2034
|
-
"analytics"
|
|
2035
|
-
],
|
|
1847
|
+
"x-acl": ["analytics"],
|
|
2036
1848
|
"summary": "Retrieve update status",
|
|
2037
1849
|
"description": "Retrieves the time when the Analytics data for the specified index was last updated.\n\nIf the index has been recently created or no search has been performed yet the updated time is `null`.\n\nThe Analytics data is updated every 5 minutes.\n",
|
|
2038
1850
|
"parameters": [
|
|
@@ -2049,9 +1861,7 @@
|
|
|
2049
1861
|
"title": "getStatusResponse",
|
|
2050
1862
|
"type": "object",
|
|
2051
1863
|
"additionalProperties": false,
|
|
2052
|
-
"required": [
|
|
2053
|
-
"updatedAt"
|
|
2054
|
-
],
|
|
1864
|
+
"required": ["updatedAt"],
|
|
2055
1865
|
"properties": {
|
|
2056
1866
|
"updatedAt": {
|
|
2057
1867
|
"$ref": "#/components/schemas/updatedAtNullable"
|
|
@@ -2080,9 +1890,7 @@
|
|
|
2080
1890
|
"get": {
|
|
2081
1891
|
"x-helper": true,
|
|
2082
1892
|
"x-asynchronous-helper": false,
|
|
2083
|
-
"tags": [
|
|
2084
|
-
"Api Key"
|
|
2085
|
-
],
|
|
1893
|
+
"tags": ["Api Key"],
|
|
2086
1894
|
"operationId": "setClientApiKey",
|
|
2087
1895
|
"summary": "Switch the API key used to authenticate requests",
|
|
2088
1896
|
"description": "Switch the API key used to authenticate requests.\n",
|
|
@@ -2227,7 +2035,7 @@
|
|
|
2227
2035
|
"Tags": {
|
|
2228
2036
|
"name": "tags",
|
|
2229
2037
|
"in": "query",
|
|
2230
|
-
"description": "Tags by which to segment the analytics.\n\nYou can combine multiple tags with `OR` and `AND`.\nTags must be URL-encoded.\nFor more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments
|
|
2038
|
+
"description": "Tags by which to segment the analytics.\n\nYou can combine multiple tags with `OR` and `AND`.\nTags must be URL-encoded.\nFor more information, see [Segment your analytics data](https://www.algolia.com/doc/guides/search-analytics/guides/segments).\n",
|
|
2231
2039
|
"example": "device:mobile%20phone",
|
|
2232
2040
|
"schema": {
|
|
2233
2041
|
"type": "string"
|
|
@@ -2269,20 +2077,12 @@
|
|
|
2269
2077
|
"orderBy": {
|
|
2270
2078
|
"type": "string",
|
|
2271
2079
|
"description": "Attribute by which to order the response items.\n\nIf the `clickAnalytics` parameter is false, only `searchCount` is available.\n",
|
|
2272
|
-
"enum": [
|
|
2273
|
-
"searchCount",
|
|
2274
|
-
"clickThroughRate",
|
|
2275
|
-
"conversionRate",
|
|
2276
|
-
"averageClickPosition"
|
|
2277
|
-
],
|
|
2080
|
+
"enum": ["searchCount", "clickThroughRate", "conversionRate", "averageClickPosition"],
|
|
2278
2081
|
"default": "searchCount"
|
|
2279
2082
|
},
|
|
2280
2083
|
"direction": {
|
|
2281
2084
|
"type": "string",
|
|
2282
|
-
"enum": [
|
|
2283
|
-
"asc",
|
|
2284
|
-
"desc"
|
|
2285
|
-
],
|
|
2085
|
+
"enum": ["asc", "desc"],
|
|
2286
2086
|
"default": "asc"
|
|
2287
2087
|
},
|
|
2288
2088
|
"search": {
|
|
@@ -2304,9 +2104,7 @@
|
|
|
2304
2104
|
"type": "object",
|
|
2305
2105
|
"title": "Top searches",
|
|
2306
2106
|
"additionalProperties": false,
|
|
2307
|
-
"required": [
|
|
2308
|
-
"searches"
|
|
2309
|
-
],
|
|
2107
|
+
"required": ["searches"],
|
|
2310
2108
|
"properties": {
|
|
2311
2109
|
"searches": {
|
|
2312
2110
|
"type": "array",
|
|
@@ -2315,11 +2113,7 @@
|
|
|
2315
2113
|
"title": "topSearch",
|
|
2316
2114
|
"type": "object",
|
|
2317
2115
|
"additionalProperties": false,
|
|
2318
|
-
"required": [
|
|
2319
|
-
"search",
|
|
2320
|
-
"count",
|
|
2321
|
-
"nbHits"
|
|
2322
|
-
],
|
|
2116
|
+
"required": ["search", "count", "nbHits"],
|
|
2323
2117
|
"properties": {
|
|
2324
2118
|
"search": {
|
|
2325
2119
|
"$ref": "#/components/schemas/search"
|
|
@@ -2381,10 +2175,7 @@
|
|
|
2381
2175
|
"description": "Range of positions in the search results, using the pattern `[start,end]`.\n\nFor positions 11 and up, click events are summed over the specified range.\n`-1` indicates the end of the list of search results.\n",
|
|
2382
2176
|
"minItems": 2,
|
|
2383
2177
|
"maxItems": 2,
|
|
2384
|
-
"example": [
|
|
2385
|
-
21,
|
|
2386
|
-
-1
|
|
2387
|
-
],
|
|
2178
|
+
"example": [21, -1],
|
|
2388
2179
|
"items": {
|
|
2389
2180
|
"type": "integer"
|
|
2390
2181
|
}
|
|
@@ -2439,9 +2230,7 @@
|
|
|
2439
2230
|
"type": "object",
|
|
2440
2231
|
"title": "Top searches with click analytics",
|
|
2441
2232
|
"additionalProperties": false,
|
|
2442
|
-
"required": [
|
|
2443
|
-
"searches"
|
|
2444
|
-
],
|
|
2233
|
+
"required": ["searches"],
|
|
2445
2234
|
"properties": {
|
|
2446
2235
|
"searches": {
|
|
2447
2236
|
"type": "array",
|
|
@@ -2571,9 +2360,7 @@
|
|
|
2571
2360
|
"type": "object",
|
|
2572
2361
|
"title": "Top searches with revenue analytics",
|
|
2573
2362
|
"additionalProperties": false,
|
|
2574
|
-
"required": [
|
|
2575
|
-
"searches"
|
|
2576
|
-
],
|
|
2363
|
+
"required": ["searches"],
|
|
2577
2364
|
"properties": {
|
|
2578
2365
|
"searches": {
|
|
2579
2366
|
"type": "array",
|
|
@@ -2716,9 +2503,7 @@
|
|
|
2716
2503
|
"type": "object",
|
|
2717
2504
|
"title": "Top search results",
|
|
2718
2505
|
"additionalProperties": false,
|
|
2719
|
-
"required": [
|
|
2720
|
-
"hits"
|
|
2721
|
-
],
|
|
2506
|
+
"required": ["hits"],
|
|
2722
2507
|
"properties": {
|
|
2723
2508
|
"hits": {
|
|
2724
2509
|
"type": "array",
|
|
@@ -2727,10 +2512,7 @@
|
|
|
2727
2512
|
"title": "topHit",
|
|
2728
2513
|
"type": "object",
|
|
2729
2514
|
"additionalProperties": false,
|
|
2730
|
-
"required": [
|
|
2731
|
-
"hit",
|
|
2732
|
-
"count"
|
|
2733
|
-
],
|
|
2515
|
+
"required": ["hit", "count"],
|
|
2734
2516
|
"properties": {
|
|
2735
2517
|
"hit": {
|
|
2736
2518
|
"$ref": "#/components/schemas/hit"
|
|
@@ -2747,9 +2529,7 @@
|
|
|
2747
2529
|
"type": "object",
|
|
2748
2530
|
"title": "Top search results with click analytics",
|
|
2749
2531
|
"additionalProperties": false,
|
|
2750
|
-
"required": [
|
|
2751
|
-
"hits"
|
|
2752
|
-
],
|
|
2532
|
+
"required": ["hits"],
|
|
2753
2533
|
"properties": {
|
|
2754
2534
|
"hits": {
|
|
2755
2535
|
"type": "array",
|
|
@@ -2798,9 +2578,7 @@
|
|
|
2798
2578
|
"type": "object",
|
|
2799
2579
|
"title": "Top search results with revenue analytics",
|
|
2800
2580
|
"additionalProperties": false,
|
|
2801
|
-
"required": [
|
|
2802
|
-
"hits"
|
|
2803
|
-
],
|
|
2581
|
+
"required": ["hits"],
|
|
2804
2582
|
"properties": {
|
|
2805
2583
|
"hits": {
|
|
2806
2584
|
"type": "array",
|
|
@@ -2886,10 +2664,7 @@
|
|
|
2886
2664
|
"getTopFilterAttribute": {
|
|
2887
2665
|
"type": "object",
|
|
2888
2666
|
"additionalProperties": false,
|
|
2889
|
-
"required": [
|
|
2890
|
-
"attribute",
|
|
2891
|
-
"count"
|
|
2892
|
-
],
|
|
2667
|
+
"required": ["attribute", "count"],
|
|
2893
2668
|
"properties": {
|
|
2894
2669
|
"attribute": {
|
|
2895
2670
|
"$ref": "#/components/schemas/attribute"
|
|
@@ -2902,9 +2677,7 @@
|
|
|
2902
2677
|
"getTopFilterAttributesResponse": {
|
|
2903
2678
|
"type": "object",
|
|
2904
2679
|
"additionalProperties": false,
|
|
2905
|
-
"required": [
|
|
2906
|
-
"attributes"
|
|
2907
|
-
],
|
|
2680
|
+
"required": ["attributes"],
|
|
2908
2681
|
"properties": {
|
|
2909
2682
|
"attributes": {
|
|
2910
2683
|
"type": "array",
|
|
@@ -2918,15 +2691,7 @@
|
|
|
2918
2691
|
"operator": {
|
|
2919
2692
|
"description": "Character that characterizes how the filter is applied.\n\nFor example, for a facet filter `facet:value`, `:` is the operator.\nFor a numeric filter `count>50`, `>` is the operator.\n",
|
|
2920
2693
|
"type": "string",
|
|
2921
|
-
"enum": [
|
|
2922
|
-
":",
|
|
2923
|
-
"<",
|
|
2924
|
-
"<=",
|
|
2925
|
-
"=",
|
|
2926
|
-
"!=",
|
|
2927
|
-
">",
|
|
2928
|
-
">="
|
|
2929
|
-
],
|
|
2694
|
+
"enum": [":", "<", "<=", "=", "!=", ">", ">="],
|
|
2930
2695
|
"example": ":"
|
|
2931
2696
|
},
|
|
2932
2697
|
"value": {
|
|
@@ -2937,12 +2702,7 @@
|
|
|
2937
2702
|
"getTopFilterForAttribute": {
|
|
2938
2703
|
"type": "object",
|
|
2939
2704
|
"additionalProperties": false,
|
|
2940
|
-
"required": [
|
|
2941
|
-
"operator",
|
|
2942
|
-
"attribute",
|
|
2943
|
-
"value",
|
|
2944
|
-
"count"
|
|
2945
|
-
],
|
|
2705
|
+
"required": ["operator", "attribute", "value", "count"],
|
|
2946
2706
|
"properties": {
|
|
2947
2707
|
"attribute": {
|
|
2948
2708
|
"$ref": "#/components/schemas/attribute"
|
|
@@ -2961,9 +2721,7 @@
|
|
|
2961
2721
|
"getTopFilterForAttributeResponse": {
|
|
2962
2722
|
"type": "object",
|
|
2963
2723
|
"additionalProperties": false,
|
|
2964
|
-
"required": [
|
|
2965
|
-
"values"
|
|
2966
|
-
],
|
|
2724
|
+
"required": ["values"],
|
|
2967
2725
|
"properties": {
|
|
2968
2726
|
"values": {
|
|
2969
2727
|
"type": "array",
|
|
@@ -2977,11 +2735,7 @@
|
|
|
2977
2735
|
"getTopFiltersNoResultsValue": {
|
|
2978
2736
|
"type": "object",
|
|
2979
2737
|
"additionalProperties": false,
|
|
2980
|
-
"required": [
|
|
2981
|
-
"attribute",
|
|
2982
|
-
"operator",
|
|
2983
|
-
"value"
|
|
2984
|
-
],
|
|
2738
|
+
"required": ["attribute", "operator", "value"],
|
|
2985
2739
|
"properties": {
|
|
2986
2740
|
"attribute": {
|
|
2987
2741
|
"$ref": "#/components/schemas/attribute"
|
|
@@ -2997,10 +2751,7 @@
|
|
|
2997
2751
|
"getTopFiltersNoResultsValues": {
|
|
2998
2752
|
"type": "object",
|
|
2999
2753
|
"additionalProperties": false,
|
|
3000
|
-
"required": [
|
|
3001
|
-
"values",
|
|
3002
|
-
"count"
|
|
3003
|
-
],
|
|
2754
|
+
"required": ["values", "count"],
|
|
3004
2755
|
"properties": {
|
|
3005
2756
|
"count": {
|
|
3006
2757
|
"$ref": "#/components/schemas/parameters_count"
|
|
@@ -3017,9 +2768,7 @@
|
|
|
3017
2768
|
"getTopFiltersNoResultsResponse": {
|
|
3018
2769
|
"type": "object",
|
|
3019
2770
|
"additionalProperties": false,
|
|
3020
|
-
"required": [
|
|
3021
|
-
"values"
|
|
3022
|
-
],
|
|
2771
|
+
"required": ["values"],
|
|
3023
2772
|
"properties": {
|
|
3024
2773
|
"values": {
|
|
3025
2774
|
"oneOf": [
|
|
@@ -3120,19 +2869,11 @@
|
|
|
3120
2869
|
"x-tagGroups": [
|
|
3121
2870
|
{
|
|
3122
2871
|
"name": "Metrics",
|
|
3123
|
-
"tags": [
|
|
3124
|
-
"search",
|
|
3125
|
-
"click",
|
|
3126
|
-
"revenue",
|
|
3127
|
-
"filter",
|
|
3128
|
-
"user"
|
|
3129
|
-
]
|
|
2872
|
+
"tags": ["search", "click", "revenue", "filter", "user"]
|
|
3130
2873
|
},
|
|
3131
2874
|
{
|
|
3132
2875
|
"name": "Other",
|
|
3133
|
-
"tags": [
|
|
3134
|
-
"status"
|
|
3135
|
-
]
|
|
2876
|
+
"tags": ["status"]
|
|
3136
2877
|
}
|
|
3137
2878
|
]
|
|
3138
|
-
}
|
|
2879
|
+
}
|