API Reference / API Methods

API Methods

Personalization

Add strategy setPersonalizationStrategy setPersonalizationStrategy setPersonalizationStrategy set_personalization_strategy set_personalization_strategy SetPersonalizationStrategy setPersonalizationStrategy SetPersonalizationStrategy set personalizationStrategy Add strategy setPersonalizationStrategy	Set a personalization strategy.
Get strategy getPersonalizationStrategy getPersonalizationStrategy getPersonalizationStrategy get_personalization_strategy get_personalization_strategy GetPersonalizationStrategy getPersonalizationStrategy GetPersonalizationStrategy Get strategy getPersonalizationStrategy get personalizationStrategy	Get the personalization strategy.

Search

Search index search search search search search Search Search searchAsync Search search search	Method used for querying an index.
Search for facet values searchForFacetValues searchForFacetValues searchForFacetValues search_for_facet_values search_for_facet_values SearchForFacetValues searchForFacetValues searchForFacetValues SearchForFacetValues searchForFacetValues search into facet values	Search for a set of values within a given facet attribute. Can be combined with a query.
Search multiple indices multipleQueries multipleQueries multipleQueries multiple_queries multiple_queries MultipleQueries multipleQueries multipleQueriesAsync MultipleQueries multipleQueries multiQueries	Perform a search on several indices at the same time, with one method call.
Find Object findObject findObject findObject find_object find_object FindObject findObject FindObject Find Object findObject findObject	Find an object by the given condition. Can be used to debug relevance.
Get Object Position getObjectPosition getObjectPosition getObjectPosition get_object_position get_object_position getObjectPosition getObjectPosition getObjectPosition Get Object Position Get Object Position getObjectPosition	Retrieve the given object’s position in the given results set. Can be used to debug relevance.
Find answers findAnswers findAnswers findAnswers find_answers find_answers FindAnswers findAnswers FindAnswers findAnswers Find answers findAnswers	Search your index with natural-language understanding (NLU) AI using Algolia Answers.

Indexing

Add objects addObjects saveObjects saveObjects save_objects save_objects AddObjects addObjects addObjectsAsync SaveObjects addObjects index into	Add new objects to an index.
Save objects replaceObject saveObjects saveObjects save_objects save_objects SaveObjects saveObjects saveObjectsAsync SaveObjects saveObjects index into	Replace an existing object with an updated set of attributes.
Partial update objects partialUpdateObject partialUpdateObjects partialUpdateObjects partial_update_objects partial_update_objects PartialUpdateObjects PartialUpdateObjects partialUpdateObjectsAsync PartialUpdateObjects partialUpdateObjects partialUpdate objects	Update one or more attributes of an existing object.
Delete objects deleteObject deleteObjects deleteObjects delete_objects delete_objects DeleteObjects deleteObjects deleteObjectsAsync DeleteObjects deleteObjects delete objectIds	Remove objects from an index using their `objectID`.
Replace all objects replaceAllObjects replaceAllObjects replaceAllObjects replace_all_objects replace_all_objects ReplaceAllObjects replaceAllObjects Replace all objects ReplaceAllObjects replaceAllObjects Replace all objects	Clears all objects from your index and replaces them with a new set of objects.
Delete by deleteObjectBy deleteBy deleteBy delete_by delete_by DeleteBy deleteBy deleteByAsync DeleteBy deleteBy delete by	Remove all objects matching a filter (including geo filters).
Clear objects clearIndex clearObjects clearObjects clear_objects clear_objects ClearObjects clear clearIndexAsync ClearObjects clearIndex clear index	Clear the records of an index without affecting its settings.
Get objects getObject getObjects getObjects get_objects get_objects GetObjects getObjects getObjectsAsync GetObjects getObjects get from "index"	Get one or more objects using their `objectID`s.
Custom batch multipleBatchObjects multipleBatch batch multiple_batch batch MultipleBatch batch batchAsync Batch batch batch	Perform several indexing operations in one API call.

Settings

