Merge pull request #43907 from allantargino/patch-2

Adding filters and selectors

Author: Jak-MS

articles/search/search-more-like-this.md

@@ -22,28 +22,50 @@ ms.date: 11/04/2019
 
 By default, the contents of all top-level searchable fields are considered. If you want to specify particular fields instead, you can use the `searchFields` parameter. 
 
-You cannot use moreLikeThis on searchable sub-fields in a [complex type](search-howto-complex-data-types.md).
+You cannot use `MoreLikeThis` on searchable sub-fields in a [complex type](search-howto-complex-data-types.md).
 
-## Examples 
+## Examples
 
-Below is an example of a moreLikeThis query. The query finds documents whose description fields are most similar to the field of the source document as specified by the `moreLikeThis` parameter.
+All following examples use the hotels sample from [Quickstart: Create a search index in the Azure portal](search-get-started-portal.md).
+
+### Simple query
+
+The following query finds documents whose description fields are most similar to the field of the source document as specified by the `moreLikeThis` parameter:
 
 ```
-Get /indexes/hotels/docs?moreLikeThis=1002&searchFields=description&api-version=2019-05-06-Preview
+GET /indexes/hotels-sample-index/docs?moreLikeThis=29&searchFields=Description&api-version=2019-05-06-Preview
 ```
 
+In this example, the request searches for hotels similar to the one with `HotelId` 29.
+Rather than using HTTP GET, you can also invoke `MoreLikeThis` using HTTP POST:
+
 ```
-POST /indexes/hotels/docs/search?api-version=2019-05-06-Preview
+POST /indexes/hotels-sample-index/docs/search?api-version=2019-05-06-Preview
     {
-      "moreLikeThis": "1002",
-      "searchFields": "description"
+      "moreLikeThis": "29",
+      "searchFields": "Description"
     }
 ```
 
+### Apply filters
+
+`MoreLikeThis` can be combined with other common query parameters like `$filter`. For instance, the query can be restricted to only hotels whose category is 'Budget' and where the rating is higher than 3.5:
+
+```
+GET /indexes/hotels-sample-index/docs?moreLikeThis=20&searchFields=Description&$filter=(Category eq 'Budget' and Rating gt 3.5)&api-version=2019-05-06-Preview
+```
+
+### Select fields and limit results
+
+The `$top` selector can be used to limit how many results should be returned in a `MoreLikeThis` query. Also, fields can be selected with `$select`. Here the top three hotels are selected along with their ID, Name, and Rating: 
+
+```
+GET /indexes/hotels-sample-index/docs?moreLikeThis=20&searchFields=Description&$filter=(Category eq 'Budget' and Rating gt 3.5)&$top=3&$select=HotelId,HotelName,Rating&api-version=2019-05-06-Preview
+```
 
 ## Next steps
 
 You can use any web testing tool to experiment with this feature.  We recommend using Postman for this exercise.
 
 > [!div class="nextstepaction"]
-> [Explore Azure Cognitive Search REST APIs using Postman](search-get-started-postman.md)
+> [Explore Azure Cognitive Search REST APIs using Postman](search-get-started-postman.md)