algoliasearch/src/main/java/com/algolia/search/saas/Index.java
public Request searchForFacetValuesAsync(@NonNull String facetName, @NonNull String facetText, @Nullable Query query, @NonNull final CompletionHandler handler) {
        return searchForFacetValuesAsync(facetName, facetText, query, /* requestOptions: */ null, handler);
    }
public Request searchForFacetValuesAsync(@NonNull String facetName, @NonNull String facetText, @Nullable Query query, @NonNull final CompletionHandler handler) {
        return searchForFacetValuesAsync(facetName, facetText, query, /* requestOptions: */ null, handler);
    }
Searches for some text in a facet values, optionally restricting the returned values to those contained in objects matching other (regular) search criteria.

@param facetName The name of the facet to search. It must have been declared in the index's `attributesForFaceting` setting with the `searchable()` modifier.
@param facetText The text to search for in the facet's values.
@param query     An optional query to take extra search parameters into account. There parameters apply to index objects like in a regular search query. Only facet values contained in the matched objects will be returned
@param handler   A Completion handler that will be notified of the request's outcome.
@return A cancellable request.