Get settings getSettings getSettings getSettings get_settings get_settings GetSettings getSettings getSettingsAsync GetSettings getSettings settings	Get the settings of an index.
Set settings setSettings setSettings setSettings set_settings set_settings SetSettings setSettings setSettingsAsync SetSettings setSettings setSettings	Create or change an index’s settings.
Copy settings copySettings copySettings copySettings copy_settings copy_settings CopySettings Copy settings Copy settings CopySettings copy Copy settings	Copy the settings of an index to another index on the same app.

Manage indices

List indices listIndices listIndices listIndices list_indices list_indexes ListIndices listIndexes listIndexesAsync ListIndices listIndexes list indexes	Get a list of indices with their associated metadata.
Delete index deleteIndex delete delete delete delete_index Delete deleteIndex deleteIndexAsync Delete delete delete index	Delete an index and all its settings, including links to its replicas.
Copy index copyIndex copyIndex copyIndex copy_index copy_index CopyIndex copyIndex copyIndexAsync CopyIndex copyIndex copy index	Make a copy of an index, including its records, settings, Synonyms, and Rules.
Browse index browseObjects browseObjects browseObjects browse_objects browse_objects Browse browse browseAsync BrowseObjects browse browse index	Get all index content without any record limit. Can be used for backups.
Move index moveIndex moveIndex moveIndex move_index move_index MoveIndex moveIndex moveIndexAsync MoveIndex moveIndex move index	Rename an index. Normally used to reindex your data atomically, without any down time.
Index exists Index exists Index exists exists Index exists Index exists Index exists Index exists Index exists Index exists Index exists Index exists	Returns whether an index exists or not.

API keys

Create secured API Key generateSecuredApiKey generateSecuredApiKey generateSecuredApiKey generate_secured_api_key generate_secured_api_key GenerateSecuredApiKey generateSecuredApiKey GenerateSecuredAPIKey Create secured API Key generateSecuredApiKey generateSecuredApiKey	Generate a secured API key without any call to our servers.
Add API Key addApiKey addApiKey addApiKey add_api_key add_api_key AddApiKey addApiKey AddAPIKey Add API Key addAPIKey add key	Add a new API Key with specific permissions/restrictions.
Update API Key updateApiKey updateApiKey updateApiKey update_api_key update_api_key UpdateApiKey updateApiKey UpdateAPIKey Update API Key updateAPIKey update key	Replace the permissions of an existing API Key.
Delete API Key deleteApiKey deleteApiKey deleteApiKey delete_api_key delete_api_key DeleteApiKey deleteApiKey DeleteAPIKey Delete API Key deleteAPIKey delete key	Delete an existing API Key.
Restore API Key restoreApiKey restoreApiKey restoreApiKey restore_api_key restore_api_key RestoreApiKey restoreApiKey RestoreAPIKey Restore API Key restoreAPIKey restore key	Restore a deleted API key, along with its associated rights.
Get API Key permissions getApiKey getApiKey getApiKey get_api_key get_api_key GetApiKey getApiKey GetAPIKey Get API Key permissions getAPIKey get key	Get the permissions of an API key. When initializing the client using the Admin API key, you can request information on any of your application’s API keys. When using a non-admin API key, you can only retrieve information on this specific API key.
List API Keys listApiKeys listApiKeys listApiKeys list_api_keys list_api_keys ListApiKeys listApiKeys ListAPIKeys List API Keys listAPIKeys list keys	Get the full list of API Keys.
Get secured API key remaining validity Get secured API key remaining validity Get secured API key remaining validity getSecuredApiKeyRemainingValidity Get secured API key remaining validity get_secured_api_key_remaining_validity Get secured API key remaining validity Get secured API key remaining validity Get secured API key remaining validity Get secured API key remaining validity getSecuredApiKeyRemainingValidity Get secured API key remaining validity	Retrieve the remaining validity of a secured API key in seconds.

Synonyms

