getAlgoliaResults

Autocomplete is also available as an experimental widget in InstantSearch, making it easier to integrate into your search experience. For more information, see the API reference for InstantSearch.js or React InstantSearch.

The getAlgoliaResults function lets you query one or several Algolia indices. Using getAlgoliaResults lets Autocomplete batch all queries using the same search client into a single network call, and thus minimize search unit consumption. It also works out of the box with the components exposed in templates.

Example

This example uses the function along with the algoliasearch API client.

JavaScript

import { liteClient as algoliasearch } from "algoliasearch/lite";
import { autocomplete, getAlgoliaResults } from "@algolia/autocomplete-js";

const searchClient = algoliasearch(
  "latency",
  "6be0576ff61c053d5f9a3225e2a90f76",
);

autocomplete({
  // ...
  getSources({ query }) {
    return [
      {
        sourceId: "products",
        getItems({ query }) {
          return getAlgoliaResults({
            searchClient,
            queries: [
              {
                indexName: "instant_search",
                params: {
                  query,
                  hitsPerPage: 5,
                },
              },
            ],
          });
        },
        // ...
      },
    ];
  },
});

When using getAlgoliaFacets and getAlgoliaResults with the same search client in different sources or plugins, Autocomplete batches all queries into a single network call to Algolia. If you’re using the same search client for different sources or plugins, make sure to use the same instance to leverage the internal cache and batching mechanism.

Parameters

searchClient

SearchClient

required

The initialized Algolia search client.

queries

MultipleQueriesQuery[]

required

The queries to perform.

Show MultipleQueriesQuery properties

MultipleQueriesQuery.indexName

string

required

The name.

MultipleQueriesQuery.query

string

required

The query to search for.

MultipleQueriesQuery.params

SearchParameters

Algolia search parameters.These are the default search parameters. You can leave them as is and specify other parameters, or override them.

JSON

{
  "hitsPerPage": 5,
  "highlightPreTag": "__aa-highlight__",
  "highlightPostTag": "__/aa-highlight__"
}

transformResponse

function

Type definition

(response: {
  results: Array<SearchResponse<THit> | SearchForFacetValuesResponse>;
  hits: MaybeArray<Hit<THit>[]>;
  facetHits: MaybeArray<FacetHit[]>;
}) => MaybeArray<Hit<THit>[] | FacetHit[]>;

The function to transform the Algolia response before passing it to the Autocomplete state. You have access to the full Algolia results, as well as the pre-computed hits and facet hits. This is useful to manipulate the hits, or store data from the results in the context.This is the default implementation:

JavaScript

getAlgoliaResults({
  // ...
  transformResponse({ hits }) {
    return hits;
  },
});

Returns

The function returns:

TypeScript

{
  searchClient: SearchClient;
  queries: MultipleQueriesQuery[];
  transformResponse: TransformResponse<THit>;
  execute: Execute<THit>;
}

​Example

​Parameters

​Returns

Example

Parameters

Returns