Refresh Bing Autosuggest API quickstarts

Author: dksimpson

articles/cognitive-services/Bing-Autosuggest/quickstarts/csharp.md

@@ -1,25 +1,25 @@
 ---
 title: "Quickstart: Suggest search queries with the Bing Autosuggest REST API and C#"
 titleSuffix: Azure Cognitive Services
-description: Learn how to quickly start suggesting search terms in real-time with the Bing Autosuggest API.
+description: Learn how to quickly start suggesting search terms in real time with the Bing Autosuggest API.
 services: cognitive-services
 author: aahill
 manager: nitinme
 
 ms.service: cognitive-services
 ms.subservice: bing-autosuggest
 ms.topic: quickstart
-ms.date: 03/24/2020
+ms.date: 05/06/2020
 ms.author: aahi
 ---
 # Quickstart: Suggest search queries with the Bing Autosuggest REST API and C#
 
-Use this quickstart to begin making calls to the Bing Autosuggest API and getting the JSON response. This simple C# application sends a partial search query to the API, and returns suggestions for searches. While this application is written in C#, the API is a RESTful Web service compatible with most programming languages. The source code for this sample is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/dotnet/Search/BingAutosuggestv7.cs).
+Follow this quickstart to learn how to make calls to the Bing Autosuggest API and read the JSON response. This simple C# application sends a partial search query to the API, and returns suggestions for searches. While this application is written in C#, the API is a RESTful Web service compatible with most programming languages. The source code for this sample is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/dotnet/Search/BingAutosuggestv7.cs).
 
 ## Prerequisites
 
 * Any edition of [Visual Studio 2017 or later](https://www.visualstudio.com/downloads/).
-* If you are using Linux/MacOS, this application can be run using [Mono](https://www.mono-project.com/).
+* If you're using Linux/MacOS, this application can be run using [Mono](https://www.mono-project.com/).
 
 [!INCLUDE [cognitive-services-bing-news-search-signup-requirements](../../../../includes/cognitive-services-bing-autosuggest-signup-requirements.md)]
 
@@ -35,7 +35,7 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
     using System.Text;
     ```
 
-2. In a new class, create variables for your API host and path, [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and a partial search query. You can use the global endpoint below, or the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
+2. In a new class, create variables for your API host and path, [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and a partial search query. Use the global endpoint in the following code, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
 
     ```csharp
     static string host = "https://api.cognitive.microsoft.com";

articles/cognitive-services/Bing-Autosuggest/quickstarts/java.md

@@ -1,22 +1,21 @@
 ---
 title: "Quickstart: Suggest search queries with the Bing Autosuggest REST API and Java"
 titleSuffix: Azure Cognitive Services
-description: Learn how to quickly start suggesting search terms in real-time with the Bing Autosuggest API.
+description: Learn how to quickly start suggesting search terms in real time with the Bing Autosuggest API.
 services: cognitive-services
 author: aahill
 manager: nitinme
 
 ms.service: cognitive-services
 ms.subservice: bing-autosuggest
 ms.topic: quickstart
-ms.date: 03/24/2020
+ms.date: 05/06/2020
 ms.author: aahi
 ---
 
 # Quickstart: Suggest search queries with the Bing Autosuggest REST API and Java
 
-
-Use this quickstart to begin making calls to the Bing Autosuggest API and getting the JSON response. This simple Java application sends a partial search query to the API, and returns suggestions for searches. While this application is written in Java, the API is a RESTful Web service compatible with most programming languages. The source code for this sample is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/java/Search/BingAutosuggestv7.java)
+Follow this quickstart to learn how to make calls to the Bing Autosuggest API and read the JSON response. This simple Java application sends a partial search query to the API, and returns suggestions for searches. While this application is written in Java, the API is a RESTful Web service compatible with most programming languages. The source code for this sample is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/java/Search/BingAutosuggestv7.java)
 
 ## Prerequisites
 
@@ -40,7 +39,7 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
     import com.google.gson.JsonParser;
     ```
 
-2. Create variables for your subscription key, the API host and path, your [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and a search query. You can use the global endpoint below, or the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
+2. Create variables for your subscription key, the API host and path, your [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and a search query. Use the global endpoint below, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
 
     ```java
     static String subscriptionKey = "enter key here";
