Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Non working links update #140

Draft
wants to merge 25 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
25 commits
Select commit Hold shift + click to select a range
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
540 changes: 540 additions & 0 deletions .openpublishing.redirection.json

Large diffs are not rendered by default.

162 changes: 162 additions & 0 deletions .vscode/settings.json
Original file line number Diff line number Diff line change
@@ -1,5 +1,163 @@
{
"cSpell.words": [
<<<<<<< HEAD
<<<<<<< HEAD
=======
>>>>>>> 2c771186b1a7e59ee906c686cf2acb991eb462f4
"accentcolor",
"acceptlanguage",
"activetab",
"adultintent",
"allowhttpsembed",
"allowmobileembed",
"alon",
"alterationoverridequery",
"alteredquery",
"answertype",
"aoverviewtab",
"bingautosuggest",
"bingcustomsearch",
"bingentitysearchapi",
"bingspellcheck",
"bingvisualsearch",
"Bothell",
"brocky",
"Bsaling",
"Busj",
"classpath",
"clientid",
"clientip",
"Clipart",
"cognitiveservices",
"consuminghostedui",
"contentsize",
"contenturl",
"customconfig",
"customsearch",
"datelastcrawled",
"datepublished",
"Dcve",
"DDTHH",
"deeplinks",
"disp",
"displaytext",
"displayurl",
"Divs",
"docon",
"doutdoor",
"embeddable",
"embedhtml",
"encodingformat",
"entitysearch",
"errmsg",
"fcanadian",
"fdiscover",
"fimages",
"fsearch",
"fwww",
"gifs",
"gson",
"Gson",
"GSON",
"hostpagedisplayurl",
"hostpageurl",
"imagecontent",
"imageid",
"imagesearch",
"imagetype",
"isaccessibleforfree",
"issuperfresh",
"javac",
"javax",
"jsobj",
"keyvalue",
"KHTML",
"latlong",
"lowerthan",
"Lucida",
"Lumia",
"Lxxg",
"mainentity",
"mapquery",
"maxfilesize",
"maxheight",
"maxwidth",
"MFOI",
"minfilesize",
"minheight",
"minwidth",
"moredetails",
"motionthumbnailurl",
"MSIE",
"mylabsplus",
"NABP",
"newssearch",
"nextoffset",
"noresults",
"originalquery",
"othercitytimes",
"pivotsuggestions",
"primarycitytime",
"println",
"querycontext",
"queryexpansion",
"queryexpansions",
"queryurl",
"rankinggroup",
"rankingitem",
"relatedsearch",
"resultindex",
"retryafter",
"safesearch",
"sailboatdata",
"sailflow",
"sailrite",
"sailstn",
"sailusfood",
"saling",
"SDRE",
"searchaction",
"searchkind",
"searchresponse",
"searchsuggestions",
"searchtags",
"searchurl",
"similarterms",
"someresultsremoved",
"spellsuggestions",
"strato",
"subcode",
"subpage",
"Subpage",
"subpages",
"subscriptionkey",
"suggestgroup",
"suggestiongroups",
"Superfresh",
"technet",
"textdecorations",
"textformat",
"thumbnailurl",
"totalestimatedmatches",
"totalmatches",
"traceid",
"utcoffset",
"Verdana",
"videoid",
"videolength",
"videosearch",
"viewcount",
"visualsearch",
"webanswer",
"websearch",
"websearchurl",
"wwwroot",
<<<<<<< HEAD
"yourkeygoeshere"
=======
=======
"yourkeygoeshere",
>>>>>>> 2c771186b1a7e59ee906c686cf2acb991eb462f4
"areen't",
"Divs",
"docon",
Expand All @@ -11,5 +169,9 @@
"mapquery",
"noresults",
"queryurl"
<<<<<<< HEAD
>>>>>>> main
=======
>>>>>>> 2c771186b1a7e59ee906c686cf2acb991eb462f4
]
}
Original file line number Diff line number Diff line change
Expand Up @@ -3,14 +3,13 @@ title: Upgrade Bing Autosuggest API v5 to v7
titleSuffix: Bing Search Services
description: This upgrade guide identifies the changes between version 5 and version 7 of the Bing Autosuggest API. Use this guide to help update your application to use version 7.
services: bing-search-services
author: swhite-msft
author: alekhyasasi
ms.author: v-alpunnamar
manager: ehansen