Save synonym saveSynonym saveSynonym saveSynonym save_synonym save_synonym saveSynonym saveSynonym SaveSynonym Save synonym saveSynonym save synonym	Create or update a single synonym on an index.
Batch synonyms saveSynonyms saveSynonyms saveSynonyms save_synonyms save_synonyms SaveSynonyms saveSyonyms SaveSynonyms Batch synonyms saveSynonyms save synonyms	Create or update multiple synonyms.
Delete synonym deleteSynonym deleteSynonym deleteSynonym delete_synonym delete_synonym DeleteSynonym deleteSynonym DeleteSynonym Delete synonym deleteSynonym delete synonym	Remove a single synonym from an index using its object id.
Clear all synonyms clearSynonyms clearSynonyms clearSynonyms clear_synonyms clear_synonyms ClearSynonyms clearSynonyms ClearSynonyms Clear all synonyms clearSynonyms clear synonyms	Remove all synonyms from an index.
Get synonym getSynonym getSynonym getSynonym get_synonym get_synonym GetSynonym getSynonym GetSynonym Get synonym getSynonym get synonym	Get a single synonym using its object id.
Search synonyms searchSynonyms searchSynonyms searchSynonyms search_synonyms search_synonyms SearchSynonyms searchSynonyms SearchSynonyms Search synonyms searchSynonyms search synonyms	Get all synonyms that match a query.
Replace all synonyms replaceAllSynonyms replaceAllSynonyms replaceAllSynonyms replace_all_synonyms replace_all_synonyms ReplaceAllSynonyms replaceAllSynonyms Replace all synonyms ReplaceAllSynonyms replaceAllSynonyms Replace all synonyms	Push a new set of synonyms and erase all previous ones.
Copy synonyms copySynonyms copySynonyms copySynonyms copy_synonyms copy_synonyms CopySynonyms Copy synonyms Copy synonyms CopySynonyms copy Copy synonyms	Copy the synonyms of an index to another index on the same app.
Export Synonyms browseSynonyms browseSynonyms browseSynonyms index.browse_synonyms() browse_synonyms BrowseSynonyms SynonymsIterable BrowseSynonyms Export Synonyms browseSynonyms exportSynonyms	Retrieve an index’s complete list of synonyms.

Rules

Save rule saveRule saveRule saveRule save_rule save_rule SaveRule saveRule SaveRule Save rule saveRule save rule	Create or update a single Rule.
Batch Rules saveRules saveRules saveRules save_rules save_rules SaveRules saveRules SaveRules Batch Rules saveRules save rules	Create or update a specified set of Rules, or all Rules.
Get Rule getRule getRule getRule get_rule get_rule GetRule getRule GetRule Get Rule getRule get rule	Get the object/definition of a specific Rule.
Delete Rule deleteRule deleteRule deleteRule delete_rule delete_rule DeleteRule deleteRule DeleteRule Delete Rule deleteRule delete rule	Delete a specific Rule using its id.
Clear Rules clearRules clearRules clearRules clear_rules clear_rules ClearRules clearRules ClearRules Clear Rules clearRules clear Rules of index	Delete all Rules in an index.
Search rules searchRules searchRules searchRules search_rules search_rules SearchRules searchRules SearchRules Search rules searchRules search rules	Search for rules matching various criteria.
Replace all rules replaceAllRules replaceAllRules replaceAllRules replace_all_rules replace_all_rules ReplaceAllRules replaceAllRules Replace all rules ReplaceAllRules replaceAllRules Replace all rules	Push a new set of rules and erase all previous ones.
Copy rules copyRules copyRules copyRules copy_rules copy_rules CopyRules copyRules Copy rules CopyRules copy Copy rules	Copy the rules of an index to another index on the same app.
Export Rules browseRules browseRules browseRules index.browse_rules() browse_rules BrowseRules RulesIterable BrowseRules Export Rules browseRules exportRules	Retrieve an index’s full list of Rules using an iterator.

A/B Test

Add A/B test addABTest addABTest addABTest add_ab_test add_ab_test AddABTest addABTest AddABTest Add A/B test addABTest add abTest	Create an A/B test.
Get A/B test getABTest getABTest getABTest get_ab_test get_ab_test GetABTest getABTest GetABTest Get A/B test getABTest get abTest	Get an A/B test information and results.
List A/B tests getABTests getABTests getABTests get_ab_tests get_ab_tests GetABTests getABTests GetABTests List A/B tests List A/B tests get all abTests	List A/B tests information and results.
Stop A/B test stopABTest stopABTest stopABTest stop_ab_test stop_ab_test StopABTest stopABTest StopABTest Stop A/B test stopABTest stop abTest	Stop an A/B test
Delete A/B test deleteABTest deleteABTest deleteABTest delete_ab_test delete_ab_test DeleteABTest deleteABTest DeleteABTest Delete A/B test deleteABTest delete abTest	Delete an A/B test