@@ -69,7 +68,7 @@ public static String prettify(String json_text) {
 
 1. Create a new method named  `get_suggestions()` and perform the following steps:
 
-   1. construct the URL for your request by combining your API host, path, and encoding your search query. Be sure to url-encode the query before appending it. Create a parameters string for your query by appending the market code to the `mkt=` parameter, and your query to the `q=` parameter.
+   1. Construct the URL for your request by combining your API host, path, and encoding your search query. Be sure to url-encode the query before appending it. Create a parameters string for your query by appending the market code to the `mkt=` parameter, and your query to the `q=` parameter.
     
       ```java
   
@@ -80,7 +79,7 @@ public static String prettify(String json_text) {
       }
       ```
     
-   2. Create a new URL for the request with the API host, path, and parameters created above. 
+   2. Create a new URL for the request with the API host, path, and parameters that you created in the previous step. 
     
        ```java
        //...
@@ -99,7 +98,7 @@ public static String prettify(String json_text) {
        //...
       ```
 
-   4. Read in the API response to a `StringBuilder`. After the response has been captured, close the `InputStreamReader` stream, and return the response.
+   4. Store the API response in `StringBuilder`. After the response has been captured, close the `InputStreamReader` stream, and return the response.
 
        ```java
        //...
@@ -115,7 +114,7 @@ public static String prettify(String json_text) {
        return response.toString();
        ```
 
-2. In the main function of your application, call `get_suggestions()`, and print the response using `prettify()`.
+2. In the main function of your application, call `get_suggestions()`, and print the response by using `prettify()`.
     
     ```java
     public static void main(String[] args) {

articles/cognitive-services/Bing-Autosuggest/quickstarts/nodejs.md

@@ -1,21 +1,21 @@
 ---
 title: "Quickstart: Suggest search queries with the Bing Autosuggest REST API and Node.js"
 titleSuffix: Azure Cognitive Services
-description: Learn how to quickly start suggesting search terms in real-time with the Bing Autosuggest API.
+description: Learn how to quickly start suggesting search terms in real time with the Bing Autosuggest API.
 services: cognitive-services
 author: aahill
 manager: nitinme
 
 ms.service: cognitive-services
 ms.subservice: bing-autosuggest
 ms.topic: quickstart
-ms.date: 03/24/2020
+ms.date: 05/06/2020
 ms.author: aahi
 ---
 
 # Quickstart: Suggest search queries with the Bing Autosuggest REST API and Node.js
 
-Use this quickstart to begin making calls to the Bing Autosuggest API and getting the JSON response. This simple Node.js application sends a partial search query to the API, and returns suggestions for searches. While this application is written in JavaScript, the API is a RESTful Web service compatible with most programming languages. The source code for this sample is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/nodejs/Search/BingAutosuggestv7.js)
+Follow this quickstart to learn how to make calls to the Bing Autosuggest API and read the JSON response. This simple Node.js application sends a partial search query to the API, and returns suggestions for searches. While this application is written in JavaScript, the API is a RESTful Web service compatible with most programming languages. The source code for this sample is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/nodejs/Search/BingAutosuggestv7.js)
 
 ## Prerequisites
 
@@ -33,7 +33,7 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
     let https = require ('https');
     ```
 
-2. Create variables for the API endpoint host and path, your subscription key, [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and a search term. You can use the global endpoint below, or the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
+2. Create variables for the API endpoint host and path, your subscription key, [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and a search term. Use the global endpoint in the following code, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
 
     ```javascript
     // Replace the subscriptionKey string value with your valid subscription key.
@@ -48,7 +48,7 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
 
 ## Construct the search request and query.
 
-1. Create a parameters string for your query by appending the market code to the `mkt=` parameter, and your query to the `q=` parameter.
+1. Create a parameters string for your query by appending the market code to the `mkt=` parameter, and your query to the `&q=` parameter.
 
     ```javascript 
     let params = '?mkt=' + mkt + '&q=' + query;
@@ -70,17 +70,18 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
     }
     ```
 
-    1. In the same function, use the request library to send your query to the API. `response_handler` will be defined in the next section.
+ 1. In the same function, use the request library to send your query to the API. `response_handler` is defined in the next section.
     
-        ```javascript
+    ```javascript
         //...
         let req = https.request(request_params, response_handler);
         req.end();
         ```
 
 ## Create a search handler
 
-1. define a function named `response_handler` that takes an HTTP call, `response`, as a parameter. Do the following steps within this function:
+1. Define a function named `response_handler` that takes an HTTP call, `response`, as a parameter. 
+Do the following steps within this function:
     
     1. Define a variable to contain the body of the JSON response.  
 
@@ -90,15 +91,15 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
         };
         ```
 
-    2. Store the body of the response when the **data** flag is called
+    2. Store the body of the response when the `data` flag is called
         
         ```javascript
         response.on ('data', function (d) {
         body += d;
         });
         ```
 
-    3. When an **end** flag is signaled, user `JSON.parse()` and `JSON.stringify()` to print the response.
+    3. When an `end` flag is signaled, use `JSON.parse()` and `JSON.stringify()` to print the response.
     
         ```javascript
         response.on ('end', function () {

articles/cognitive-services/Bing-Autosuggest/quickstarts/php.md

@@ -1,21 +1,21 @@
 ---
 title: "Quickstart: Suggest search queries with the Bing Autosuggest REST API and PHP"
 titleSuffix: Azure Cognitive Services
-description: Learn how to quickly start suggesting search terms in real-time with the Bing Autosuggest API.
+description: Learn how to quickly start suggesting search terms in real time with the Bing Autosuggest API.
 services: cognitive-services
 author: aahill
 manager: nitinme
 
 ms.service: cognitive-services
 ms.subservice: bing-autosuggest
 ms.topic: quickstart
-ms.date: 03/24/2020
+ms.date: 05/06/2020
 ms.author: aahi
 ---
 
 # Quickstart: Suggest search queries with the Bing Autosuggest REST API and PHP
 
-Use this quickstart to begin making calls to the Bing Autosuggest API and getting the JSON response. This simple PHP application sends a partial search query to the API, and returns suggestions for searches. While this application is written in PHP, the API is a RESTful Web service compatible with most programming languages.
+Follow this quickstart to learn how to make calls to the Bing Autosuggest API and read the JSON response. This simple PHP application sends a partial search query to the API, and returns suggestions for searches. While this application is written in PHP, the API is a RESTful Web service compatible with most programming languages.
 
 ## Prerequisites
 
@@ -27,8 +27,8 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
 
 1. Create a new PHP project in your favorite IDE.
 2. Add the code provided below.
-3. Replace the `subscriptionKey` value with an access key valid for your subscription.
-4. You can use the global endpoint below, or the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
+3. Replace the `subscriptionKey` value with an access key that's valid for your subscription.
+4. Use the global endpoint in the code, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
 5. Run the program.
 
 ```php
@@ -76,7 +76,7 @@ echo json_encode (json_decode ($result), JSON_PRETTY_PRINT);
 ?>
 ```
 
-### Response
+## Example JSON response
 
 A successful response is returned in JSON, as shown in the following example: 
 

articles/cognitive-services/Bing-Autosuggest/quickstarts/python.md

@@ -1,20 +1,20 @@
 ---
 title: "Quickstart: Suggest search queries with the Bing Autosuggest REST API and Python"
 titleSuffix: Azure Cognitive Services
-description: Learn how to quickly start suggesting search terms in real-time with the Bing Autosuggest API.
+description: Learn how to quickly start suggesting search terms in real time with the Bing Autosuggest API.
 services: cognitive-services
 author: aahill
 manager: nitinme
 
 ms.service: cognitive-services
 ms.subservice: bing-autosuggest
 ms.topic: quickstart
-ms.date: 03/24/2020
+ms.date: 05/06/2020
 ms.author: aahi
 ---
 # Quickstart: Suggest search queries with the Bing Autosuggest REST API and Python
 
-Use this quickstart to begin making calls to the Bing Autosuggest API and getting the JSON response. This simple Python application sends a partial search query to the API, and returns suggestions for searches. While this application is written in Python, the API is a RESTful Web service compatible with most programming languages. The source code for this sample is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/python/Search/BingAutosuggestv7.py)
+Follow this quickstart to learn how to make calls to the Bing Autosuggest API and read the JSON response. This simple Python application sends a partial search query to the API, and returns suggestions for searches. While this application is written in Python, the API is a RESTful Web service compatible with most programming languages. The source code for this sample is available on [GitHub](https://github.com/Azure-Samples/cognitive-services-REST-api-samples/blob/master/python/Search/BingAutosuggestv7.py)
 
 ## Prerequisites
 
@@ -30,7 +30,7 @@ Use this quickstart to begin making calls to the Bing Autosuggest API and gettin
     import http.client, urllib.parse, json
     ```
 
-2. Create variables for your API host and path, [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and a partial search query. You can use the global endpoint below, or the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
+2. Create variables for your API host and path, [market code](https://docs.microsoft.com/rest/api/cognitiveservices-bingsearch/bing-autosuggest-api-v7-reference#market-codes), and partial search query. Use the global endpoint in the following code, or use the [custom subdomain](../../../cognitive-services/cognitive-services-custom-subdomains.md) endpoint displayed in the Azure portal for your resource.
 
     ```python
     subscriptionKey = 'enter key here'