ms.service: bing-search-services
ms.subservice: bing-autosuggest
ms.topic: conceptual
ms.date: 07/15/2020
ms.author: scottwhi
ms.date: 09/27/2023
---

# Autosuggest API upgrade guide
Expand All @@ -21,13 +20,12 @@ This upgrade guide identifies the changes between version 5 and version 7 of the

### Endpoints

- Changed the `cognitive` subdomain to `bing`.
- Changed the `cognitive` subdomain to `bing`.
- Changed the endpoint's version number from v5 to v7.
- Removed the `/bing` folder.

New search endpoint: `https://api.bing.microsoft.com/v7.0/suggestions`


### Error response objects and error codes

- All failed requests should now include an `ErrorResponse` object in the response body.
Expand Down
18 changes: 6 additions & 12 deletions bing-docs/bing-autosuggest/how-to/get-suggestions.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,35 +3,32 @@ title: Suggesting search terms with the Bing Autosuggest API
titleSuffix: Bing Search Services
description: Use Bing Autosuggest API to improve your users' search box experience by providing a list of suggested query strings with each character they type.
services: bing-search-services
author: swhite-msft
author: alekhyasasi
ms.author: v-alpunnamar
manager: ehansen
ms.service: bing-search-services
ms.subservice: bing-autosuggest
ms.topic: conceptual
ms.date: 07/15/2020
ms.author: scottwhi
ms.date: 09/27/2023
---

# Getting query string suggestions

Use Bing Autosuggest API to improve your users' search box experience by providing a list of suggested query strings with each character they type.

As the user types their search query, send Bing the partial query string and get back suggestions. The more complete the user’s query string is, the more relevant the list of suggested query terms will be. For example, the suggestions that Bing might return for *s* are likely to be less relevant than the suggestions Bing returns for *sail*.
As the user types their search query, send Bing the partial query string and get back suggestions. The more complete the user’s query string is, the more relevant the list of suggested query terms will be. For example, the suggestions that Bing might return for *s* are likely to be less relevant than the suggestions Bing returns for *sail*.

![Autosuggest drop-down search box list](../media/bing-autosuggest-drop-down-list.PNG)

The suggestions are based on user intent and past searches made by the user and others.

When the user selects a suggestion from the drop-down list, you can use it to search the web using one of the [Bing Search APIs](../../bing-web-search/bing-api-comparison.md) or send the user to Bing's search results page for the query.


## Sending a request

Sending a request is easy. If you have your subscription key, just send an HTTP GET request to the following endpoint:

```
https://api.bing.microsoft.com/v7.0/suggestions
```
> <https://api.bing.microsoft.com/v7.0/suggestions>

Here's a cURL example that shows you how to call the endpoint using your subscription key. Change the *q* query parameter to get query string suggestions for whatever you'd like.

Expand All @@ -56,7 +53,7 @@ Here's a cURL example that includes these headers.
curl -H "Ocp-Apim-Subscription-Key: <yourkeygoeshere>" -H "X-MSEdge-ClientID: 00B4230B74496E7A13CC2C1475056FF4" -H "X-MSEdge-ClientIP: 11.22.33.44" -H "X-Search-Location: lat:55;long:-111;re:22" -A "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/29.0.1547.65 Safari/537.36" https://api.bing.microsoft.com/v7.0/suggestions?q=sail
```

Bing returns a couple of headers you should capture.
Bing returns a couple of headers you should capture.

- BingAPIs-TraceId &mdash; ID that identifies the request in the log file.
- X-MSEdge-ClientID &mdash; The ID that you need to pass in a subsequent request to provide continuity of experience.
Expand All @@ -70,7 +67,6 @@ Here's a cURL call that returns the response headers. If you want to remove the
curl -D - -H "Ocp-Apim-Subscription-Key: <yourkeygoeshere>" https://api.bing.microsoft.com/v7.0/suggestions?q=sail
```


