API Methods
Personalization
Add strategy |
Set a personalization strategy. |
Get strategy |
Get the personalization strategy. |
Recommend
Get frequently bought together |
Retrieve frequently bought together items for a set of |
Get related products |
Retrieve related products or related content for a set of |
Get trending global items |
Retrieve globally trending items. |
Get trending items for facet |
Retrieve trending items for a specific facet. |
Get trending facets |
Retrieve trending facet values for a specific facet attribute. |
Get recommendations |
Retrieve recommendations. |
Search
Search index |
Method used for querying an index. |
Search for facet values |
Search for a set of values within a given facet attribute. Can be combined with a query. |
Search multiple indices |
Perform a search on several indices at the same time, with one method call. |
Find Object |
Find an object by the given condition. Can be used to debug relevance. |
Get Object Position |
Retrieve the given object’s position in the given results set. Can be used to debug relevance. |
Indexing
Save objects |
Add new objects to an index or replace existing objects with an updated set of attributes. |
Partial update objects |
Update one or more attributes of an existing object. |
Delete objects |
Remove objects from an index using their |
Replace all objects |
Clears all objects from your index and replaces them with a new set of objects. |
Delete by |
Remove all objects matching a filter (including geo filters). |
Clear objects |
Clear the records of an index without affecting its settings. |
Get objects |
Get one or more objects using their |
Custom batch |
Perform several indexing operations in one API call. |
Settings
Get settings |
Get the settings of an index. |
Set settings |
Create or change an index’s settings. |
Copy settings |
Copy the settings of an index to another index on the same app. |
Manage indices
List indices |
Get a list of indices with their associated metadata. |
Delete index |
Delete an index and all its settings, including links to its replicas. |
Copy index |
Make a copy of an index, including its records, settings, Synonyms, and Rules except for the enableReRanking setting. |
Browse index |
Get all index content without any record limit. Can be used for backups. |
Move index |
Renames an index. This is used internally to reindex your data without any downtime. |
Index exists |
Returns whether an index exists or not. |
API keys
Create secured API Key |
Generate a secured API key without any call to our servers. |
Add API Key |
Add a new API Key with specific permissions/restrictions. |
Update API Key |
Replace every permission of an existing API key. Any unspecified field resets that permission to its default value. |
Delete API Key |
Delete an existing API Key. |
Restore API Key |
Restore a deleted API key, along with its associated rights. |
Get API Key permissions |
Get the permissions of an API key. When initializing the client using the admin API key, you can request information for any of your application’s API keys. When using a non-admin API key, you can only retrieve information for this specific API key. |
List API Keys |
Get the full list of API Keys. |
Get secured API key remaining validity |
Retrieve the remaining validity of a secured API key in seconds. |
Synonyms
Save synonym |
Create or update a single synonym on an index. |
Save synonyms |
Create or update multiple synonyms. |
Delete synonym |
Remove a single synonym from an index using its object id. |
Clear all synonyms |
Remove all synonyms from an index. |
Get synonym |
Get a single synonym using its object id. |
Search synonyms |
Get all synonyms that match a query. |
Replace all synonyms |
Push a new set of synonyms and erase all previous ones. |
Copy synonyms |
Copy the synonyms of an index to another index on the same app. |
Export Synonyms |
Retrieve an index’s complete list of synonyms. |
Rules
Save rule |
Create or update a single Rule. |
Batch Rules |
Create or update a specified set of Rules, or all Rules. |
Get Rule |
Get the object/definition of a specific Rule. |
Delete Rule |
Delete a specific Rule using its id. |
Clear Rules |
Delete all Rules in an index. |
Search rules |
Search for rules matching various criteria. |
Replace all rules |
Push a new set of rules and erase all previous ones. |
Copy rules |
Copy the rules of an index to another index on the same app. |
Export Rules |
Retrieve an index’s full list of Rules using an iterator. |
A/B Test
Add A/B test |
Create an A/B test. |
Get A/B test |
Get an A/B test information and results. |
List A/B tests |
List A/B tests information and results. |
Stop A/B test |
Stop an A/B test |
Delete A/B test |
Delete an A/B test |
Insights
Clicked Object IDs After Search |
Send a click event to capture a query and its clicked items and positions. |
Clicked Object IDs |
Send a click event to capture clicked items. |
Clicked Filters |
Send a click event to capture the filters a user clicks on. You can’t send these events for numeric filters. |
Converted Object IDs After Search |
Send a conversion event to capture a query and its clicked items. |
Converted Object IDs |
Send a conversion event to capture clicked items. |
Converted Filters |
Send a conversion event to capture the filters a user uses when converting. |
Viewed Object IDs |
Send a view event to capture viewed items. |
Viewed Filters |
A user browsing on a category page usually sees content filtered on that specific category. However, they haven’t clicked on or interacted with that filter. In scenarios where a user sees filtered content without interacting with that filter, you send view events. Sending a view event captures the filters a user sees when viewing filtered content without having actively filtered it. |
Send Events |
Send a batch of events. |
Dictionaries
Save dictionary entries |
Send a batch of entries to a dictionary. |
Replace dictionary entries |
Replace a batch of dictionary entries. |
Delete dictionary entries |
Delete a batch of dictionary entries. |
Clear dictionary entries |
Remove all words from a custom dictionary. |
Search dictionary entries |
Search for entries in a dictionary. |
Set dictionary settings |
Enable or disable the use of standard dictionary entries |
Get dictionary settings |
Retrieve the dictionary override settings for plurals, stop words, and compound words. |
MultiClusters
Assign or Move userID |
Assign or Move a userID to a cluster. |
Get top userID |
Get the top 10 userIDs with the highest number of records per cluster. |
Get userID |
Returns the userID data stored in the mapping. |
List clusters |
List the clusters available in a multi-clusters setup for a single appID. |
List userIDs |
List the userIDs assigned to a multi-clusters appID. |
Remove userID |
Remove a userID and its associated data from the multi-clusters. |
Search userID |
Search for userIDs. |
Batch assign userIDs |
Assign multiple userIDs to a cluster. |
Has pending mappings |
Get the status of your clusters’ migrations or user creations. |
Advanced
Get logs |
Get the logs of the latest search and indexing operations. |
Configuring timeouts |
Override the pre-configured timeouts. |
Set extra header |
Send an extra HTTP header to Algolia for use with later queries. |
Wait for operations |
Wait for a task to complete before executing the next line of code, to synchronize index updates. |
Custom request |
Perform a custom request |