🎉 Try the public beta of the new docs site at algolia.com/doc-beta! 🎉
UI libraries / InstantSearch iOS / Widgets

Searcher

About this widget

Objects conforming to the Searcher protocol manage the search sessions.

Algolia provides you with several out of the box searchers to help build your InstantSearch experience:

  • HitsSearcher: searches a single index.
  • FacetSearcher: searches for facet values.
  • MultiSearcher: aggregates the hits and facet searchers. This is useful for a federated search, or query suggestions .
  • AnswersSearcher: searches an index for Answers.
See code examples

Examples

Instantiate a HitsSearcher.

Copy 
1
2
3

let searcher = HitsSearcher(appID: "YourApplicationID",
                            apiKey: "YourSearchOnlyApiKey",
                            indexName: "index_name")

Instantiate a FacetSearcher.

Copy 
1
2
3
4

let searcher = FacetSearcher(appID: "YourApplicationID",
                             apiKey: "YourSearchOnlyApiKey",
                             indexName: "index_name",
                             facetName: "facet_name")

Instantiate a MultiSearcher.

Copy 
1
2
3
4
5
6

let searcher = MultiSearcher(appID: "YourApplicationID",
                             apiKey: "YourSearchOnlyApiKey")
searcher.addHitsSearcher(indexName: "index_name1")
searcher.addFacetsSearcher(indexName: "index_name1", 
                            attribute: "facet_name")
searcher.addHitsSearcher(indexName: "index_name2")

Instantiate a AnswersSearcher

Copy 
1
2
3

let searcher = AnswersSearcher(appID: "YourApplicationID", 
                               apiKey: "YourSearchOnlyApiKey", 
                               indexName: "index_name")

HitsSearcher

Parameter Description
indexName
type: String
Required

The index to search.
Copy 
1
2
3

let searcher = HitsSearcher(appID: "YourApplicationID",
                            apiKey: "YourSearchOnlyApiKey",
                            indexName: "index_name")
query
type: Query
default: Query()
Optional

The query used when doing a search.
Copy 
1
2
3
4
5
6

let query = Query()
query.analytics = true
let searcher = HitsSearcher(appID: "YourApplicationID",
                            apiKey: "YourSearchOnlyApiKey",
                            indexName: "index_name",
                            query: query)

FacetSearcher

Parameter Description
indexName
type: String
Required

The index to search into.
Copy 
1
2
3

let searcher = FacetSearcher(appID: "YourApplicationID",
                             apiKey: "YourSearchOnlyApiKey",
                             indexName: "index_name")
facetName
type: String
Required

The facet name to search into when doing search for facet values.
Copy 
1
2
3
4

let searcher = FacetSearcher(appID: "YourApplicationID",
                             apiKey: "YourSearchOnlyApiKey",
                             indexName: "index_name",
                             facetName: "facet_name")
query
type: Query
default: Query()
Optional

The Query used when doing a search.
Copy 
1
2
3
4
5
6

let query = Query()
query.analytics = true
let searcher = FacetSearcher(appID: "YourApplicationID",
                             apiKey: "YourSearchOnlyApiKey",
                             indexName: "index_name",
                             query: query)

AnswersSearcher

Parameter Description
indexName
type: String
Required

The index to search into for Answers.
Copy 
1
2
3

let searcher = AnswersSearcher(appID: "YourApplicationID", 
                              apiKey: "YourSearchOnlyApiKey", 
                              indexName: "index_name")
query
type: AnswersQuery
Optional

The query used when performing an Answers search.
Copy 
1
2
3
4
5
6
7
8
9

let query = AnswersQuery(query: "when do babies start learning?")
  .set(\.queryLanguages, to: [.english])
  .set(\.attributesForPrediction, to: ["description", "title", "transcript"])
  .set(\.nbHits, to: 20)

let searcher = AnswersSearcher(appID: "YourApplicationID", 
                               apiKey: "YourSearchOnlyApiKey", 
                               indexName: "index_name",
                               query: query)

Methods

Parameter Description

Triggers the search. Notifies all listeners of the results.
Copy 
1

searcher.search()
cancel

Cancels all ongoing search requests.
Copy 
1

searcher.cancel()

Events

Parameter Description
isLoading

Triggered when the Searcher starts or finishes query execution.
Copy 
1
2
3

searcher.isLoading.subscribe(with: self) { (_, isLoading) in
  
}
onQueryChanged

Triggered when the query text is modified.
Copy 
1
2
3

searcher.onQueryChanged.subscribe(with: self) { (_, query) in
  
}
onResults

Triggered when a new search result is received.
Copy 
1
2
3

searcher.onResults.subscribe(with: self) { (_, results) in

}
onError

Triggered when a new error is received.
Copy 
1
2
3
4

searcher.onError.subscribe(with: self) { (_, args) in
  let (query, error) = args

}
Did you find this page helpful?
InstantSearch iOS v7