## Query parameters

The only query parameter that you must pass is the *q* parameter, which you set to the user's query string. You must URL-encode the user's query string and all query parameter values that you pass.
Expand Down Expand Up @@ -157,10 +153,8 @@ The [SearchAction](../reference/response-objects.md#searchaction) object contain

If you don't want to call one of Bing's Search APIs, you can use the URL in the `url` field to send the user to the Bing search results page instead.


## Next steps

- Learn about the [quickstarts](../quickstarts/quickstarts.md) and [samples](../samples.md) that are available to help you get up and running fast.
- Learn about the [Bing Search APIs](../../bing-web-search/bing-api-comparison.md) where you can use the suggested search strings.
- Learn about [use and display requirements](../../bing-web-search/use-display-requirements.md) for Bing Search APIs.
- Review [Autosuggest API v7 reference](../reference/endpoints.md) documentation.
18 changes: 6 additions & 12 deletions bing-docs/bing-autosuggest/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,42 +3,36 @@ title: What is Bing Autosuggest?
titleSuffix: Bing Search Services
description: Use Bing Autosuggest API to improve your apps search box experience by adding suggested search terms as the user types their query string.
services: bing-search-services
author: swhite-msft
author: alekhyasasi
ms.author: v-alpunnamar
manager: ehansen

ms.service: bing-search-services
ms.subservice: bing-autosuggest
ms.topic: overview
ms.date: 07/15/2020
ms.author: scottwhi
ms.date: 09/27/2023
---

# What is Bing Autosuggest?

Use Bing Autosuggest API to improve your users' search box experience by providing a list of suggested query strings with each character they type.

As the user types their search query, send Bing the partial query string and get back suggestions. The more complete the user’s query string is, the more relevant the list of suggested query terms will be. For example, the suggestions that Bing might return for *m* are likely to be less relevant than the suggestions Bing returns for *micro*.
As the user types their search query, send Bing the partial query string and get back suggestions. The more complete the user’s query string is, the more relevant the list of suggested query terms will be. For example, the suggestions that Bing might return for *m* are likely to be less relevant than the suggestions Bing returns for *micro*.

The suggestions are based on user intent and past searches made by the user and others.


## Get started

To get started using the API, pick the subscription you want from <a href="https://aka.ms/bingsearchapipricing" target="_blank">Bing API Pricing</a>. After getting your subscription key, you're all set to make your first call.

You can easily call the API by sending a native HTTP GET request or by using the Autosuggest SDK. For examples to help you get up and running quickly for either option, see [Quickstarts](quickstarts/quickstarts.md).
To get started using the API, pick the subscription you want from <a href="https://aka.ms/bingsearchapipricing" target="_blank">Bing API Pricing</a>. After getting your subscription key, you're all set to make your first call.

You can easily call the API by sending a native HTTP GET request or by using the Autosuggest SDK.

## View API metrics

Bing provides API metrics, which you can use to inform your strategic decisions. Quickly retrieve statistics such as your top queries, call volume, market distribution, response code summary, and many more. For details, see [Bing Web Statistics](../bing-web-search/bing-web-stats.md).


## Next steps

- Learn about other APIs in the [family of Bing Search APIs](../bing-web-search/bing-api-comparison.md).
- Learn about [use and display requirements](../bing-web-search/use-display-requirements.md) for Bing Search APIs.
- Learn about [calling the API](how-to/get-suggestions.md).
- Review [Autosuggest API v7 reference](reference/endpoints.md) documentation.


38 changes: 0 additions & 38 deletions bing-docs/bing-autosuggest/quickstarts/quickstarts.md

This file was deleted.

Loading