Insights

Clicked Object IDs After Search clickedObjectIDsAfterSearch clickedObjectIDsAfterSearch clickedObjectIDsAfterSearch clicked_object_ids_after_search clicked_object_ids_after_search ClickedObjectIDsAfterSearch clickedObjectIDsAfterSearch ClickedObjectIDsAfterSearch clickedAfterSearch clickedAfterSearch send event ClickedObjectIDsAfterSearch	Send a click event to capture a query and its clicked items and positions.
Clicked Object IDs clickedObjectIDs clickedObjectIDs clickedObjectIDs clicked_object_ids clicked_object_ids ClickedObjectIDs clickedObjectIDs ClickedObjectIDs clicked clicked send event ClickedObjectIDs	Send a click event to capture clicked items.
Clicked Filters clickedFilters clickedFilters clickedFilters clicked_filters clicked_filters ClickedFilters clickedFilters ClickedFilters clicked clicked send event ClickedFilters	Send a click event to capture the filters a user clicks on.
Converted Object IDs After Search convertedObjectIDsAfterSearch convertedObjectIDsAfterSearch convertedObjectIDs converted_object_ids_after_search converted_object_ids_after_search ConvertedObjectIDsAfterSearch convertedObjectIDsAfterSearch ConvertedObjectIDsAfterSearch convertedAfterSearch convertedAfterSearch send event ConvertedObjectIDsAfterSearch	Send a conversion event to capture a query and its clicked items.
Converted Object IDs convertedObjectIDs convertedObjectIDs convertedObjectIDs converted_object_ids converted_object_ids ConvertedObjectIDs convertedObjectIDs ConvertedObjectIDs converted converted send event ConvertedObjectIDs	Send a conversion event to capture clicked items.
Converted Filters convertedFilters convertedFilters convertedFilters converted_filters converted_filters ConvertedFilters convertedFilters ConvertedFilters converted converted send event ConvertedFilters	Send a conversion event to capture the filters a user uses when converting.
Viewed Object IDs viewedObjectIDs viewedObjectIDs viewedObjectIDs viewed_object_ids viewed_object_ids ViewedObjectIDs viewedObjectIDs ViewedObjectIDs viewed Viewed Object IDs send event ViewedObjectIDs	Send a view event to capture clicked items.
Viewed Filters viewedFilters viewedFilters viewedFilters viewed_filters viewed_filters ViewedFilters viewedFilters ViewedFilters viewed viewed send event ViewedFilters	Send a view event to capture the filters a user uses when viewing.
Send Events sendEvents sendEvents sendEvents send_events send_events SendEvents sendEvents SendEvents sendEvents sendEvents send events	Send a batch of events.

Dictionaries

