HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunitySubmit a ticketLog In
GitHubNuGetDev CommunitySubmit a ticket

Multiple searches in one request

Describes how to run several Optimizely Search & Navigation searches in one request, which speeds up your search.

When you run multiple searches in one request, an IEnumerable<SearchResults<T> is returned. Below is a simple multi-search example.

results = service.MultiSearch<Article>()
  .Search<Article>(x => x.For("Banana").InField(y => y.Title))
  .Search<Article>(x => x.For("Annanas").InField(y => y.Title))
  .GetResult();

In this example, queries search and return the Article type. Alternatively, you can search for and return different types using Optimizely Search & Navigation projections, as illustrated in the following example.

IEnumerable<SearchResults<string>> results = service.MultiSearch<string>()
  .Search<Article, string>(x => x.For(indexedArticle.Title).InField(y => y.Title).Select(y => y.Title))
  .Search<User, string>(x => x.For(indexedUser.Name).InField(y => y.Name).Select(y => y.Name)).GetResult();

The results are returned in the same way that they are searched for. So, the first result is related to the first query, and so on. Also, these searches only count as one query against the index.

Multi-unified search

A multiple unified search equivalent is also available. Below is a simple multi-unified-search example.

results = service.MultiUnifiedSearch()
  .UnifiedSearch(x => x.For("Banana"))
  .UnifiedSearch(x => x.For("Annanas"))
  .GetResult();

You can also specify your hit specification with customized highlighting for each search, as illustrated in the following example.

results = service.MultiUnifiedSearch()
  .UnifiedSearch(x => x.For("Banana"), new HitSpecification
    { 
      HighlightTitle = true,
      HighlightExcerpt = true,
      PostTagForAllHighlights = "</strong>",
      PreTagForAllHighlights = "<strong>" 
    })
  .UnifiedSearch(x => x.For("Annanas"), new HitSpecification
    { 
      HighlightTitle = true,
      HighlightExcerpt = true,
      PostTagForAllHighlights = "</em>",
      PreTagForAllHighlights = "<em>"
    })
  .GetResult();

Maximum number of searches

For performance reasons, one multi-search request can create up to 10 searches.