--- title: Read async API for .NET Client slug: cms-12/docs/read-async docTags: createdAt: 2026-08-10T15:56:02.000Z --- :::hint{type="info"} **Note** Optimizely Search & Navigation has asynchronous methods that are supported only in the .NET Core version. ::: You can leverage the benefits of asynchronous programming and performance improvements with the **Read** and [Write](docId\:t5kGRz69InGso9PpUxkDO) async APIs, which are particularly necessary and useful if you are building your app with a microservices architecture or loading data from the FIND service and UI independently for better user experiences. ## Get results ### GetContentResultAsync() Perform an asynchronous request of `ITypeSearch` and allow caching for your search results. When executed in context of a user without edit or admin access `cacheForEditorsAndAdmins` is true the search request is cached for `cacheForSeconds` seconds. ```csharp //single search var result = await _searchClient.Search().For("banana").GetContentResultAsync(); //multiple search var results = await _searchClient.MultiSearch() .Search(s1 => s1.For("banana").InField(x => x.Name)) .Search(s2 => s2.For("strawberry").InField(x => x.SearchTitle())) .GetContentResultAsync(); ``` - Parameters – - Required parameters – no required parameter. - Optional parameters – `cacheForSeconds` the results will be cached in seconds, default is -1 if `cacheForEditorsAndAdmins` is false or 60 seconds if `cacheForEditorsAndAdmins` is true. - Return value – - Return type an awaitable `Task>` if you do a single search. - Return an awaitable `Task>>` if you do a multiple search. ### GetPagesResultAsync() Perform a non-blocking search by using `GetResultAsync`. This will get `PageData` type only based on the language (auto detect). ```csharp var articalePages = await _searchClient.Search().For("alloy").GetPagesResultAsync(); ``` - Parameters – no required parameter. - Return value – return an awaitable `Task>` where `TPageData` is assignable from PageData. ### GetResultAsync() Perform an non-blocking search request to FIND backend. ```csharp var results = await _searchClient.Search() .For("banana") .GetResultAsync(); ``` - Parameters – no required parameter. - Return Value – - Return an awaitable `Task>` with normal search. - Return an awaitable `Task` if you do a UnifiedSearch. ### GetAsync() Perform a non-blocking request to retrieve the document(s); this will help the client obtain the documents simultaneously. - Parameters – Require a document id or an `IEnumerable` of ids. Have some other overloading method. - Return value – - Returns an awaitable `Task` if parameter is a document’s id. - Returns an awaitable `Task>>` if parameter is an `IEnumerable` of id(s). ```csharp var doc = await _searchClient.GetAsync("your_existing_document_id"); var docs = await _searchClient.GetAsync(new List(){1,2,3});//get documents with id=1,2,3 var mydocs = await _searchClient.GetAsync(1, 2, 3);//if ClientExtensions is used. ``` ### GetWithMetaAsync() Similar to `GetAsync()`, the only difference is this method returns the indexed object wrapped in a `GetResult` object. A typical use case for this method is retrieving the object and its version number, which you can use in optimistic concurrency checks (and update objects only if they have not changed because they are being fetched). `DeleteAsync()` – Perform a non-blocking delete document(s) to your index. - Parameters – Require a document id and type of document. - Return value – Return an awaitable `Task`. ```csharp await _searchClient.DeleteAsync(123); //or await _searchClient.DeleteAsync(typeof(MyDocument), 123, null); ``` ## Searches ### SearchAsync() Design to perform an asynchronous search request. If your site startup depends on FIND, this could be useful while your page’s areas could load in parallel. This method is used in `GetResultAsync()`. - Parameters – Require an awaitable `SearchRequestBody` object when you call this method directly or use `GetResultAsync` when use normal search. - Return value – Return an awaitable `Task>`. ```csharp var docs1 = await _searchClient.Search() .For("banana") .GetResultAsync(); //or you can build your own query var criteria = new TermsQuery("tags", new FieldFilterValue[] { "vegetable", "fruits" }); var docs2 = await _searchClient.SearchAsync(new SearchRequestBody(){Query=criteria}, cmd=> cmd.LanguageRouting = "en"); ``` ### MultiSearchAsync() Similar the `SearchAsync` this method perform a non-blocking request of multiple searches. This method is used in `GetContentResultAsync()`. - Parameters – Require an `IEnumerable` of `SearchRequestBody` or just call to `GetContentResultAsync`. - Return value – - Returns an awaitable `Task>>` when you call to `MultiSearchAsync` directly. - Returns an awaitable `Task>>` when call to `GetContentResultAsync`. ```csharp var docs= await _searchClient.MultiSearch() .Search(x => x.For("banana").InField(f => f.Name)) .Search(x => x.For("apple").InField(f => f.Name)) .GetContentResultAsync(); ``` ### SearchForTypeAsync() Like `SearchAsync`, this method is used for searching documents of a type. - Parameters – Require a `SearchRequestBody`. - Return value – Return an awaitable `Task>`. ```csharp var searchRequest = new SearchRequestBody(); searchRequest.Query = new QueryStringQuery("Bacon"); searchRequest.Highlight.Fields.Add(fieldName); searchResult= await _searchClient.SearchForTypeAsync(searchRequest, null); ``` ## Statistics ### GetAutocompleteAsync()/StatisticsAutocompleteAsync() Perform a non-blocking request to get autocomplete list by a prefix string. This is used in `StatisticsAutocompleteAsync` when using `Find.Statistics` extensions. - Parameters – - Required parameters – Prefix string parameter is required. - Optional parameter – Size and Tags are optional parameters. - Return value – Return an awaitable `Task` contains list of autocomplete in `AutocompleteResult` object. ```csharp await _searchClient.Statistics().StatisticsAutocompleteAsync("prefix",size=5); ``` ### GetDidYouMeanAsync()/StatisticsDidYouMeanAsync() Perform a non-blocking request to get list of related query. Use `StatisticsDidYouMeanAsync` as the same functionality when using `Find.Statistics` extensions. - Parameters – - Required parameters – A query string is required. - Optional parameter – `Size` and `Tags` are optional parameters. - Return value – Return an awaitable `Task` contains list of `didyoumean` items in `DidYouMeanResult` object. ```csharp await _searchClient.Statistics().StatisticsDidYouMeanAsync("fruits",size=3); ``` ### GetSpellcheckAsync()/StatisticsSpellcheckAsync() Perform a non-blocking request to check spelling of a query. Use `StatisticsSpellcheckAsync` as the same functionality when using `Find.Statistics` extensions. - Parameters – - Required parameters – A query string is required. - Optional parameter – `Size` and `Tags` are optional parameters. - Return value – Return an awaitable `Task`. ```csharp await _searchClient.Statistics().StatisticsSpellcheckAsync("banan",size=1); ```