algoliasearch.search
Members list
Type members
Classlikes
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
object AddObject.typeobject Analytics.typeobject Browse.typeobject DeleteIndex.typeobject DeleteObject.typeobject EditSettings.typeobject Inference.typeobject ListIndexes.typeobject Logs.typeobject Personalization.typeobject Recommendation.typeobject Search.typeobject SeeUnretrievableAttributes.typeobject Settings.typeobject Usage.typeShow all
API key permissions: addObject
: required to add or update records, copy or move an index. analytics
: required to access the Analytics API. browse
: required to view records deleteIndex
: required to delete indices. deleteObject
: required to delete records. editSettings
: required to change index settings. inference
: required to access the Inference API. listIndexes
: required to list indices. logs
: required to access logs of search and indexing operations. recommendation
: required to access the Personalization and Recommend APIs. search
: required to search records seeUnretrievableAttributes
: required to retrieve unretrievableAttributes
for all operations that return records. settings
: required to examine index settings.
API key permissions: addObject
: required to add or update records, copy or move an index. analytics
: required to access the Analytics API. browse
: required to view records deleteIndex
: required to delete indices. deleteObject
: required to delete records. editSettings
: required to change index settings. inference
: required to access the Inference API. listIndexes
: required to list indices. logs
: required to access logs of search and indexing operations. recommendation
: required to access the Personalization and Recommend APIs. search
: required to search records seeUnretrievableAttributes
: required to retrieve unretrievableAttributes
for all operations that return records. settings
: required to examine index settings.
Attributes
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
object AddObject.typeobject Clear.typeobject Delete.typeobject DeleteObject.typeobject PartialUpdateObject.typeobject PartialUpdateObjectNoCreate.typeobject UpdateObject.typeShow all
AddApiKeyResponse
AddApiKeyResponse
Value parameters
- createdAt
-
Timestamp of creation in ISO-8601 format.
- key
-
API key.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
object ExactPhrase.typeobject ExcludeWords.type
AdvancedSyntaxFeatures enumeration
AdvancedSyntaxFeatures enumeration
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
Attributes
- Supertypes
-
class CustomSerializer[AdvancedSyntaxFeatures]trait Serializer[AdvancedSyntaxFeatures]class Objecttrait Matchableclass Any
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
AlternativesAsExact enumeration
AlternativesAsExact enumeration
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
AlternativesAsExact.type
Attributes
- Supertypes
-
class CustomSerializer[AlternativesAsExact]trait Serializer[AlternativesAsExact]class Objecttrait Matchableclass Any
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
Whether the pattern parameter matches the beginning (startsWith
) or end (endsWith
) of the query string, is an exact match (is
), or a partial match (contains
).
API key object.
API key object.
Value parameters
- acl
-
Permissions associated with the key.
- description
-
Description of an API key for you and your team members.
- indexes
-
Restricts this API key to a list of indices or index patterns. If the list is empty, all indices are allowed. Specify either an exact index name or a pattern with a leading or trailing wildcard character (or both). For example: -
dev_*
matches all indices starting with "dev_" -*_dev
matches all indices ending with "_dev" -*_products_*
matches all indices containing "products". - maxHitsPerQuery
-
Maximum number of hits this API key can retrieve in one query. If zero, no limit is enforced. > Note: Use this parameter to protect you from third-party attempts to retrieve your entire content by massively querying the index.
- maxQueriesPerIPPerHour
-
Maximum number of API calls per hour allowed from a given IP address or user token. Each time an API call is performed with this key, a check is performed. If there were more than the specified number of calls within the last hour, the API returns an error with the status code
429
(Too Many Requests). > Note: Use this parameter to protect you from third-party attempts to retrieve your entire content by massively querying the index. - queryParameters
-
Force some query parameters to be applied for each query made with this API key. It's a URL-encoded query string.
- referers
-
Restrict this API key to specific referrers. If empty, all referrers are allowed. For example: -
https://algolia.com/_*
matches all referrers starting with "https://algolia.com/" -*.algolia.com
matches all referrers ending with ".algolia.com" -*algolia.com*
allows everything in the domain "algolia.com". - validity
-
Validity duration of a key (in seconds). The key will automatically be removed after this time has expired. The default value of 0 never expires. Short-lived API keys are useful to grant temporary access to your data. For example, in mobile apps, you can't control when users update your app. So instead of encoding keys into your app as you would for a web app, you should dynamically fetch them from your mobile app's backend.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Precision of a geographical search (in meters), to group results that are more or less the same distance from a central point.
Precision of a geographical search (in meters), to group results that are more or less the same distance from a central point.
Attributes
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
AroundPrecision.type
AroundPrecisionFromValueInner
AroundPrecisionFromValueInner
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
- Self type
Maximum radius for a geographical search (in meters).
Maximum radius for a geographical search (in meters).
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
Attributes
- Companion
- trait
- Supertypes
-
class Objecttrait Matchableclass Any
- Self type
-
AroundRadius.type
Attributes
AroundRadiusAll enumeration
AroundRadiusAll enumeration
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
AroundRadiusAll.type
Attributes
- Supertypes
-
class CustomSerializer[AroundRadiusAll]trait Serializer[AroundRadiusAll]class Objecttrait Matchableclass Any
Attributes
- Supertypes
- Self type
Attributes
- Supertypes
- Known subtypes
-
trait AroundRadiusAllobject All.type
Assign userID parameters.
Assign userID parameters.
Value parameters
- cluster
-
Cluster name.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
AttributeToUpdate
AttributeToUpdate
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
Attributes
- Companion
- trait
- Supertypes
-
class Objecttrait Matchableclass Any
- Self type
-
AttributeToUpdate.type
Attributes
- Supertypes
- Self type
Attributes
- Supertypes
- Known subtypes
-
class BuiltInOperation
Automatic facet Filter.
Automatic facet Filter.
Value parameters
- disjunctive
-
Whether the filter is disjunctive (true) or conjunctive (false).
- facet
-
Attribute to filter on. This must match a facet placeholder in the Rule's pattern.
- score
-
Score for the filter. Typically used for optional or disjunctive filters.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Names of facets to which automatic filtering must be applied; they must match the facet name of a facet value placeholder in the query pattern.
Names of facets to which automatic filtering must be applied; they must match the facet name of a facet value placeholder in the query pattern.
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
class SeqOfString
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
object SeqOfAutomaticFacetFilterEvidence.typeobject SeqOfStringEvidence.type
Attributes
- Companion
- trait
- Supertypes
-
class Objecttrait Matchableclass Any
- Self type
Attributes
- Supertypes
- Self type
BaseGetApiKeyResponse
BaseGetApiKeyResponse
Value parameters
- createdAt
-
Timestamp of creation in milliseconds in Unix epoch time.
- value
-
API key.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
BaseIndexSettings
BaseIndexSettings
Value parameters
- allowCompressionOfIntegerArray
-
Incidates whether the engine compresses arrays with exclusively non-negative integers. When enabled, the compressed arrays may be reordered.
- attributeForDistinct
-
Name of the deduplication attribute to be used with Algolia's distinct feature.
- attributesToTransliterate
-
Attributes in your index to which Japanese transliteration applies. This will ensure that words indexed in Katakana or Kanji can also be searched in Hiragana.
- camelCaseAttributes
-
Attributes on which to split camel case words.
- customNormalization
-
A list of characters and their normalized replacements to override Algolia's default normalization.
- decompoundedAttributes
-
Attributes in your index to which word segmentation (decompounding) applies.
- disablePrefixOnAttributes
-
Attributes for which you want to turn off prefix matching.
- disableTypoToleranceOnWords
-
Words for which you want to turn off typo tolerance.
- indexLanguages
-
Set the languages of your index, for language-specific processing steps such as tokenization and normalization.
- numericAttributesForFiltering
-
Numeric attributes that can be used as numerical filters.
- paginationLimitedTo
-
Maximum number of hits accessible through pagination.
- replicas
-
Creates replicas, which are copies of a primary index with the same records but different settings.
- searchableAttributes
-
Attributes used for searching, including determining if matches at the beginning of a word are important (ordered) or not (unordered).
- separatorsToIndex
-
Controls which separators are added to an Algolia index as part of normalization. Separators are all non-letter characters except spaces and currency characters, such as $€£¥.
- unretrievableAttributes
-
Attributes that can't be retrieved at query time.
- userData
-
Lets you store custom data in your indices.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
BaseSearchParams
BaseSearchParams
Value parameters
- analytics
-
Indicates whether this query will be included in analytics.
- analyticsTags
-
Tags to apply to the query for segmenting analytics data.
- aroundLatLng
-
Search for entries around a central location, enabling a geographical search within a circular area.
- aroundLatLngViaIP
-
Search for entries around a location. The location is automatically computed from the requester's IP address.
- clickAnalytics
-
Indicates whether a query ID parameter is included in the search response. This is required for tracking click and conversion events.
- enableABTest
-
Incidates whether this search will be considered in A/B testing.
- explain
-
Enriches the API's response with information about how the query was processed.
- facetingAfterDistinct
-
Forces faceting to be applied after de-duplication (with the distinct feature). Alternatively, the
afterDistinct
modifier ofattributesForFaceting
allows for more granular control. - facets
-
Returns facets, their facet values, and the number of matching facet values.
- filters
-
Filter the query with numeric, facet, or tag filters.
- getRankingInfo
-
Incidates whether the search response includes detailed ranking information.
- insideBoundingBox
-
Search inside a rectangular area (in geographical coordinates).
- insidePolygon
-
Search inside a polygon (in geographical coordinates).
- length
-
Sets the number of hits to retrieve (for use with
offset
). > Note: Usingpage
andhitsPerPage
is the recommended method for paging results. However, you can useoffset
andlength
to implement an alternative approach to paging. - minimumAroundRadius
-
Minimum radius (in meters) used for a geographical search when
aroundRadius
isn't set. - naturalLanguages
-
Changes the default values of parameters that work best for a natural language query, such as
ignorePlurals
,removeStopWords
,removeWordsIfNoResults
,analyticsTags
, andruleContexts
. These parameters work well together when the query consists of fuller natural language strings instead of keywords, for example when processing voice search queries. - offset
-
Specifies the offset of the first hit to return. > Note: Using
page
andhitsPerPage
is the recommended method for paging results. However, you can useoffset
andlength
to implement an alternative approach to paging. - page
-
Page to retrieve (the first page is
0
, not1
). - percentileComputation
-
Whether to include or exclude a query from the processing-time percentile computation.
- personalizationImpact
-
Defines how much Personalization affects results.
- query
-
Text to search for in an index.
- restrictSearchableAttributes
-
Restricts a query to only look at a subset of your searchable attributes.
- ruleContexts
-
Assigns rule contexts to search queries.
- similarQuery
-
Overrides the query parameter and performs a more generic search.
- sumOrFiltersScores
-
Determines how to calculate filter scores. If
false
, maximum score is kept. Iftrue
, score is summed. - synonyms
-
Whether to take into account an index's synonyms for a particular search.
- userToken
-
Associates a user token with the current search.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
BaseSearchParamsWithoutQuery
BaseSearchParamsWithoutQuery
Value parameters
- analytics
-
Indicates whether this query will be included in analytics.
- analyticsTags
-
Tags to apply to the query for segmenting analytics data.
- aroundLatLng
-
Search for entries around a central location, enabling a geographical search within a circular area.
- aroundLatLngViaIP
-
Search for entries around a location. The location is automatically computed from the requester's IP address.
- clickAnalytics
-
Indicates whether a query ID parameter is included in the search response. This is required for tracking click and conversion events.
- enableABTest
-
Incidates whether this search will be considered in A/B testing.
- explain
-
Enriches the API's response with information about how the query was processed.
- facetingAfterDistinct
-
Forces faceting to be applied after de-duplication (with the distinct feature). Alternatively, the
afterDistinct
modifier ofattributesForFaceting
allows for more granular control. - facets
-
Returns facets, their facet values, and the number of matching facet values.
- filters
-
Filter the query with numeric, facet, or tag filters.
- getRankingInfo
-
Incidates whether the search response includes detailed ranking information.
- insideBoundingBox
-
Search inside a rectangular area (in geographical coordinates).
- insidePolygon
-
Search inside a polygon (in geographical coordinates).
- length
-
Sets the number of hits to retrieve (for use with
offset
). > Note: Usingpage
andhitsPerPage
is the recommended method for paging results. However, you can useoffset
andlength
to implement an alternative approach to paging. - minimumAroundRadius
-
Minimum radius (in meters) used for a geographical search when
aroundRadius
isn't set. - naturalLanguages
-
Changes the default values of parameters that work best for a natural language query, such as
ignorePlurals
,removeStopWords
,removeWordsIfNoResults
,analyticsTags
, andruleContexts
. These parameters work well together when the query consists of fuller natural language strings instead of keywords, for example when processing voice search queries. - offset
-
Specifies the offset of the first hit to return. > Note: Using
page
andhitsPerPage
is the recommended method for paging results. However, you can useoffset
andlength
to implement an alternative approach to paging. - page
-
Page to retrieve (the first page is
0
, not1
). - percentileComputation
-
Whether to include or exclude a query from the processing-time percentile computation.
- personalizationImpact
-
Defines how much Personalization affects results.
- restrictSearchableAttributes
-
Restricts a query to only look at a subset of your searchable attributes.
- ruleContexts
-
Assigns rule contexts to search queries.
- similarQuery
-
Overrides the query parameter and performs a more generic search.
- sumOrFiltersScores
-
Determines how to calculate filter scores. If
false
, maximum score is kept. Iftrue
, score is summed. - synonyms
-
Whether to take into account an index's synonyms for a particular search.
- userToken
-
Associates a user token with the current search.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
BaseSearchResponse
BaseSearchResponse
Value parameters
- abTestID
-
A/B test ID. This is only included in the response for indices that are part of an A/B test.
- abTestVariantID
-
Variant ID. This is only included in the response for indices that are part of an A/B test.
- aroundLatLng
-
Computed geographical location.
- automaticRadius
-
Automatically-computed radius.
- exhaustiveFacetsCount
-
See the
facetsCount
field of theexhaustive
object in the response. - exhaustiveNbHits
-
See the
nbHits
field of theexhaustive
object in the response. - exhaustiveTypo
-
See the
typo
field of theexhaustive
object in the response. - facets
-
Mapping of each facet name to the corresponding facet counts.
- facetsStats
-
Statistics for numerical facets.
- hitsPerPage
-
Number of hits per page.
- index
-
Index name used for the query.
- indexUsed
-
Index name used for the query. During A/B testing, the targeted index isn't always the index used by the query.
- message
-
Warnings about the query.
- nbHits
-
Number of hits the search query matched.
- nbPages
-
Number of pages of results for the current query.
- nbSortedHits
-
Number of hits selected and sorted by the relevant sort algorithm.
- page
-
Page to retrieve (the first page is
0
, not1
). - parsedQuery
-
Post-normalization query string that will be searched.
- processingTimeMS
-
Time the server took to process the request, in milliseconds.
- processingTimingsMS
-
Experimental. List of processing steps and their times, in milliseconds. You can use this list to investigate performance issues.
- queryAfterRemoval
-
Markup text indicating which parts of the original query have been removed to retrieve a non-empty result set.
- serverTimeMS
-
Time the server took to process the request, in milliseconds.
- serverUsed
-
Host name of the server that processed the request.
- userData
-
Lets you store custom data in your indices.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
Assign userID parameters.
Assign userID parameters.
Value parameters
- cluster
-
Cluster name.
- users
-
User IDs to assign.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
batchDictionaryEntries
parameters.
batchDictionaryEntries
parameters.
Value parameters
- clearExistingDictionaryEntries
-
Incidates whether to replace all custom entries in the dictionary with the ones sent with this request.
- requests
-
Operations to batch.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
BatchDictionaryEntriesRequest
BatchDictionaryEntriesRequest
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Batch parameters.
Batch parameters.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
BatchRequest
BatchRequest
Value parameters
- body
-
Operation arguments (varies with specified
action
).
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
BatchResponse
BatchResponse
Value parameters
- objectIDs
-
Unique object (record) identifiers.
- taskID
-
Unique identifier of a task. A successful API response means that a task was added to a queue. It might not run immediately. You can check the task's progress with the
task
operation and thistaskID
.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Batch parameters.
Batch parameters.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
BrowseParams
BrowseParams
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
Attributes
- Companion
- trait
- Supertypes
-
class Objecttrait Matchableclass Any
- Self type
-
BrowseParams.type
BrowseParamsObject
BrowseParamsObject
Value parameters
- advancedSyntax
-
Enables the advanced query syntax.
- advancedSyntaxFeatures
-
Allows you to specify which advanced syntax features are active when
advancedSyntax
is enabled. - allowTyposOnNumericTokens
-
Whether to allow typos on numbers ("numeric tokens") in the query string.
- alternativesAsExact
-
Alternatives that should be considered an exact match by the exact ranking criterion.
- analytics
-
Indicates whether this query will be included in analytics.
- analyticsTags
-
Tags to apply to the query for segmenting analytics data.
- aroundLatLng
-
Search for entries around a central location, enabling a geographical search within a circular area.
- aroundLatLngViaIP
-
Search for entries around a location. The location is automatically computed from the requester's IP address.
- attributeCriteriaComputedByMinProximity
-
When the Attribute criterion is ranked above Proximity in your ranking formula, Proximity is used to select which searchable attribute is matched in the Attribute ranking stage.
- attributesForFaceting
-
Attributes used for faceting and the modifiers that can be applied:
filterOnly
,searchable
, andafterDistinct
. - attributesToHighlight
-
Attributes to highlight. Strings that match the search query in the attributes are highlighted by surrounding them with HTML tags (
highlightPreTag
andhighlightPostTag
). - attributesToRetrieve
-
Attributes to include in the API response. To reduce the size of your response, you can retrieve only some of the attributes. By default, the response includes all attributes.
- attributesToSnippet
-
Attributes to snippet. 'Snippeting' is shortening the attribute to a certain number of words. If not specified, the attribute is shortened to the 10 words around the matching string but you can specify the number. For example:
body:20
. - clickAnalytics
-
Indicates whether a query ID parameter is included in the search response. This is required for tracking click and conversion events.
- cursor
-
Cursor indicating the location to resume browsing from. Must match the value returned by the previous call. Pass this value to the subsequent browse call to get the next page of results. When the end of the index has been reached,
cursor
is absent from the response. - customRanking
-
Specifies the Custom ranking criterion. Use the
asc
anddesc
modifiers to specify the ranking order: ascending or descending. - decompoundQuery
-
Splits compound words into their component word parts in the query.
- disableExactOnAttributes
-
Attributes for which you want to turn off the exact ranking criterion.
- disableTypoToleranceOnAttributes
-
Attributes for which you want to turn off typo tolerance.
- enableABTest
-
Incidates whether this search will be considered in A/B testing.
- enablePersonalization
-
Incidates whether Personalization is enabled.
- enableReRanking
-
Indicates whether this search will use Dynamic Re-Ranking.
- enableRules
-
Incidates whether Rules are enabled.
- explain
-
Enriches the API's response with information about how the query was processed.
- facetingAfterDistinct
-
Forces faceting to be applied after de-duplication (with the distinct feature). Alternatively, the
afterDistinct
modifier ofattributesForFaceting
allows for more granular control. - facets
-
Returns facets, their facet values, and the number of matching facet values.
- filters
-
Filter the query with numeric, facet, or tag filters.
- getRankingInfo
-
Incidates whether the search response includes detailed ranking information.
- highlightPostTag
-
HTML string to insert after the highlighted parts in all highlight and snippet results.
- highlightPreTag
-
HTML string to insert before the highlighted parts in all highlight and snippet results.
- hitsPerPage
-
Number of hits per page.
- insideBoundingBox
-
Search inside a rectangular area (in geographical coordinates).
- insidePolygon
-
Search inside a polygon (in geographical coordinates).
- keepDiacriticsOnCharacters
-
Characters that the engine shouldn't automatically normalize.
- length
-
Sets the number of hits to retrieve (for use with
offset
). > Note: Usingpage
andhitsPerPage
is the recommended method for paging results. However, you can useoffset
andlength
to implement an alternative approach to paging. - maxFacetHits
-
Maximum number of facet hits to return when searching for facet values.
- maxValuesPerFacet
-
Maximum number of facet values to return for each facet.
- minProximity
-
Precision of the proximity ranking criterion.
- minWordSizefor1Typo
-
Minimum number of characters a word in the query string must contain to accept matches with one typo.
- minWordSizefor2Typos
-
Minimum number of characters a word in the query string must contain to accept matches with two typos.
- minimumAroundRadius
-
Minimum radius (in meters) used for a geographical search when
aroundRadius
isn't set. - naturalLanguages
-
Changes the default values of parameters that work best for a natural language query, such as
ignorePlurals
,removeStopWords
,removeWordsIfNoResults
,analyticsTags
, andruleContexts
. These parameters work well together when the query consists of fuller natural language strings instead of keywords, for example when processing voice search queries. - offset
-
Specifies the offset of the first hit to return. > Note: Using
page
andhitsPerPage
is the recommended method for paging results. However, you can useoffset
andlength
to implement an alternative approach to paging. - optionalWords
-
Words which should be considered optional when found in a query.
- page
-
Page to retrieve (the first page is
0
, not1
). - percentileComputation
-
Whether to include or exclude a query from the processing-time percentile computation.
- personalizationImpact
-
Defines how much Personalization affects results.
- query
-
Text to search for in an index.
- queryLanguages
-
Sets your user's search language. This adjusts language-specific settings and features such as
ignorePlurals
,removeStopWords
, and CJK word detection. - ranking
-
Determines the order in which Algolia returns your results.
- relevancyStrictness
-
Relevancy threshold below which less relevant results aren't included in the results.
- replaceSynonymsInHighlight
-
Whether to highlight and snippet the original word that matches the synonym or the synonym itself.
- responseFields
-
Attributes to include in the API response for search and browse queries.
- restrictHighlightAndSnippetArrays
-
Restrict highlighting and snippeting to items that matched the query.
- restrictSearchableAttributes
-
Restricts a query to only look at a subset of your searchable attributes.
- ruleContexts
-
Assigns rule contexts to search queries.
- similarQuery
-
Overrides the query parameter and performs a more generic search.
- snippetEllipsisText
-
String used as an ellipsis indicator when a snippet is truncated.
- sortFacetValuesBy
-
Controls how facet values are fetched.
- sumOrFiltersScores
-
Determines how to calculate filter scores. If
false
, maximum score is kept. Iftrue
, score is summed. - synonyms
-
Whether to take into account an index's synonyms for a particular search.
- userToken
-
Associates a user token with the current search.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalstrait BrowseParamsTraittrait BrowseParamsclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
- Self type
Attributes
- Supertypes
- Known subtypes
-
class BrowseParamsObjectclass SearchParamsString
BrowseResponse
BrowseResponse
Value parameters
- abTestID
-
A/B test ID. This is only included in the response for indices that are part of an A/B test.
- abTestVariantID
-
Variant ID. This is only included in the response for indices that are part of an A/B test.
- aroundLatLng
-
Computed geographical location.
- automaticRadius
-
Automatically-computed radius.
- cursor
-
Cursor indicating the location to resume browsing from. Must match the value returned by the previous call. Pass this value to the subsequent browse call to get the next page of results. When the end of the index has been reached,
cursor
is absent from the response. - exhaustiveFacetsCount
-
See the
facetsCount
field of theexhaustive
object in the response. - exhaustiveNbHits
-
See the
nbHits
field of theexhaustive
object in the response. - exhaustiveTypo
-
See the
typo
field of theexhaustive
object in the response. - facets
-
Mapping of each facet name to the corresponding facet counts.
- facetsStats
-
Statistics for numerical facets.
- hitsPerPage
-
Number of hits per page.
- index
-
Index name used for the query.
- indexUsed
-
Index name used for the query. During A/B testing, the targeted index isn't always the index used by the query.
- message
-
Warnings about the query.
- nbHits
-
Number of hits the search query matched.
- nbPages
-
Number of pages of results for the current query.
- nbSortedHits
-
Number of hits selected and sorted by the relevant sort algorithm.
- page
-
Page to retrieve (the first page is
0
, not1
). - params
-
URL-encoded string of all search parameters.
- parsedQuery
-
Post-normalization query string that will be searched.
- processingTimeMS
-
Time the server took to process the request, in milliseconds.
- processingTimingsMS
-
Experimental. List of processing steps and their times, in milliseconds. You can use this list to investigate performance issues.
- query
-
Text to search for in an index.
- queryAfterRemoval
-
Markup text indicating which parts of the original query have been removed to retrieve a non-empty result set.
- serverTimeMS
-
Time the server took to process the request, in milliseconds.
- serverUsed
-
Host name of the server that processed the request.
- userData
-
Lets you store custom data in your indices.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
To update an attribute without pushing the entire record, you can use these built-in operations.
To update an attribute without pushing the entire record, you can use these built-in operations.
Value parameters
- value
-
Value that corresponds to the operation, for example an
Increment
orDecrement
step,Add
orRemove
value.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalstrait AttributeToUpdateTraittrait AttributeToUpdateclass Objecttrait Matchableclass AnyShow all
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
object Add.typeobject AddUnique.typeobject Decrement.typeobject Increment.typeobject IncrementFrom.typeobject IncrementSet.typeobject Remove.typeShow all
Operation to apply to the attribute.
Operation to apply to the attribute.
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
BuiltInOperationType.type
Attributes
- Supertypes
-
class CustomSerializer[BuiltInOperationType]trait Serializer[BuiltInOperationType]class Objecttrait Matchableclass Any
Condition
Condition
Value parameters
- alternatives
-
Whether the pattern matches on plurals, synonyms, and typos.
- context
-
Rule context format: [A-Za-z0-9_-]+).
- pattern
-
Query pattern syntax.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Consequences of a rule.
Consequences of a rule.
Value parameters
- filterPromotes
-
Only use in combination with the
promote
consequence. Whentrue
, promoted results will be restricted to match the filters of the current search. Whenfalse
, the promoted results will show up regardless of the filters. - hide
-
Records to hide. By default, you can hide up to 50 records per rule.
- promote
-
Records to promote.
- userData
-
Custom JSON object that will be appended to the userData array in the response. This object isn't interpreted by the API. It's limited to 1kB of minified JSON.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Unique identifier of the record to hide.
Unique identifier of the record to hide.
Value parameters
- objectID
-
Unique object identifier.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
ConsequenceParams
ConsequenceParams
Value parameters
- advancedSyntax
-
Enables the advanced query syntax.
- advancedSyntaxFeatures
-
Allows you to specify which advanced syntax features are active when
advancedSyntax
is enabled. - allowTyposOnNumericTokens
-
Whether to allow typos on numbers ("numeric tokens") in the query string.
- alternativesAsExact
-
Alternatives that should be considered an exact match by the exact ranking criterion.
- analytics
-
Indicates whether this query will be included in analytics.
- analyticsTags
-
Tags to apply to the query for segmenting analytics data.
- aroundLatLng
-
Search for entries around a central location, enabling a geographical search within a circular area.
- aroundLatLngViaIP
-
Search for entries around a location. The location is automatically computed from the requester's IP address.
- attributeCriteriaComputedByMinProximity
-
When the Attribute criterion is ranked above Proximity in your ranking formula, Proximity is used to select which searchable attribute is matched in the Attribute ranking stage.
- attributesForFaceting
-
Attributes used for faceting and the modifiers that can be applied:
filterOnly
,searchable
, andafterDistinct
. - attributesToHighlight
-
Attributes to highlight. Strings that match the search query in the attributes are highlighted by surrounding them with HTML tags (
highlightPreTag
andhighlightPostTag
). - attributesToRetrieve
-
Attributes to include in the API response. To reduce the size of your response, you can retrieve only some of the attributes. By default, the response includes all attributes.
- attributesToSnippet
-
Attributes to snippet. 'Snippeting' is shortening the attribute to a certain number of words. If not specified, the attribute is shortened to the 10 words around the matching string but you can specify the number. For example:
body:20
. - clickAnalytics
-
Indicates whether a query ID parameter is included in the search response. This is required for tracking click and conversion events.
- customRanking
-
Specifies the Custom ranking criterion. Use the
asc
anddesc
modifiers to specify the ranking order: ascending or descending. - decompoundQuery
-
Splits compound words into their component word parts in the query.
- disableExactOnAttributes
-
Attributes for which you want to turn off the exact ranking criterion.
- disableTypoToleranceOnAttributes
-
Attributes for which you want to turn off typo tolerance.
- enableABTest
-
Incidates whether this search will be considered in A/B testing.
- enablePersonalization
-
Incidates whether Personalization is enabled.
- enableReRanking
-
Indicates whether this search will use Dynamic Re-Ranking.
- enableRules
-
Incidates whether Rules are enabled.
- explain
-
Enriches the API's response with information about how the query was processed.
- facetingAfterDistinct
-
Forces faceting to be applied after de-duplication (with the distinct feature). Alternatively, the
afterDistinct
modifier ofattributesForFaceting
allows for more granular control. - facets
-
Returns facets, their facet values, and the number of matching facet values.
- filters
-
Filter the query with numeric, facet, or tag filters.
- getRankingInfo
-
Incidates whether the search response includes detailed ranking information.
- highlightPostTag
-
HTML string to insert after the highlighted parts in all highlight and snippet results.
- highlightPreTag
-
HTML string to insert before the highlighted parts in all highlight and snippet results.
- hitsPerPage
-
Number of hits per page.
- insideBoundingBox
-
Search inside a rectangular area (in geographical coordinates).
- insidePolygon
-
Search inside a polygon (in geographical coordinates).
- keepDiacriticsOnCharacters
-
Characters that the engine shouldn't automatically normalize.
- length
-
Sets the number of hits to retrieve (for use with
offset
). > Note: Usingpage
andhitsPerPage
is the recommended method for paging results. However, you can useoffset
andlength
to implement an alternative approach to paging. - maxFacetHits
-
Maximum number of facet hits to return when searching for facet values.
- maxValuesPerFacet
-
Maximum number of facet values to return for each facet.
- minProximity
-
Precision of the proximity ranking criterion.
- minWordSizefor1Typo
-
Minimum number of characters a word in the query string must contain to accept matches with one typo.
- minWordSizefor2Typos
-
Minimum number of characters a word in the query string must contain to accept matches with two typos.
- minimumAroundRadius
-
Minimum radius (in meters) used for a geographical search when
aroundRadius
isn't set. - naturalLanguages
-
Changes the default values of parameters that work best for a natural language query, such as
ignorePlurals
,removeStopWords
,removeWordsIfNoResults
,analyticsTags
, andruleContexts
. These parameters work well together when the query consists of fuller natural language strings instead of keywords, for example when processing voice search queries. - offset
-
Specifies the offset of the first hit to return. > Note: Using
page
andhitsPerPage
is the recommended method for paging results. However, you can useoffset
andlength
to implement an alternative approach to paging. - optionalWords
-
Words which should be considered optional when found in a query.
- page
-
Page to retrieve (the first page is
0
, not1
). - percentileComputation
-
Whether to include or exclude a query from the processing-time percentile computation.
- personalizationImpact
-
Defines how much Personalization affects results.
- queryLanguages
-
Sets your user's search language. This adjusts language-specific settings and features such as
ignorePlurals
,removeStopWords
, and CJK word detection. - ranking
-
Determines the order in which Algolia returns your results.
- relevancyStrictness
-
Relevancy threshold below which less relevant results aren't included in the results.
- replaceSynonymsInHighlight
-
Whether to highlight and snippet the original word that matches the synonym or the synonym itself.
- responseFields
-
Attributes to include in the API response for search and browse queries.
- restrictHighlightAndSnippetArrays
-
Restrict highlighting and snippeting to items that matched the query.
- restrictSearchableAttributes
-
Restricts a query to only look at a subset of your searchable attributes.
- ruleContexts
-
Assigns rule contexts to search queries.
- similarQuery
-
Overrides the query parameter and performs a more generic search.
- snippetEllipsisText
-
String used as an ellipsis indicator when a snippet is truncated.
- sortFacetValuesBy
-
Controls how facet values are fetched.
- sumOrFiltersScores
-
Determines how to calculate filter scores. If
false
, maximum score is kept. Iftrue
, score is summed. - synonyms
-
Whether to take into account an index's synonyms for a particular search.
- userToken
-
Associates a user token with the current search.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
When providing a string, it replaces the entire query string. When providing an object, it describes incremental edits to be made to the query string (but you can't do both).
When providing a string, it replaces the entire query string. When providing an object, it describes incremental edits to be made to the query string (but you can't do both).
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
Attributes
- Companion
- trait
- Supertypes
-
class Objecttrait Matchableclass Any
- Self type
-
ConsequenceQuery.type
ConsequenceQueryObject
ConsequenceQueryObject
Value parameters
- edits
-
Edits to apply.
- remove
-
Words to remove.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalstrait ConsequenceQueryTraittrait ConsequenceQueryclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
- Self type
Attributes
- Supertypes
- Known subtypes
-
class ConsequenceQueryObject
Response and creation timestamp.
Response and creation timestamp.
Value parameters
- createdAt
-
Timestamp of creation in ISO-8601 format.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Cursor
Cursor
Value parameters
- cursor
-
Cursor indicating the location to resume browsing from. Must match the value returned by the previous call. Pass this value to the subsequent browse call to get the next page of results. When the end of the index has been reached,
cursor
is absent from the response.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
DeleteApiKeyResponse
DeleteApiKeyResponse
Value parameters
- deletedAt
-
Timestamp of deletion in ISO 8601 format.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
DeleteByParams
DeleteByParams
Value parameters
- aroundLatLng
-
Search for entries around a central location, enabling a geographical search within a circular area.
- filters
-
Filter the query with numeric, facet, or tag filters.
- insideBoundingBox
-
Search inside a rectangular area (in geographical coordinates).
- insidePolygon
-
Search inside a polygon (in geographical coordinates).
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
DeleteSourceResponse
DeleteSourceResponse
Value parameters
- deletedAt
-
Timestamp of deletion in ISO 8601 format.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Response, taskID, and deletion timestamp.
Response, taskID, and deletion timestamp.
Value parameters
- deletedAt
-
Timestamp of deletion in ISO 8601 format.
- taskID
-
Unique identifier of a task. A successful API response means that a task was added to a queue. It might not run immediately. You can check the task's progress with the
task
operation and thistaskID
.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
object AddEntry.typeobject DeleteEntry.type
Actions to perform.
Actions to perform.
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
DictionaryAction.type
Attributes
- Supertypes
-
class CustomSerializer[DictionaryAction]trait Serializer[DictionaryAction]class Objecttrait Matchableclass Any
Dictionary entry.
Dictionary entry.
Value parameters
- decomposition
-
For compound entries, governs the behavior of the
word
parameter. - language
- objectID
-
Unique identifier for a dictionary object.
- word
-
Dictionary entry word. Usage depends on the type of dictionary entry.
stopwordEntry
The stop word you want to add or update. If the entry already exists in Algolia's standard dictionary, you can override its behavior by adding it to the custom dictionary and setting itsstate
todisabled
.compoundEntry
Whendecomposition
is empty: addsword
as a compound atom. For example, atom “kino” decomposes the query “kopfkino” into "kopf" and "kino". Whendecomposition
isn't empty: creates a decomposition exception. For example, when decomposition is set to the ["hund", "hutte"] exception, "hundehutte" decomposes into “hund” and “hutte”, discarding the linking "e". - words
-
Compound dictionary word declensions. If the entry already exists in Algolia's standard dictionary, you can override its behavior by adding it to the custom dictionary and setting its
state
todisabled
.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
Indicates whether a dictionary entry is active (enabled
) or inactive (disabled
).
Indicates whether a dictionary entry is active (enabled
) or inactive (disabled
).
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
DictionaryEntryState.type
Attributes
- Supertypes
-
class CustomSerializer[DictionaryEntryState]trait Serializer[DictionaryEntryState]class Objecttrait Matchableclass Any
Custom entries for a dictionary.
Custom entries for a dictionary.
Value parameters
- nbCustomEntries
-
If
0
, the dictionary hasn't been customized and only contains standard entries provided by Algolia. Ifnull
, that feature isn't available or isn't supported for that language.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Enable or turn off the built-in Algolia stop words for a specific language.
Enable or turn off the built-in Algolia stop words for a specific language.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
DictionaryType enumeration
DictionaryType enumeration
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
DictionaryType.type
Attributes
- Supertypes
-
class CustomSerializer[DictionaryType]trait Serializer[DictionaryType]class Objecttrait Matchableclass Any
Enables deduplication or grouping of results (Algolia's distinct feature).
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
class BooleanValueclass IntValue
Attributes
- Supertypes
- Self type
-
DistinctSerializer.type
Edit
Edit
Value parameters
- delete
-
Text or patterns to remove from the query string.
- insert
-
Text that should be inserted in place of the removed text inside the query string.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Error.
Error.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
Determines how the Exact ranking criterion is computed when the query contains only one word.
Determines how the Exact ranking criterion is computed when the query contains only one word.
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
Attributes
- Supertypes
-
class CustomSerializer[ExactOnSingleWordQuery]trait Serializer[ExactOnSingleWordQuery]class Objecttrait Matchableclass Any
Whether certain properties of the search response are calculated exhaustive (exact) or approximated.
Whether certain properties of the search response are calculated exhaustive (exact) or approximated.
Value parameters
- facetValues
-
The value is
false
if not all facet values are retrieved. - facetsCount
-
Whether the facet count is exhaustive (
true
) or approximate (false
). See the related discussion. - nbHits
-
Whether the
nbHits
is exhaustive (true
) or approximate (false
). When the query takes more than 50ms to be processed, the engine makes an approximation. This can happen when using complex filters on millions of records, when typo-tolerance was not exhaustive, or when enough hits have been retrieved (for example, after the engine finds 10,000 exact matches).nbHits
is reported as non-exhaustive whenever an approximation is made, even if the approximation didn’t, in the end, impact the exhaustivity of the query. - rulesMatch
-
Rules matching exhaustivity. The value is
false
if rules were enable for this query, and could not be fully processed due a timeout. This is generally caused by the number of alternatives (such as typos) which is too large. - typo
-
Whether the typo search was exhaustive (
true
) or approximate (false
). An approximation is done when the typo search query part takes more than 10% of the query budget (ie. 5ms by default) to be processed (this can happen when a lot of typo alternatives exist for the query). This field will not be included when typo-tolerance is entirely disabled.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Filter hits by facet value.
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
class SeqOfMixedSearchFiltersclass StringValue
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
FacetFilters.type
Attributes
- Supertypes
- Self type
FacetHits
FacetHits
Value parameters
- count
-
Number of records containing this facet value. This takes into account the extra search parameters specified in the query. Like for a regular search query, the counts may not be exhaustive.
- highlighted
-
Markup text with
facetQuery
matches highlighted. - value
-
Facet value.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Defines the ordering of facets (widgets).
Defines the ordering of facets (widgets).
Value parameters
- values
-
Ordering of facet values within an individual facet.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Ordering of facets (widgets).
Ordering of facets (widgets).
Value parameters
- order
-
Pinned order of facet lists.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
FacetsStats
FacetsStats
Value parameters
- avg
-
Average facet value in the results.
- max
-
Maximum value in the results.
- min
-
Minimum value in the results.
- sum
-
Sum of all values in the results.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
FetchedIndex
FetchedIndex
Value parameters
- createdAt
-
Index creation date. An empty string means that the index has no records.
- dataSize
-
Number of bytes of the index in minified format.
- entries
-
Number of records contained in the index.
- fileSize
-
Number of bytes of the index binary file.
- lastBuildTimeS
-
Last build time.
- name
-
Index name.
- numberOfPendingTasks
-
Number of pending indexing operations. This value is deprecated and should not be used.
- pendingTask
-
A boolean which says whether the index has pending tasks. This value is deprecated and should not be used.
- primary
-
Only present if the index is a replica. Contains the name of the related primary index.
- replicas
-
Only present if the index is a primary index with replicas. Contains the names of all linked replicas.
- updatedAt
-
Timestamp of the last update in ISO 8601 format.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
GetApiKeyResponse
GetApiKeyResponse
Value parameters
- acl
-
Permissions associated with the key.
- createdAt
-
Timestamp of creation in milliseconds in Unix epoch time.
- description
-
Description of an API key for you and your team members.
- indexes
-
Restricts this API key to a list of indices or index patterns. If the list is empty, all indices are allowed. Specify either an exact index name or a pattern with a leading or trailing wildcard character (or both). For example: -
dev_*
matches all indices starting with "dev_" -*_dev
matches all indices ending with "_dev" -*_products_*
matches all indices containing "products". - maxHitsPerQuery
-
Maximum number of hits this API key can retrieve in one query. If zero, no limit is enforced. > Note: Use this parameter to protect you from third-party attempts to retrieve your entire content by massively querying the index.
- maxQueriesPerIPPerHour
-
Maximum number of API calls per hour allowed from a given IP address or user token. Each time an API call is performed with this key, a check is performed. If there were more than the specified number of calls within the last hour, the API returns an error with the status code
429
(Too Many Requests). > Note: Use this parameter to protect you from third-party attempts to retrieve your entire content by massively querying the index. - queryParameters
-
Force some query parameters to be applied for each query made with this API key. It's a URL-encoded query string.
- referers
-
Restrict this API key to specific referrers. If empty, all referrers are allowed. For example: -
https://algolia.com/_*
matches all referrers starting with "https://algolia.com/" -*.algolia.com
matches all referrers ending with ".algolia.com" -*algolia.com*
allows everything in the domain "algolia.com". - validity
-
Validity duration of a key (in seconds). The key will automatically be removed after this time has expired. The default value of 0 never expires. Short-lived API keys are useful to grant temporary access to your data. For example, in mobile apps, you can't control when users update your app. So instead of encoding keys into your app as you would for a web app, you should dynamically fetch them from your mobile app's backend.
- value
-
API key.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
GetDictionarySettingsResponse
GetDictionarySettingsResponse
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
GetLogsResponse
GetLogsResponse
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Request parameters.
Request parameters.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Record retrieval operation.
Record retrieval operation.
Value parameters
- attributesToRetrieve
-
Attributes to retrieve. If not specified, all retrievable attributes are returned.
- indexName
-
Name of the index containing the required records.
- objectID
-
Record's objectID.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
GetObjectsResponse
GetObjectsResponse
Value parameters
- results
-
Retrieved results.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
GetTaskResponse
GetTaskResponse
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
User IDs and clusters.
User IDs and clusters.
Value parameters
- topUsers
-
Key-value pairs with cluster names as keys and lists of users with the highest number of records per cluster as values.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
HasPendingMappingsResponse
HasPendingMappingsResponse
Value parameters
- clusters
-
Cluster pending mapping state: migrating, creating, deleting.
- pending
-
Indicates whether there are clusters undergoing migration, creation, or deletion.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
HighlightResult
HighlightResult
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
Attributes
- Companion
- trait
- Supertypes
-
class Objecttrait Matchableclass Any
- Self type
-
HighlightResult.type
Show highlighted section and words matched on a query.
Show highlighted section and words matched on a query.
Value parameters
- fullyHighlighted
-
Whether the entire attribute value is highlighted.
- matchedWords
-
List of words from the query that matched the object.
- value
-
Markup text with
facetQuery
matches highlighted.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalstrait HighlightResultTraittrait HighlightResultclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
- Self type
Attributes
- Supertypes
- Known subtypes
-
class HighlightResultOption
A single hit.
A single hit.
Value parameters
- highlightResult
-
Show highlighted section and words matched on a query.
- objectID
-
Unique object identifier.
- snippetResult
-
Snippeted attributes show parts of the matched attributes. Only returned when attributesToSnippet is non-empty.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
Treats singular, plurals, and other forms of declensions as matching terms. ignorePlurals
is used in conjunction with the queryLanguages
setting. list: language ISO codes for which ignoring plurals should be enabled. This list will override any values that you may have set in queryLanguages
. true: enables the ignore plurals feature, where singulars and plurals are considered equivalent ("foot" = "feet"). The languages supported here are either every language (this is the default) or those set by queryLanguages
. false: turns off the ignore plurals feature, so that singulars and plurals aren't considered to be the same ("foot" will not find "feet").
Treats singular, plurals, and other forms of declensions as matching terms. ignorePlurals
is used in conjunction with the queryLanguages
setting. list: language ISO codes for which ignoring plurals should be enabled. This list will override any values that you may have set in queryLanguages
. true: enables the ignore plurals feature, where singulars and plurals are considered equivalent ("foot" = "feet"). The languages supported here are either every language (this is the default) or those set by queryLanguages
. false: turns off the ignore plurals feature, so that singulars and plurals aren't considered to be the same ("foot" will not find "feet").
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
class BooleanValueclass SeqOfString
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
IgnorePlurals.type
Attributes
- Supertypes
- Self type
Algolia index settings.
Algolia index settings.
Value parameters
- advancedSyntax
-
Enables the advanced query syntax.
- advancedSyntaxFeatures
-
Allows you to specify which advanced syntax features are active when
advancedSyntax
is enabled. - allowCompressionOfIntegerArray
-
Incidates whether the engine compresses arrays with exclusively non-negative integers. When enabled, the compressed arrays may be reordered.
- allowTyposOnNumericTokens
-
Whether to allow typos on numbers ("numeric tokens") in the query string.
- alternativesAsExact
-
Alternatives that should be considered an exact match by the exact ranking criterion.
- attributeCriteriaComputedByMinProximity
-
When the Attribute criterion is ranked above Proximity in your ranking formula, Proximity is used to select which searchable attribute is matched in the Attribute ranking stage.
- attributeForDistinct
-
Name of the deduplication attribute to be used with Algolia's distinct feature.
- attributesForFaceting
-
Attributes used for faceting and the modifiers that can be applied:
filterOnly
,searchable
, andafterDistinct
. - attributesToHighlight
-
Attributes to highlight. Strings that match the search query in the attributes are highlighted by surrounding them with HTML tags (
highlightPreTag
andhighlightPostTag
). - attributesToRetrieve
-
Attributes to include in the API response. To reduce the size of your response, you can retrieve only some of the attributes. By default, the response includes all attributes.
- attributesToSnippet
-
Attributes to snippet. 'Snippeting' is shortening the attribute to a certain number of words. If not specified, the attribute is shortened to the 10 words around the matching string but you can specify the number. For example:
body:20
. - attributesToTransliterate
-
Attributes in your index to which Japanese transliteration applies. This will ensure that words indexed in Katakana or Kanji can also be searched in Hiragana.
- camelCaseAttributes
-
Attributes on which to split camel case words.
- customNormalization
-
A list of characters and their normalized replacements to override Algolia's default normalization.
- customRanking
-
Specifies the Custom ranking criterion. Use the
asc
anddesc
modifiers to specify the ranking order: ascending or descending. - decompoundQuery
-
Splits compound words into their component word parts in the query.
- decompoundedAttributes
-
Attributes in your index to which word segmentation (decompounding) applies.
- disableExactOnAttributes
-
Attributes for which you want to turn off the exact ranking criterion.
- disablePrefixOnAttributes
-
Attributes for which you want to turn off prefix matching.
- disableTypoToleranceOnAttributes
-
Attributes for which you want to turn off typo tolerance.
- disableTypoToleranceOnWords
-
Words for which you want to turn off typo tolerance.
- enablePersonalization
-
Incidates whether Personalization is enabled.
- enableReRanking
-
Indicates whether this search will use Dynamic Re-Ranking.
- enableRules
-
Incidates whether Rules are enabled.
- highlightPostTag
-
HTML string to insert after the highlighted parts in all highlight and snippet results.
- highlightPreTag
-
HTML string to insert before the highlighted parts in all highlight and snippet results.
- hitsPerPage
-
Number of hits per page.
- indexLanguages
-
Set the languages of your index, for language-specific processing steps such as tokenization and normalization.
- keepDiacriticsOnCharacters
-
Characters that the engine shouldn't automatically normalize.
- maxFacetHits
-
Maximum number of facet hits to return when searching for facet values.
- maxValuesPerFacet
-
Maximum number of facet values to return for each facet.
- minProximity
-
Precision of the proximity ranking criterion.
- minWordSizefor1Typo
-
Minimum number of characters a word in the query string must contain to accept matches with one typo.
- minWordSizefor2Typos
-
Minimum number of characters a word in the query string must contain to accept matches with two typos.
- numericAttributesForFiltering
-
Numeric attributes that can be used as numerical filters.
- optionalWords
-
Words which should be considered optional when found in a query.
- paginationLimitedTo
-
Maximum number of hits accessible through pagination.
- queryLanguages
-
Sets your user's search language. This adjusts language-specific settings and features such as
ignorePlurals
,removeStopWords
, and CJK word detection. - ranking
-
Determines the order in which Algolia returns your results.
- relevancyStrictness
-
Relevancy threshold below which less relevant results aren't included in the results.
- replaceSynonymsInHighlight
-
Whether to highlight and snippet the original word that matches the synonym or the synonym itself.
- replicas
-
Creates replicas, which are copies of a primary index with the same records but different settings.
- responseFields
-
Attributes to include in the API response for search and browse queries.
- restrictHighlightAndSnippetArrays
-
Restrict highlighting and snippeting to items that matched the query.
- searchableAttributes
-
Attributes used for searching, including determining if matches at the beginning of a word are important (ordered) or not (unordered).
- separatorsToIndex
-
Controls which separators are added to an Algolia index as part of normalization. Separators are all non-letter characters except spaces and currency characters, such as $€£¥.
- snippetEllipsisText
-
String used as an ellipsis indicator when a snippet is truncated.
- sortFacetValuesBy
-
Controls how facet values are fetched.
- unretrievableAttributes
-
Attributes that can't be retrieved at query time.
- userData
-
Lets you store custom data in your indices.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
IndexSettingsAsSearchParams
IndexSettingsAsSearchParams
Value parameters
- advancedSyntax
-
Enables the advanced query syntax.
- advancedSyntaxFeatures
-
Allows you to specify which advanced syntax features are active when
advancedSyntax
is enabled. - allowTyposOnNumericTokens
-
Whether to allow typos on numbers ("numeric tokens") in the query string.
- alternativesAsExact
-
Alternatives that should be considered an exact match by the exact ranking criterion.
- attributeCriteriaComputedByMinProximity
-
When the Attribute criterion is ranked above Proximity in your ranking formula, Proximity is used to select which searchable attribute is matched in the Attribute ranking stage.
- attributesForFaceting
-
Attributes used for faceting and the modifiers that can be applied:
filterOnly
,searchable
, andafterDistinct
. - attributesToHighlight
-
Attributes to highlight. Strings that match the search query in the attributes are highlighted by surrounding them with HTML tags (
highlightPreTag
andhighlightPostTag
). - attributesToRetrieve
-
Attributes to include in the API response. To reduce the size of your response, you can retrieve only some of the attributes. By default, the response includes all attributes.
- attributesToSnippet
-
Attributes to snippet. 'Snippeting' is shortening the attribute to a certain number of words. If not specified, the attribute is shortened to the 10 words around the matching string but you can specify the number. For example:
body:20
. - customRanking
-
Specifies the Custom ranking criterion. Use the
asc
anddesc
modifiers to specify the ranking order: ascending or descending. - decompoundQuery
-
Splits compound words into their component word parts in the query.
- disableExactOnAttributes
-
Attributes for which you want to turn off the exact ranking criterion.
- disableTypoToleranceOnAttributes
-
Attributes for which you want to turn off typo tolerance.
- enablePersonalization
-
Incidates whether Personalization is enabled.
- enableReRanking
-
Indicates whether this search will use Dynamic Re-Ranking.
- enableRules
-
Incidates whether Rules are enabled.
- highlightPostTag
-
HTML string to insert after the highlighted parts in all highlight and snippet results.
- highlightPreTag
-
HTML string to insert before the highlighted parts in all highlight and snippet results.
- hitsPerPage
-
Number of hits per page.
- keepDiacriticsOnCharacters
-
Characters that the engine shouldn't automatically normalize.
- maxFacetHits
-
Maximum number of facet hits to return when searching for facet values.
- maxValuesPerFacet
-
Maximum number of facet values to return for each facet.
- minProximity
-
Precision of the proximity ranking criterion.
- minWordSizefor1Typo
-
Minimum number of characters a word in the query string must contain to accept matches with one typo.
- minWordSizefor2Typos
-
Minimum number of characters a word in the query string must contain to accept matches with two typos.
- optionalWords
-
Words which should be considered optional when found in a query.
- queryLanguages
-
Sets your user's search language. This adjusts language-specific settings and features such as
ignorePlurals
,removeStopWords
, and CJK word detection. - ranking
-
Determines the order in which Algolia returns your results.
- relevancyStrictness
-
Relevancy threshold below which less relevant results aren't included in the results.
- replaceSynonymsInHighlight
-
Whether to highlight and snippet the original word that matches the synonym or the synonym itself.
- responseFields
-
Attributes to include in the API response for search and browse queries.
- restrictHighlightAndSnippetArrays
-
Restrict highlighting and snippeting to items that matched the query.
- snippetEllipsisText
-
String used as an ellipsis indicator when a snippet is truncated.
- sortFacetValuesBy
-
Controls how facet values are fetched.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
-
class Objecttrait Matchableclass Any
- Self type
-
JsonSupport.type
Dictionary language.
Dictionary language.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
ListApiKeysResponse
ListApiKeysResponse
Value parameters
- keys
-
API keys.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Clusters.
Clusters.
Value parameters
- topUsers
-
Key-value pairs with cluster names as keys and lists of users with the highest number of records per cluster as values.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
ListIndicesResponse
ListIndicesResponse
Value parameters
- items
-
All indices in your Algolia application.
- nbPages
-
Number of pages.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
User ID data.
User ID data.
Value parameters
- userIDs
-
User IDs.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Log
Log
Value parameters
- answer
-
Answer body. Truncated after 1,000 characters.
- answerCode
-
HTTP response code.
- index
-
Index targeted by the query.
- innerQueries
-
Performed queries for the given request.
- ip
-
IP address of the client that performed the request.
- method
-
HTTP method of the performed request.
- nbApiCalls
-
Number of API calls.
- processingTimeMs
-
Processing time for the query. Doesn't include network time.
- queryBody
-
Request body. Truncated after 1,000 characters.
- queryHeaders
-
Request headers (API key is obfuscated).
- queryNbHits
-
Number of hits returned for the query.
- queryParams
-
Query parameters sent with the request.
- sha1
-
SHA1 signature of the log entry.
- timestamp
-
Timestamp in ISO 8601 format.
- url
-
Request URL.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
LogQuery
LogQuery
Value parameters
- indexName
-
Index targeted by the query.
- queryId
-
Unique query identifier.
- userToken
-
User identifier.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Indicates how well the attribute matched the search query.
Indicates how well the attribute matched the search query.
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
MatchLevel.type
Attributes
- Supertypes
-
class CustomSerializer[MatchLevel]trait Serializer[MatchLevel]class Objecttrait Matchableclass Any
MatchedGeoLocation
MatchedGeoLocation
Value parameters
- distance
-
Distance between the matched location and the search location (in meters).
- lat
-
Latitude of the matched location.
- lng
-
Longitude of the matched location.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
MixedSearchFilters
MixedSearchFilters
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
class SeqOfStringclass StringValue
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
MixedSearchFilters.type
Attributes
- Supertypes
- Self type
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
object KeywordSearch.typeobject NeuralSearch.type
MultipleBatchRequest
MultipleBatchRequest
Value parameters
- body
-
Operation arguments (varies with specified
action
). - indexName
-
Index to target for this operation.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
MultipleBatchResponse
MultipleBatchResponse
Value parameters
- objectIDs
-
Unique object (record) identifiers.
- taskID
-
TaskIDs per index.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Filter on numeric attributes.
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
class SeqOfMixedSearchFiltersclass StringValue
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
NumericFilters.type
Attributes
- Supertypes
- Self type
OperationIndexParams
OperationIndexParams
Value parameters
- destination
-
Algolia index name.
- scope
-
This only applies to the copy operation. If you omit
scope
, the copy command copies all records, settings, synonyms, and rules. If you specifyscope
, only the specified scopes are copied.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Operation to perform (move or copy).
Operation to perform (move or copy).
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
OperationType.type
Attributes
- Supertypes
-
class CustomSerializer[OperationType]trait Serializer[OperationType]class Objecttrait Matchableclass Any
Create filters to boost or demote records. Records that match the filter are ranked higher for positive and lower for negative optional filters. In contrast to regular filters, records that don't match the optional filter are still included in the results, only their ranking is affected.
Create filters to boost or demote records. Records that match the filter are ranked higher for positive and lower for negative optional filters. In contrast to regular filters, records that don't match the optional filter are still included in the results, only their ranking is affected.
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
class SeqOfMixedSearchFiltersclass StringValue
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
OptionalFilters.type
Attributes
- Supertypes
- Self type
Additional search parameters.
Additional search parameters.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Personalization
Personalization
Value parameters
- filtersScore
-
The score of the filters.
- rankingScore
-
The score of the ranking.
- score
-
The score of the event.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Promote
Promote
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
Record to promote.
Record to promote.
Value parameters
- objectID
-
Unique identifier of the record to promote.
- position
-
The position to promote the records to. If you pass objectIDs, the records are placed at this position as a group. For example, if you pronmote four objectIDs to position 0, the records take the first four positions.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalstrait PromoteTraittrait Promoteclass Objecttrait Matchableclass AnyShow all
Records to promote.
Records to promote.
Value parameters
- objectIDs
-
Unique identifiers of the records to promote.
- position
-
The position to promote the records to. If you pass objectIDs, the records are placed at this position as a group. For example, if you pronmote four objectIDs to position 0, the records take the first four positions.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalstrait PromoteTraittrait Promoteclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
- Self type
-
PromoteSerializer.type
Attributes
- Supertypes
- Known subtypes
-
class PromoteObjectIDclass PromoteObjectIDs
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
Determines how query words are interpreted as prefixes.
Determines how query words are interpreted as prefixes.
Attributes
RankingInfo
RankingInfo
Value parameters
- filters
-
This field is reserved for advanced usage.
- firstMatchedWord
-
Position of the most important matched attribute in the attributes to index list.
- geoDistance
-
Distance between the geo location in the search query and the best matching geo location in the record, divided by the geo precision (in meters).
- geoPrecision
-
Precision used when computing the geo distance, in meters.
- nbExactWords
-
Number of exactly matched words.
- nbTypos
-
Number of typos encountered when matching the record.
- promoted
-
Present and set to true if a Rule promoted the hit.
- promotedByReRanking
-
Wether the record are promoted by the re-ranking strategy.
- proximityDistance
-
When the query contains more than one word, the sum of the distances between matched words (in meters).
- userScore
-
Custom ranking for the object, expressed as a single integer value.
- words
-
Number of matched words, including prefixes and typos.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
When Dynamic Re-Ranking is enabled, only records that match these filters will be affected by Dynamic Re-Ranking.
When Dynamic Re-Ranking is enabled, only records that match these filters will be affected by Dynamic Re-Ranking.
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
class SeqOfMixedSearchFiltersclass StringValue
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
ReRankingApplyFilter.type
Attributes
- Supertypes
- Self type
Redirect results to a URL.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
RedirectRuleIndexMetadata
RedirectRuleIndexMetadata
Value parameters
- dest
-
Destination index for the redirect rule.
- reason
-
Reason for the redirect rule.
- source
-
Source index for the redirect rule.
- succeed
-
Redirect rule status.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Redirect rule data.
Redirect rule data.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Removes stop (common) words from the query before executing it. removeStopWords
is used in conjunction with the queryLanguages
setting. list: language ISO codes for which stop words should be enabled. This list will override any values that you may have set in queryLanguages
. true: enables the stop words feature, ensuring that stop words are removed from consideration in a search. The languages supported here are either every language (this is the default) or those set by queryLanguages
. false: turns off the stop words feature, allowing stop words to be taken into account in a search.
Removes stop (common) words from the query before executing it. removeStopWords
is used in conjunction with the queryLanguages
setting. list: language ISO codes for which stop words should be enabled. This list will override any values that you may have set in queryLanguages
. true: enables the stop words feature, ensuring that stop words are removed from consideration in a search. The languages supported here are either every language (this is the default) or those set by queryLanguages
. false: turns off the stop words feature, allowing stop words to be taken into account in a search.
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
class BooleanValueclass SeqOfString
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
RemoveStopWords.type
Attributes
- Supertypes
- Self type
RemoveUserIdResponse
RemoveUserIdResponse
Value parameters
- deletedAt
-
Timestamp of deletion in ISO 8601 format.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
Strategy to remove words from the query when it doesn't match any hits.
Strategy to remove words from the query when it doesn't match any hits.
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
Attributes
- Supertypes
-
class CustomSerializer[RemoveWordsIfNoResults]trait Serializer[RemoveWordsIfNoResults]class Objecttrait Matchableclass Any
Extra content for the search UI, for example, to control the ordering and display of facets. You can set a default value and dynamically override it with Rules.
Extra content for the search UI, for example, to control the ordering and display of facets. You can set a default value and dynamically override it with Rules.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
ReplaceSourceResponse
ReplaceSourceResponse
Value parameters
- updatedAt
-
Timestamp of the last update in ISO 8601 format.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Rule object.
Rule object.
Value parameters
- conditions
-
Conditions required to activate a rule. You can use up to 25 conditions per rule.
- description
-
Description of the rule's purpose. This can be helpful for display in the Algolia dashboard.
- enabled
-
Indicates whether to enable the rule. If it isn't enabled, it isn't applied at query time.
- objectID
-
Unique identifier for a rule object.
- validity
-
If you specify a validity period, the rule only applies only during that period. If specified, the array must not be empty.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
SaveObjectResponse
SaveObjectResponse
Value parameters
- createdAt
-
Date of creation (ISO-8601 format).
- objectID
-
Unique object identifier.
- taskID
-
Unique identifier of a task. A successful API response means that a task was added to a queue. It might not run immediately. You can check the task's progress with the
task
operation and thistaskID
.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
SaveSynonymResponse
SaveSynonymResponse
Value parameters
- id
-
Unique identifier of a synonym object.
- taskID
-
Unique identifier of a task. A successful API response means that a task was added to a queue. It might not run immediately. You can check the task's progress with the
task
operation and thistaskID
. - updatedAt
-
Timestamp of the last update in ISO 8601 format.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
searchDictionaryEntries
parameters.
searchDictionaryEntries
parameters.
Value parameters
- hitsPerPage
-
Number of hits per page.
- language
- page
-
Page to retrieve (the first page is
0
, not1
). - query
-
Text to search for in an index.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
SearchForFacetValuesRequest
SearchForFacetValuesRequest
Value parameters
- facetQuery
-
Text to search inside the facet's values.
- maxFacetHits
-
Maximum number of facet hits to return when searching for facet values.
- params
-
Search parameters as a URL-encoded query string.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
SearchForFacetValuesResponse
SearchForFacetValuesResponse
Value parameters
- exhaustiveFacetsCount
-
See the
facetsCount
field of theexhaustive
object in the response. - processingTimeMS
-
Time the server took to process the request, in milliseconds.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalstrait SearchResultTraittrait SearchResultclass Objecttrait Matchableclass AnyShow all
SearchForFacets
SearchForFacets
Value parameters
- advancedSyntax
-
Enables the advanced query syntax.
- advancedSyntaxFeatures
-
Allows you to specify which advanced syntax features are active when
advancedSyntax
is enabled. - allowTyposOnNumericTokens
-
Whether to allow typos on numbers ("numeric tokens") in the query string.
- alternativesAsExact
-
Alternatives that should be considered an exact match by the exact ranking criterion.
- analytics
-
Indicates whether this query will be included in analytics.
- analyticsTags
-
Tags to apply to the query for segmenting analytics data.
- aroundLatLng
-
Search for entries around a central location, enabling a geographical search within a circular area.
- aroundLatLngViaIP
-
Search for entries around a location. The location is automatically computed from the requester's IP address.
- attributeCriteriaComputedByMinProximity
-
When the Attribute criterion is ranked above Proximity in your ranking formula, Proximity is used to select which searchable attribute is matched in the Attribute ranking stage.
- attributesForFaceting
-
Attributes used for faceting and the modifiers that can be applied:
filterOnly
,searchable
, andafterDistinct
. - attributesToHighlight
-
Attributes to highlight. Strings that match the search query in the attributes are highlighted by surrounding them with HTML tags (
highlightPreTag
andhighlightPostTag
). - attributesToRetrieve
-
Attributes to include in the API response. To reduce the size of your response, you can retrieve only some of the attributes. By default, the response includes all attributes.
- attributesToSnippet
-
Attributes to snippet. 'Snippeting' is shortening the attribute to a certain number of words. If not specified, the attribute is shortened to the 10 words around the matching string but you can specify the number. For example:
body:20
. - clickAnalytics
-
Indicates whether a query ID parameter is included in the search response. This is required for tracking click and conversion events.
- customRanking
-
Specifies the Custom ranking criterion. Use the
asc
anddesc
modifiers to specify the ranking order: ascending or descending. - decompoundQuery
-
Splits compound words into their component word parts in the query.
- disableExactOnAttributes
-
Attributes for which you want to turn off the exact ranking criterion.
- disableTypoToleranceOnAttributes
-
Attributes for which you want to turn off typo tolerance.
- enableABTest
-
Incidates whether this search will be considered in A/B testing.
- enablePersonalization
-
Incidates whether Personalization is enabled.
- enableReRanking
-
Indicates whether this search will use Dynamic Re-Ranking.
- enableRules
-
Incidates whether Rules are enabled.
- explain
-
Enriches the API's response with information about how the query was processed.
- facet
-
Facet name.
- facetQuery
-
Text to search inside the facet's values.
- facetingAfterDistinct
-
Forces faceting to be applied after de-duplication (with the distinct feature). Alternatively, the
afterDistinct
modifier ofattributesForFaceting
allows for more granular control. - facets
-
Returns facets, their facet values, and the number of matching facet values.
- filters
-
Filter the query with numeric, facet, or tag filters.
- getRankingInfo
-
Incidates whether the search response includes detailed ranking information.
- highlightPostTag
-
HTML string to insert after the highlighted parts in all highlight and snippet results.
- highlightPreTag
-
HTML string to insert before the highlighted parts in all highlight and snippet results.
- hitsPerPage
-
Number of hits per page.
- indexName
-
Algolia index name.
- insideBoundingBox
-
Search inside a rectangular area (in geographical coordinates).
- insidePolygon
-
Search inside a polygon (in geographical coordinates).
- keepDiacriticsOnCharacters
-
Characters that the engine shouldn't automatically normalize.
- length
-
Sets the number of hits to retrieve (for use with
offset
). > Note: Usingpage
andhitsPerPage
is the recommended method for paging results. However, you can useoffset
andlength
to implement an alternative approach to paging. - maxFacetHits
-
Maximum number of facet hits to return when searching for facet values.
- maxValuesPerFacet
-
Maximum number of facet values to return for each facet.
- minProximity
-
Precision of the proximity ranking criterion.
- minWordSizefor1Typo
-
Minimum number of characters a word in the query string must contain to accept matches with one typo.
- minWordSizefor2Typos
-
Minimum number of characters a word in the query string must contain to accept matches with two typos.
- minimumAroundRadius
-
Minimum radius (in meters) used for a geographical search when
aroundRadius
isn't set. - naturalLanguages
-
Changes the default values of parameters that work best for a natural language query, such as
ignorePlurals
,removeStopWords
,removeWordsIfNoResults
,analyticsTags
, andruleContexts
. These parameters work well together when the query consists of fuller natural language strings instead of keywords, for example when processing voice search queries. - offset
-
Specifies the offset of the first hit to return. > Note: Using
page
andhitsPerPage
is the recommended method for paging results. However, you can useoffset
andlength
to implement an alternative approach to paging. - optionalWords
-
Words which should be considered optional when found in a query.
- page
-
Page to retrieve (the first page is
0
, not1
). - params
-
Search parameters as a URL-encoded query string.
- percentileComputation
-
Whether to include or exclude a query from the processing-time percentile computation.
- personalizationImpact
-
Defines how much Personalization affects results.
- query
-
Text to search for in an index.
- queryLanguages
-
Sets your user's search language. This adjusts language-specific settings and features such as
ignorePlurals
,removeStopWords
, and CJK word detection. - ranking
-
Determines the order in which Algolia returns your results.
- relevancyStrictness
-
Relevancy threshold below which less relevant results aren't included in the results.
- replaceSynonymsInHighlight
-
Whether to highlight and snippet the original word that matches the synonym or the synonym itself.
- responseFields
-
Attributes to include in the API response for search and browse queries.
- restrictHighlightAndSnippetArrays
-
Restrict highlighting and snippeting to items that matched the query.
- restrictSearchableAttributes
-
Restricts a query to only look at a subset of your searchable attributes.
- ruleContexts
-
Assigns rule contexts to search queries.
- similarQuery
-
Overrides the query parameter and performs a more generic search.
- snippetEllipsisText
-
String used as an ellipsis indicator when a snippet is truncated.
- sortFacetValuesBy
-
Controls how facet values are fetched.
- sumOrFiltersScores
-
Determines how to calculate filter scores. If
false
, maximum score is kept. Iftrue
, score is summed. - synonyms
-
Whether to take into account an index's synonyms for a particular search.
- userToken
-
Associates a user token with the current search.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalstrait SearchQueryTraittrait SearchQueryclass Objecttrait Matchableclass AnyShow all
SearchForFacetsOptions
SearchForFacetsOptions
Value parameters
- facet
-
Facet name.
- facetQuery
-
Text to search inside the facet's values.
- indexName
-
Algolia index name.
- maxFacetHits
-
Maximum number of facet hits to return when searching for facet values.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
SearchForHits
SearchForHits
Value parameters
- advancedSyntax
-
Enables the advanced query syntax.
- advancedSyntaxFeatures
-
Allows you to specify which advanced syntax features are active when
advancedSyntax
is enabled. - allowTyposOnNumericTokens
-
Whether to allow typos on numbers ("numeric tokens") in the query string.
- alternativesAsExact
-
Alternatives that should be considered an exact match by the exact ranking criterion.
- analytics
-
Indicates whether this query will be included in analytics.
- analyticsTags
-
Tags to apply to the query for segmenting analytics data.
- aroundLatLng
-
Search for entries around a central location, enabling a geographical search within a circular area.
- aroundLatLngViaIP
-
Search for entries around a location. The location is automatically computed from the requester's IP address.
- attributeCriteriaComputedByMinProximity
-
When the Attribute criterion is ranked above Proximity in your ranking formula, Proximity is used to select which searchable attribute is matched in the Attribute ranking stage.
- attributesForFaceting
-
Attributes used for faceting and the modifiers that can be applied:
filterOnly
,searchable
, andafterDistinct
. - attributesToHighlight
-
Attributes to highlight. Strings that match the search query in the attributes are highlighted by surrounding them with HTML tags (
highlightPreTag
andhighlightPostTag
). - attributesToRetrieve
-
Attributes to include in the API response. To reduce the size of your response, you can retrieve only some of the attributes. By default, the response includes all attributes.
- attributesToSnippet
-
Attributes to snippet. 'Snippeting' is shortening the attribute to a certain number of words. If not specified, the attribute is shortened to the 10 words around the matching string but you can specify the number. For example:
body:20
. - clickAnalytics
-
Indicates whether a query ID parameter is included in the search response. This is required for tracking click and conversion events.
- customRanking
-
Specifies the Custom ranking criterion. Use the
asc
anddesc
modifiers to specify the ranking order: ascending or descending. - decompoundQuery
-
Splits compound words into their component word parts in the query.
- disableExactOnAttributes
-
Attributes for which you want to turn off the exact ranking criterion.
- disableTypoToleranceOnAttributes
-
Attributes for which you want to turn off typo tolerance.
- enableABTest
-
Incidates whether this search will be considered in A/B testing.
- enablePersonalization
-
Incidates whether Personalization is enabled.
- enableReRanking
-
Indicates whether this search will use Dynamic Re-Ranking.
- enableRules
-
Incidates whether Rules are enabled.
- explain
-
Enriches the API's response with information about how the query was processed.
- facetingAfterDistinct
-
Forces faceting to be applied after de-duplication (with the distinct feature). Alternatively, the
afterDistinct
modifier ofattributesForFaceting
allows for more granular control. - facets
-
Returns facets, their facet values, and the number of matching facet values.
- filters
-
Filter the query with numeric, facet, or tag filters.
- getRankingInfo
-
Incidates whether the search response includes detailed ranking information.
- highlightPostTag
-
HTML string to insert after the highlighted parts in all highlight and snippet results.
- highlightPreTag
-
HTML string to insert before the highlighted parts in all highlight and snippet results.
- hitsPerPage
-
Number of hits per page.
- indexName
-
Algolia index name.
- insideBoundingBox
-
Search inside a rectangular area (in geographical coordinates).
- insidePolygon
-
Search inside a polygon (in geographical coordinates).
- keepDiacriticsOnCharacters
-
Characters that the engine shouldn't automatically normalize.
- length
-
Sets the number of hits to retrieve (for use with
offset
). > Note: Usingpage
andhitsPerPage
is the recommended method for paging results. However, you can useoffset
andlength
to implement an alternative approach to paging. - maxFacetHits
-
Maximum number of facet hits to return when searching for facet values.
- maxValuesPerFacet
-
Maximum number of facet values to return for each facet.
- minProximity
-
Precision of the proximity ranking criterion.
- minWordSizefor1Typo
-
Minimum number of characters a word in the query string must contain to accept matches with one typo.
- minWordSizefor2Typos
-
Minimum number of characters a word in the query string must contain to accept matches with two typos.
- minimumAroundRadius
-
Minimum radius (in meters) used for a geographical search when
aroundRadius
isn't set. - naturalLanguages
-
Changes the default values of parameters that work best for a natural language query, such as
ignorePlurals
,removeStopWords
,removeWordsIfNoResults
,analyticsTags
, andruleContexts
. These parameters work well together when the query consists of fuller natural language strings instead of keywords, for example when processing voice search queries. - offset
-
Specifies the offset of the first hit to return. > Note: Using
page
andhitsPerPage
is the recommended method for paging results. However, you can useoffset
andlength
to implement an alternative approach to paging. - optionalWords
-
Words which should be considered optional when found in a query.
- page
-
Page to retrieve (the first page is
0
, not1
). - params
-
Search parameters as a URL-encoded query string.
- percentileComputation
-
Whether to include or exclude a query from the processing-time percentile computation.
- personalizationImpact
-
Defines how much Personalization affects results.
- query
-
Text to search for in an index.
- queryLanguages
-
Sets your user's search language. This adjusts language-specific settings and features such as
ignorePlurals
,removeStopWords
, and CJK word detection. - ranking
-
Determines the order in which Algolia returns your results.
- relevancyStrictness
-
Relevancy threshold below which less relevant results aren't included in the results.
- replaceSynonymsInHighlight
-
Whether to highlight and snippet the original word that matches the synonym or the synonym itself.
- responseFields
-
Attributes to include in the API response for search and browse queries.
- restrictHighlightAndSnippetArrays
-
Restrict highlighting and snippeting to items that matched the query.
- restrictSearchableAttributes
-
Restricts a query to only look at a subset of your searchable attributes.
- ruleContexts
-
Assigns rule contexts to search queries.
- similarQuery
-
Overrides the query parameter and performs a more generic search.
- snippetEllipsisText
-
String used as an ellipsis indicator when a snippet is truncated.
- sortFacetValuesBy
-
Controls how facet values are fetched.
- sumOrFiltersScores
-
Determines how to calculate filter scores. If
false
, maximum score is kept. Iftrue
, score is summed. - synonyms
-
Whether to take into account an index's synonyms for a particular search.
- userToken
-
Associates a user token with the current search.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalstrait SearchQueryTraittrait SearchQueryclass Objecttrait Matchableclass AnyShow all
SearchForHitsOptions
SearchForHitsOptions
Value parameters
- indexName
-
Algolia index name.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
SearchHits
SearchHits
Value parameters
- params
-
URL-encoded string of all search parameters.
- query
-
Text to search for in an index.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
SearchMethodParams
SearchMethodParams
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
SearchParams
SearchParams
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
Attributes
- Companion
- trait
- Supertypes
-
class Objecttrait Matchableclass Any
- Self type
-
SearchParams.type
SearchParamsObject
SearchParamsObject
Value parameters
- advancedSyntax
-
Enables the advanced query syntax.
- advancedSyntaxFeatures
-
Allows you to specify which advanced syntax features are active when
advancedSyntax
is enabled. - allowTyposOnNumericTokens
-
Whether to allow typos on numbers ("numeric tokens") in the query string.
- alternativesAsExact
-
Alternatives that should be considered an exact match by the exact ranking criterion.
- analytics
-
Indicates whether this query will be included in analytics.
- analyticsTags
-
Tags to apply to the query for segmenting analytics data.
- aroundLatLng
-
Search for entries around a central location, enabling a geographical search within a circular area.
- aroundLatLngViaIP
-
Search for entries around a location. The location is automatically computed from the requester's IP address.
- attributeCriteriaComputedByMinProximity
-
When the Attribute criterion is ranked above Proximity in your ranking formula, Proximity is used to select which searchable attribute is matched in the Attribute ranking stage.
- attributesForFaceting
-
Attributes used for faceting and the modifiers that can be applied:
filterOnly
,searchable
, andafterDistinct
. - attributesToHighlight
-
Attributes to highlight. Strings that match the search query in the attributes are highlighted by surrounding them with HTML tags (
highlightPreTag
andhighlightPostTag
). - attributesToRetrieve
-
Attributes to include in the API response. To reduce the size of your response, you can retrieve only some of the attributes. By default, the response includes all attributes.
- attributesToSnippet
-
Attributes to snippet. 'Snippeting' is shortening the attribute to a certain number of words. If not specified, the attribute is shortened to the 10 words around the matching string but you can specify the number. For example:
body:20
. - clickAnalytics
-
Indicates whether a query ID parameter is included in the search response. This is required for tracking click and conversion events.
- customRanking
-
Specifies the Custom ranking criterion. Use the
asc
anddesc
modifiers to specify the ranking order: ascending or descending. - decompoundQuery
-
Splits compound words into their component word parts in the query.
- disableExactOnAttributes
-
Attributes for which you want to turn off the exact ranking criterion.
- disableTypoToleranceOnAttributes
-
Attributes for which you want to turn off typo tolerance.
- enableABTest
-
Incidates whether this search will be considered in A/B testing.
- enablePersonalization
-
Incidates whether Personalization is enabled.
- enableReRanking
-
Indicates whether this search will use Dynamic Re-Ranking.
- enableRules
-
Incidates whether Rules are enabled.
- explain
-
Enriches the API's response with information about how the query was processed.
- facetingAfterDistinct
-
Forces faceting to be applied after de-duplication (with the distinct feature). Alternatively, the
afterDistinct
modifier ofattributesForFaceting
allows for more granular control. - facets
-
Returns facets, their facet values, and the number of matching facet values.
- filters
-
Filter the query with numeric, facet, or tag filters.
- getRankingInfo
-
Incidates whether the search response includes detailed ranking information.
- highlightPostTag
-
HTML string to insert after the highlighted parts in all highlight and snippet results.
- highlightPreTag
-
HTML string to insert before the highlighted parts in all highlight and snippet results.
- hitsPerPage
-
Number of hits per page.
- insideBoundingBox
-
Search inside a rectangular area (in geographical coordinates).
- insidePolygon
-
Search inside a polygon (in geographical coordinates).
- keepDiacriticsOnCharacters
-
Characters that the engine shouldn't automatically normalize.
- length
-
Sets the number of hits to retrieve (for use with
offset
). > Note: Usingpage
andhitsPerPage
is the recommended method for paging results. However, you can useoffset
andlength
to implement an alternative approach to paging. - maxFacetHits
-
Maximum number of facet hits to return when searching for facet values.
- maxValuesPerFacet
-
Maximum number of facet values to return for each facet.
- minProximity
-
Precision of the proximity ranking criterion.
- minWordSizefor1Typo
-
Minimum number of characters a word in the query string must contain to accept matches with one typo.
- minWordSizefor2Typos
-
Minimum number of characters a word in the query string must contain to accept matches with two typos.
- minimumAroundRadius
-
Minimum radius (in meters) used for a geographical search when
aroundRadius
isn't set. - naturalLanguages
-
Changes the default values of parameters that work best for a natural language query, such as
ignorePlurals
,removeStopWords
,removeWordsIfNoResults
,analyticsTags
, andruleContexts
. These parameters work well together when the query consists of fuller natural language strings instead of keywords, for example when processing voice search queries. - offset
-
Specifies the offset of the first hit to return. > Note: Using
page
andhitsPerPage
is the recommended method for paging results. However, you can useoffset
andlength
to implement an alternative approach to paging. - optionalWords
-
Words which should be considered optional when found in a query.
- page
-
Page to retrieve (the first page is
0
, not1
). - percentileComputation
-
Whether to include or exclude a query from the processing-time percentile computation.
- personalizationImpact
-
Defines how much Personalization affects results.
- query
-
Text to search for in an index.
- queryLanguages
-
Sets your user's search language. This adjusts language-specific settings and features such as
ignorePlurals
,removeStopWords
, and CJK word detection. - ranking
-
Determines the order in which Algolia returns your results.
- relevancyStrictness
-
Relevancy threshold below which less relevant results aren't included in the results.
- replaceSynonymsInHighlight
-
Whether to highlight and snippet the original word that matches the synonym or the synonym itself.
- responseFields
-
Attributes to include in the API response for search and browse queries.
- restrictHighlightAndSnippetArrays
-
Restrict highlighting and snippeting to items that matched the query.
- restrictSearchableAttributes
-
Restricts a query to only look at a subset of your searchable attributes.
- ruleContexts
-
Assigns rule contexts to search queries.
- similarQuery
-
Overrides the query parameter and performs a more generic search.
- snippetEllipsisText
-
String used as an ellipsis indicator when a snippet is truncated.
- sortFacetValuesBy
-
Controls how facet values are fetched.
- sumOrFiltersScores
-
Determines how to calculate filter scores. If
false
, maximum score is kept. Iftrue
, score is summed. - synonyms
-
Whether to take into account an index's synonyms for a particular search.
- userToken
-
Associates a user token with the current search.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalstrait SearchParamsTraittrait SearchParamsclass Objecttrait Matchableclass AnyShow all
SearchParamsQuery
SearchParamsQuery
Value parameters
- query
-
Text to search for in an index.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
- Self type
SearchParamsString
SearchParamsString
Value parameters
- params
-
Search parameters as a URL-encoded query string.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalstrait BrowseParamsTraittrait BrowseParamstrait SearchParamsTraittrait SearchParamsclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
- Known subtypes
-
class SearchParamsObjectclass SearchParamsString
SearchQuery
SearchQuery
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
Attributes
- Companion
- trait
- Supertypes
-
class Objecttrait Matchableclass Any
- Self type
-
SearchQuery.type
Attributes
- Supertypes
- Self type
Attributes
- Supertypes
- Known subtypes
-
class SearchForFacetsclass SearchForHits
SearchResponse
SearchResponse
Value parameters
- abTestID
-
A/B test ID. This is only included in the response for indices that are part of an A/B test.
- abTestVariantID
-
Variant ID. This is only included in the response for indices that are part of an A/B test.
- aroundLatLng
-
Computed geographical location.
- automaticRadius
-
Automatically-computed radius.
- exhaustiveFacetsCount
-
See the
facetsCount
field of theexhaustive
object in the response. - exhaustiveNbHits
-
See the
nbHits
field of theexhaustive
object in the response. - exhaustiveTypo
-
See the
typo
field of theexhaustive
object in the response. - facets
-
Mapping of each facet name to the corresponding facet counts.
- facetsStats
-
Statistics for numerical facets.
- hitsPerPage
-
Number of hits per page.
- index
-
Index name used for the query.
- indexUsed
-
Index name used for the query. During A/B testing, the targeted index isn't always the index used by the query.
- message
-
Warnings about the query.
- nbHits
-
Number of hits the search query matched.
- nbPages
-
Number of pages of results for the current query.
- nbSortedHits
-
Number of hits selected and sorted by the relevant sort algorithm.
- page
-
Page to retrieve (the first page is
0
, not1
). - params
-
URL-encoded string of all search parameters.
- parsedQuery
-
Post-normalization query string that will be searched.
- processingTimeMS
-
Time the server took to process the request, in milliseconds.
- processingTimingsMS
-
Experimental. List of processing steps and their times, in milliseconds. You can use this list to investigate performance issues.
- query
-
Text to search for in an index.
- queryAfterRemoval
-
Markup text indicating which parts of the original query have been removed to retrieve a non-empty result set.
- serverTimeMS
-
Time the server took to process the request, in milliseconds.
- serverUsed
-
Host name of the server that processed the request.
- userData
-
Lets you store custom data in your indices.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalstrait SearchResultTraittrait SearchResultclass Objecttrait Matchableclass AnyShow all
SearchResponses
SearchResponses
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
SearchResult
SearchResult
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
Attributes
- Companion
- trait
- Supertypes
-
class Objecttrait Matchableclass Any
- Self type
-
SearchResult.type
Attributes
- Supertypes
- Self type
Attributes
- Supertypes
- Known subtypes
-
class SearchResponse
Rules search parameters.
Rules search parameters.
Value parameters
- context
-
Restricts responses to the specified contextual rule.
- enabled
-
Restricts responses to enabled rules. When not specified (default), all rules are retrieved.
- hitsPerPage
-
Maximum number of hits per page.
- page
-
Requested page (the first page is page 0).
- query
-
Rule object query.
- requestOptions
-
Request options to send with the API call.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
SearchRulesResponse
SearchRulesResponse
Value parameters
- hits
-
Fetched rules.
- nbHits
-
Number of fetched rules.
- nbPages
-
Number of pages.
- page
-
Current page.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
object None.typeobject StopIfEnoughMatches.type
none
: executes all queries. -stopIfEnoughMatches
: executes queries one by one, stopping further query execution as soon as a query matches at least thehitsPerPage
number of results.
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
SearchStrategy.type
Attributes
- Supertypes
-
class CustomSerializer[SearchStrategy]trait Serializer[SearchStrategy]class Objecttrait Matchableclass Any
SearchSynonymsParams
SearchSynonymsParams
Value parameters
- query
-
Text to search for in an index.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
SearchSynonymsResponse
SearchSynonymsResponse
Value parameters
- hits
-
Synonym objects.
- nbHits
-
Number of hits the search query matched.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
default
: perform a search query -facet
searches for facet values.
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
SearchTypeDefault.type
Attributes
- Supertypes
-
class CustomSerializer[SearchTypeDefault]trait Serializer[SearchTypeDefault]class Objecttrait Matchableclass Any
default
: perform a search query -facet
searches for facet values.
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
SearchTypeFacet.type
Attributes
- Supertypes
-
class CustomSerializer[SearchTypeFacet]trait Serializer[SearchTypeFacet]class Objecttrait Matchableclass Any
OK
OK
Value parameters
- clusterName
-
Cluster name.
- hitsPerPage
-
Number of hits per page.
- page
-
Page to retrieve (the first page is
0
, not1
). - query
-
Query to search. The search is a prefix search with typo tolerance enabled. An empty query will retrieve all users.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
userIDs data.
userIDs data.
Value parameters
- hits
-
User objects that match the query.
- hitsPerPage
-
Maximum number of hits per page.
- nbHits
-
Number of hits the search query matched.
- page
-
Page to retrieve (the first page is
0
, not1
). - updatedAt
-
Timestamp of the last update in ISO 8601 format.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Settings for the semantic search part of NeuralSearch. Only used when mode
is neuralSearch.
Settings for the semantic search part of NeuralSearch. Only used when mode
is neuralSearch.
Value parameters
- eventSources
-
Indices from which to collect click and conversion events. If null, the current index and replica group will be used as the event source.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
SnippetResult
SnippetResult
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
Attributes
- Companion
- trait
- Supertypes
-
class Objecttrait Matchableclass Any
- Self type
-
SnippetResult.type
Snippeted attributes show parts of the matched attributes. Only returned when attributesToSnippet is non-empty.
Snippeted attributes show parts of the matched attributes. Only returned when attributesToSnippet is non-empty.
Value parameters
- value
-
Markup text with
facetQuery
matches highlighted.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalstrait SnippetResultTraittrait SnippetResultclass Objecttrait Matchableclass AnyShow all
Attributes
- Supertypes
- Self type
Attributes
- Supertypes
- Known subtypes
-
class SnippetResultOption
How to display the remaining items: - count
: facet count (descending). - alpha
: alphabetical (ascending). - hidden
: show only pinned values.
How to display the remaining items: - count
: facet count (descending). - alpha
: alphabetical (ascending). - hidden
: show only pinned values.
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
SortRemainingBy.type
Attributes
- Supertypes
-
class CustomSerializer[SortRemainingBy]trait Serializer[SortRemainingBy]class Objecttrait Matchableclass Any
Source.
Source.
Value parameters
- description
-
Source description.
- source
-
IP address range of the source.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Key-value pairs of supported language ISO codes and boolean values.
Key-value pairs of supported language ISO codes and boolean values.
Value parameters
- compounds
-
Key-value pair of a language ISO code and a boolean value.
- plurals
-
Key-value pair of a language ISO code and a boolean value.
- stopwords
-
Key-value pair of a language ISO code and a boolean value.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Synonym object.
Synonym object.
Value parameters
- corrections
-
Words to be matched in records.
- input
-
Word or phrase to appear in query strings (for
onewaysynonym
s). - objectID
-
Unique identifier of a synonym object.
- placeholder
-
Placeholder token to be put inside records.
- replacements
-
Query words that will match the placeholder token.
- synonyms
-
Words or phrases considered equivalent.
- word
-
Word or phrase to appear in query strings (for
altcorrection1
andaltcorrection2
).
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
object Altcorrection1.typeobject Altcorrection2.typeobject Onewaysynonym.typeobject Placeholder.typeobject Synonym.type
Synonym type.
Synonym type.
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
SynonymType.type
Attributes
- Supertypes
-
class CustomSerializer[SynonymType]trait Serializer[SynonymType]class Objecttrait Matchableclass Any
Filter hits by tags.
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
class SeqOfMixedSearchFiltersclass StringValue
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
TagFilters.type
Attributes
- Supertypes
- Self type
-
TagFiltersSerializer.type
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
object NotPublished.typeobject Published.type
published if the task has been processed, notPublished otherwise.
published if the task has been processed, notPublished otherwise.
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
TaskStatus.type
Attributes
- Supertypes
-
class CustomSerializer[TaskStatus]trait Serializer[TaskStatus]class Objecttrait Matchableclass Any
TimeRange
TimeRange
Value parameters
- from
-
Lower bound of the time range (Unix timestamp).
- until
-
Upper bound of the time range (Unix timestamp).
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Controls whether typo tolerance is enabled and how it is applied.
Controls whether typo tolerance is enabled and how it is applied.
Attributes
- Companion
- object
- Supertypes
-
class Objecttrait Matchableclass Any
- Known subtypes
-
class BooleanValuetrait TypoToleranceTraittrait TypoToleranceEnumobject Min.typeobject Strict.type
Attributes
- Companion
- trait
- Supertypes
-
class Objecttrait Matchableclass Any
- Self type
-
TypoTolerance.type
Attributes
- Companion
- object
- Supertypes
- Known subtypes
TypoToleranceEnum enumeration
TypoToleranceEnum enumeration
Attributes
- Companion
- trait
- Supertypes
-
trait Sumtrait Mirrorclass Objecttrait Matchableclass Any
- Self type
-
TypoToleranceEnum.type
Attributes
- Supertypes
-
class CustomSerializer[TypoToleranceEnum]trait Serializer[TypoToleranceEnum]class Objecttrait Matchableclass Any
Attributes
- Supertypes
- Self type
Attributes
- Supertypes
- Known subtypes
UpdateApiKeyResponse
UpdateApiKeyResponse
Value parameters
- key
-
API key.
- updatedAt
-
Timestamp of the last update in ISO 8601 format.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Response, taskID, and update timestamp.
Response, taskID, and update timestamp.
Value parameters
- taskID
-
Unique identifier of a task. A successful API response means that a task was added to a queue. It might not run immediately. You can check the task's progress with the
task
operation and thistaskID
. - updatedAt
-
Timestamp of the last update in ISO 8601 format.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Response, taskID, unique object identifier, and an update timestamp.
Response, taskID, unique object identifier, and an update timestamp.
Value parameters
- objectID
-
Unique object identifier.
- taskID
-
Unique identifier of a task. A successful API response means that a task was added to a queue. It might not run immediately. You can check the task's progress with the
task
operation and thistaskID
. - updatedAt
-
Timestamp of the last update in ISO 8601 format.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
UpdatedRuleResponse
UpdatedRuleResponse
Value parameters
- objectID
-
Unique object identifier.
- taskID
-
Unique identifier of a task. A successful API response means that a task was added to a queue. It might not run immediately. You can check the task's progress with the
task
operation and thistaskID
. - updatedAt
-
Timestamp of the last update in ISO 8601 format.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
UserHighlightResult
UserHighlightResult
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
UserHit
UserHit
Value parameters
- clusterName
-
Cluster name.
- dataSize
-
Data size taken by all the users assigned to the cluster.
- nbRecords
-
Number of records in the cluster.
- objectID
-
userID of the requested user. Same as userID.
- userID
-
userID of the user.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Unique user ID.
Unique user ID.
Value parameters
- clusterName
-
Cluster to which the user is assigned.
- dataSize
-
Data size used by the user.
- nbRecords
-
Number of records belonging to the user.
- userID
-
userID of the user.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all
Value
Value
Value parameters
- order
-
Pinned order of facet lists.
Attributes
- Supertypes
-
trait Serializabletrait Producttrait Equalsclass Objecttrait Matchableclass AnyShow all