Save dictionary entries saveDictionaryEntries saveDictionaryEntries saveDictionaryEntries save_dictionary_entries save_dictionary_entries SaveDictionaryEntries saveDictionaryEntries SaveDictionaryEntries Save dictionary entries saveDictionaryEntries save dictionary entries	Send a batch of dictionary entries.
Replace dictionary entries replaceDictionaryEntries replaceDictionaryEntries replaceDictionaryEntries replace_dictionary_entries replace_dictionary_entries ReplaceDictionaryEntries replaceDictionaryEntries ReplaceDictionaryEntries Replace dictionary entries replaceDictionaryEntries replaceDictionaryEntries	Replace a batch of dictionary entries.
Delete dictionary entries deleteDictionaryEntries deleteDictionaryEntries deleteDictionaryEntries delete_dictionary_entries delete_dictionary_entries DeleteDictionaryEntries deleteDictionaryEntries DeleteDictionaryEntries Delete dictionary entries deleteDictionaryEntries deleteDictionaryEntries	Delete a batch of dictionary entries.
Clear dictionary entries clearDictionaryEntries clearDictionaryEntries clearDictionaryEntries clear_dictionary_entries clear_dictionary_entries ClearDictionaryEntries clearDictionaryEntries ClearDictionaryEntries Clear dictionary entries clearDictionaryEntries clearDictionaryEntries	Clear all entries in a given dictionary
Search dictionary entries searchDictionaryEntries searchDictionaryEntries searchDictionaryEntries search_dictionary_entries search_dictionary_entries SearchDictionaryEntries searchDictionaryEntries SearchDictionaryEntries Search dictionary entries searchDictionaryEntries searchDictionaryEntries	Search for entries in a given dictionary
Set dictionary settings setDictionarySettings setDictionarySettings setDictionarySettings set_dictionary_settings set_dictionary_settings SetDictionarySettings setDictionarySettings SetDictionarySettings Set dictionary settings setDictionarySettings setDictionarySettings	Set dictionary settings.
Get dictionary settings getDictionarySettings getDictionarySettings getDictionarySettings get_dictionary_settings get_dictionary_settings GetDictionarySettings getDictionarySettings GetDictionarySettings Get dictionary settings getDictionarySettings getDictionarySettings	Retrieve dictionaries settings.

MultiClusters

Assign or Move userID assignUserID assignUserID assignUserId assign_user_ids assign_user_id AssignUserID assignUserId AssignUserID Assign or Move userID assignUser Assign or Move userID	Assign or Move a userID to a cluster.
Get top userID getTopUserID getTopUserIDs getTopUserIds get_top_user_ids get_top_user_id GetTopUserID getTopUserId GetTopUserIDs Get top userID getTopUser Get top userID	Get the top 10 userIDs with the highest number of records per cluster.
Get userID getUserID getUserID getUserId get_user_id get_user_id GetUserID getUserId GetUserID Get userID getUser Get userID	Returns the userID data stored in the mapping.
List clusters listClusters listClusters listClusters list_clusters list_clusters ListClusters listClusters ListClusters List clusters listClusters List clusters	List the clusters available in a multi-clusters setup for a single appID.
List userIDs listUserIDs listUserIDs listUserIDs list_user_ids list_user_ids ListUserIDs listUserIDs ListUserIDs List userIDs listUsers List userIDs	List the userIDs assigned to a multi-clusters appID.
Remove userID removeUserID removeUserID removeUserId remove_user_id remove_user_id RemoveUserID removeUserID RemoveUserID Remove userID removeUser Remove userID	Remove a userID and its associated data from the multi-clusters.
Search userID searchUserIDs searchUserIDs searchUserIds SearchUserIds search_user_ids search_user_ids Search userID SearchUserIds Search userID searchUser Search userID	Search for userIDs.
Batch assign userIDs Batch assign userIDs assignUserIDs Batch assign userIDs Batch assign userIDs Batch assign userIDs Batch assign userIDs Batch assign userIDs Batch assign userIDs Batch assign userIDs assignUsers Batch assign userIDs	Assign multiple userIDs to a cluster.
Has pending mappings hasPendingMapping hasPendingMappings Has pending mappings has_pending_mappings Has pending mappings Has pending mappings Has pending mappings Has pending mappings Has pending mappings Has pending mappings Has pending mappings	Get the status of your clusters’ migrations or user creations.

Advanced

Get logs getLogs getLogs getLogs get_logs get_logs GetLogs getLogs GetLogs Get logs getLogs logs	Get the logs of the latest search and indexing operations.
Configuring timeouts setTimeouts timeouts setTimeout timeout connect_timeout setTimeout setConnectTimeout setConnectTimeout timeout SetTimeout AlgoliaClientConfiguration	Override the pre-configured timeouts.
Set extra header setExtraHeader headers setDefaultHeaders headers set_extra_header SetExtraHeader addExtraHeader setHeader setHeader SetExtraHeader customHeader	Sends an extra http header to Algolia, for all subsequent queries.
Wait for operations waitTask waitTask wait wait wait Wait waitTask WaitTask WaitTask waitTask waitFor task	Wait for a task to complete before executing the next line of code, to synchronize index updates.

Did you find this page helpful?