Suchen nach Nachrichten mit der Bing-News-Suche-APISearch for news with the Bing News Search API

Die Bing-Bildersuche-API vereinfacht das Integrieren der Funktionen der kognitiven Bing-News-Suche in Anwendungen.The Bing Image Search API makes it easy to integrate Bing's cognitive news searching capabilities into your applications.

Die Bing-News-Suche-API dient zwar in erster Linie zum Suchen und Zurückgeben von relevanten Nachrichtenartikeln, sie bietet jedoch auch verschiedene Funktionen für den intelligenten und gezielten Abruf von Nachrichten im Web.While the Bing News Search API primarily finds and returns relevant news articles, it provides several features for intelligent, and focused news retrieval on the web.

Vorschlagen und Verwenden von SuchbegriffenSuggest and use search terms

Wenn Sie ein Suchfeld bereitstellen, in das Benutzer ihre Suchbegriffe eingeben, verwenden Sie die Bing-Vorschlagssuche-API, um die Benutzerfreundlichkeit zu verbessern.If you provide a search box where the user enters their search term, use the Bing Autosuggest API to improve the experience. Die API gibt vorgeschlagene Abfragezeichenfolgen zurück, während der Benutzer einen Suchbegriff eingibt.The API returns suggested query strings based on partial search terms as the user types.

Codieren Sie den vom Benutzer eingegebenen Suchbegriff als URL, bevor Sie den Abfrageparameter q festlegen.After the user enters their search term, URL encode it before setting the q query parameter. Wenn der Benutzer also beispielsweise sailing dinghies eingibt, legen Sie q auf sailing+dinghies oder sailing%20dinghies fest.For example, if the user enters sailing dinghies, set q to sailing+dinghies or sailing%20dinghies.

Abrufen allgemeiner NachrichtenGet general news

Senden Sie die folgende GET-Anforderung, um allgemeine Nachrichtenartikel aus dem Web abzurufen, die mit dem Suchbegriff des Benutzers zusammenhängen:To get general news articles related to the user's search term from the web, send the following GET request:

GET https://api.cognitive.microsoft.com/bing/v7.0/news/search?q=sailing+dinghies&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)
X-Search-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com

Wenn Sie zuvor noch keine der Bing-APIs aufgerufen haben, lassen Sie den Client-ID-Header weg.If it's your first time calling any of the Bing APIs, don't include the client ID header. Schließen Sie die Client-ID nur ein, wenn Sie bereits eine Bing-API aufgerufen haben und Bing eine Client-ID für die Kombination aus Benutzer und Gerät zurückgegeben hat.Only include the client ID if you've previously called a Bing API and Bing returned a client ID for the user and device combination.

Wenn Sie News aus einer bestimmten Domäne abrufen möchten, verwenden Sie den Abfrageoperator site:.To get news from a specific domain, use the site: query operator.

GET https://api.cognitive.microsoft.com/bing/v7.0/news/search?q=sailing+dinghies+site:contososailing.com&mkt=en-us HTTP/1.1

Das folgende JSON-Beispiel zeigt die Antwort auf die vorherige Abfrage.The following JSON sample shows the response to the previous query. Gemäß den Anforderungen für die Verwendung und Anzeige für die Bing-Suche-APIs müssen Sie alle Nachrichtenartikel in der in der Antwort angegebenen Reihenfolge anzeigen.As part of the Use and display requirements for the Bing search APIs, you must display each news article in the order provided in the response. Wenn der Artikel gruppierte Artikel enthält, sollten Sie angeben, dass verwandte Artikel existieren, und diese bei entsprechender Aufforderung anzeigen.If the article has clustered articles, you should indicate that related articles exist and display them upon request.

{
    "_type" : "News",
    "readLink" : "https:\/\/api.cognitive.microsoft.com\/bing\/v5\/news\/search?q=sailing+dinghies",
    "totalEstimatedMatches" : 88400,
    "value" : [{
        "name" : "Sailing Vies for Four Trophies",
        "url" : "http:\/\/www.bing.com\/cr?IG=CCE2F06CA750455891FE99A72...",
        "image" : {
            "thumbnail" : {
                "contentUrl" : "https:\/\/www.bing.com\/th?id=ON.9C23AA5...",
                "width" : 650,
                "height" : 341
            }
        },
        "description" : "College Rankings, presented by Zim...",
        "provider" : [{
            "_type" : "Organization",
            "name" : "contoso.com"
        }],
        "datePublished" : "2017-04-14T15:28:00"
    },

    ...

    {
        "name" : "Fabrikam Sailing Club to host Mirror Dinghy...",
        "url" : "http:\/\/www.bing.com\/cr?IG=CCE2F06CA750455891F...",
        "image" : {
            "thumbnail" : {
                "contentUrl" : "https:\/\/www.bing.com\/th?id=ON.36...",
                "width" : 448,
                "height" : 300
            }
        },
        "description" : "The sailing club that trained Olympian Ben...",
        "provider" : [{
            "_type" : "Organization",
            "name" : "Contoso"
        }],
        "datePublished" : "2017-04-04T11:02:00",
        "category" : "Sports"
    }]
}

Die Antwort vom Typ news enthält eine Liste mit Nachrichtenartikeln, die nach Einschätzung von Bing für die Abfrage relevant sind.The news answer lists the news articles that Bing thought were relevant to the query. Das Feld totalEstimatedMatches enthält die geschätzte Anzahl von Artikeln, die angezeigt werden können.The totalEstimatedMatches field contains an estimate of the number of articles available to view. Informationen zum Durchblättern der Artikel finden Sie unter Durchblättern von Nachrichten.For information about paging through the articles, see Paging News.

Jeder Nachrichtenartikel in der Liste beinhaltet den Namen des Artikels, eine Beschreibung und die URL zu dem Artikel auf der Website des Hosts.Each news article in the list includes the article's name, description, and URL to the article on the host's website. Wenn der Artikel ein Bild enthält, umfasst das Objekt eine Miniaturansicht des Bilds.If the article contains an image, the object includes a thumbnail of the image. Verwenden Sie name und url, um einen Hyperlink zu erstellen, über den der Benutzer zu dem Nachrichtenartikel auf der Website des Hosts geleitet wird.Use name and url to create a hyperlink that takes the user to the news article on the host's site. Wenn der Artikel ein Bild enthält, machen Sie das Bild mithilfe von url auch klickbar.If the article includes an image, also make the image clickable using url. Vergessen Sie nicht, mit provider die Quelle anzugeben.Be sure to use provider to attribute the article.

Wenn Bing die Kategorie des Nachrichtenartikels bestimmen kann, enthält der Artikel das Feld category.If Bing can determine the category of news article, the article includes the category field.

Abrufen der Top-Nachrichten von heuteGet today's top news

Um die Top-Nachrichtenartikel von heute zu erhalten, können Sie die gleiche allgemeine Nachrichtenanfrage wie bisher senden, wobei Sie den Parameter q nicht setzen.To get today's top news articles, you can send the same general news request as before, while leaving the q parameter unset.

GET https://api.cognitive.microsoft.com/bing/v7.0/news/search?q=&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)
X-Search-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com

Die Antwort für das Abrufen der wichtigsten Nachrichten ist fast die gleiche wie bei allgemeinen Nachrichten.The response for getting top news is almost the same as the one for getting general news. Allerdings enthält die news-Antwort nicht das Feld totalEstimatedMatches, da eine festgelegte Anzahl von Ergebnissen vorhanden ist.However, the news answer doesn't include the totalEstimatedMatches field because there's a set number of results. Die Anzahl der wichtigsten Nachrichtenartikel kann je nach Nachrichtenzyklus variieren.The number of top news articles may vary depending on the news cycle. Vergessen Sie nicht, mit dem provider-Feld die Quelle anzugeben.Be sure to use the provider field to attribute the article.

Abrufen von Nachrichten nach KategorieGet news by category

Um Nachrichtenartikel nach Kategorien zu erhalten, wie z. B. die Top-Artikel aus Sport oder Unterhaltung, senden Sie die folgende GET-Anforderung an Bing:To get news articles by category, such as the top sports or entertainment articles, send the following GET request to Bing:

GET https://api.cognitive.microsoft.com/bing/v7.0/news?category=sports&mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)
X-Search-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com

Verwenden Sie den Abfrageparameter category, um die Kategorie der gewünschten Artikel anzugeben.Use the category query parameter to specify the category of articles to get. Eine Liste der möglichen Nachrichtenkategorien, die Sie angeben können, finden Sie unter Nachrichtenkategorien nach Markt.For a list of possible news categories that you may specify, see News Categories by Market.

Die Antwort für das Abrufen von News nach Kategorie ist fast die gleiche wie bei allgemeinen Nachrichten.The response for getting news by category is almost the same as getting general news. Allerdings stammen alle Artikel aus der angegebenen Kategorie.However, the articles are all from the specified category.

Abrufen von SchlagzeilenGet headline news

Um Schlagzeilen-Nachrichtenartikel anzufordern und Artikel aus allen Nachrichtenkategorien zu erhalten, senden Sie die folgende GET-Anforderung an Bing:To request headline news articles and get articles from all news categories, send the following GET request to Bing:

GET https://api.cognitive.microsoft.com/bing/v7.0/news?mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)
X-MSEdge-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com

Schließen Sie den Abfrageparameter category nicht ein.Do not include the category query parameter.

Die Antwort für das Abrufen der wichtigsten Schlagzeilen ist fast die gleiche wie bei allgemeinen Nachrichten.The response for getting headline news is the same as getting today's top news. Wenn es sich bei dem Artikel um einen Schlagzeilenartikel handelt, wird sein headline-Feld auf true gesetzt.If the article is a headline article, its headline field is set to true.

Standardmäßig umfasst die Antwort bis zu 12 Schlagzeilenartikel.By default, the response includes up to 12 headline articles. Um die Anzahl der zurückzugebenden Schlagzeilenartikel zu ändern, geben Sie den Abfrageparameter headlineCount an.To change the number of headline articles to return, specify the headlineCount query parameter. Die Antwort enthält außerdem pro Nachrichtenkategorie bis zu vier Artikel, die keine Schlagzeilenartikel sind.The response also includes up to four non-headline articles per news category.

Die Antwort zählt Cluster als einen Artikel.The response counts clusters as one article. Da ein Cluster aus mehreren Artikel bestehen kann, kann die Antwort mehr als 12 Schlagzeilenartikel und mehr als vier Nicht-Schlagzeilenartikel pro Kategorie umfassen.Because a cluster may have several articles, the response may include more than 12 headline articles and more than four non-headline articles per category.

Um Nachrichtenthemen zu erhalten, die in sozialen Netzwerken im Trend liegen, senden Sie die folgende GET-Anforderung an Bing:To get news topics that are trending on social networks, send the following GET request to Bing:

GET https://api.cognitive.microsoft.com/bing/v7.0/news/trendingtopics?mkt=en-us HTTP/1.1
Ocp-Apim-Subscription-Key: 123456789ABCDE
User-Agent: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; IEMobile/10.0; ARM; Touch; NOKIA; Lumia 822)
X-Search-ClientIP: 999.999.999.999
X-Search-Location: lat:47.60357;long:-122.3295;re:100
X-MSEdge-ClientID: <blobFromPriorResponseGoesHere>
X-MSAPI-UserState: <blobFromPriorResponseGoesHere>
Host: api.cognitive.microsoft.com

Hinweis

„Populäre Themen“ ist nur in den Märkten en-US und zh-CN verfügbar.Trending Topics is available only in the en-US and zh-CN markets.

Das folgende JSON zeigt die Antwort auf die vorherige Anforderung.The following JSON is the response to the preceding request. Jeder populäre Nachrichtenartikel enthält ein zugehöriges Bild, eine Breaking News-Kennzeichnung und eine URL zu den Bing-Suchergebnissen für den Artikel.Each trending news article includes a related image, breaking news flag, and a URL to the Bing search results for the article. Verwenden Sie die URL im webSearchUrl-Feld, um den Benutzer zur Seite mit den Bing-Suchergebnissen weiterzuleiten.Use the URL in the webSearchUrl field to take the user to the Bing search results page. Oder verwenden Sie den Abfragetext, um die Websuche-API abzurufen und die Ergebnisse selbst anzuzeigen.Or, use the query text to call the Web Search API to display the results yourself.

{
    "_type" : "TrendingTopics",
    "value" : [{
        "name" : "Canada pot measure",
        "image" : {
            "url" : "https:\/\/www.bing.com\/th?id=OPN.RTNews_hHD...",
            "provider" : [{
                "_type" : "Organization",
                "name" : "Contoso Images"
            }]
        },
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=070292D8CEDD...",
        "isBreakingNews" : false,
        "query" : {
            "text" : "Canada marijuana"
        }
    },
    {
        "name" : "Down on Vegas move",
        "image" : {
            "url" : "https:\/\/www.bing.com\/th?id=OPN.RTNews_Bfbmg8h...",
            "provider" : [{
                "_type" : "Organization",
                "name" : "Contoso"
            }]
        },
        "webSearchUrl" : "https:\/\/www.bing.com\/cr?IG=070292D8CEDD...",
        "isBreakingNews" : false,
        "query" : {
            "text" : "Marcus Appel Las Vegas"
        }
    },

    ...

    ]
}

Wenn es andere Artikel gibt, die sich auf einen Nachrichtenartikel beziehen, kann der Nachrichtenartikel das Feld clusteredArticles beinhalten.If there are other articles that are related to a news article, the news article may include the clusteredArticles field. Das folgende Beispiel zeigt einen Artikel mit gruppierten Artikeln.The following shows an article with clustered articles.

    {
        "name" : "Playoffs 2017: Betting lines, point spreads...",
        "url" : "http:\/\/www.bing.com\/cr?IG=4B7056CEC271408997D115...",
        "image" : {
            "thumbnail" : {
                "contentUrl" : "https:\/\/www.bing.com\/th?id=ON.D7B1...",
                "width" : 700,
                "height" : 393
            }
        },
        "description" : "April 14, 2017 3:37pm EDT April 14, 2017 3:34pm...",
        "provider" : [{
            "_type" : "Organization",
            "name" : "Contoso"
        }],
        "datePublished" : "2017-04-14T19:43:00",
        "category" : "Sports",
        "clusteredArticles" : [{
            "name" : "Playoffs 2017: Betting odds, favorites to win...",
            "url" : "http:\/\/www.bing.com\/cr?IG=4B7056CEC271408997D1159E...",
            "description" : "April 14, 2017 3:30pm EDT April 14, 2017 3:27pm...",
            "provider" : [{
                "_type" : "Organization",
                "name" : "Contoso"
            }],
            "datePublished" : "2017-04-14T19:37:00",
            "category" : "Sports"
        }]
    },

DrosselungsanforderungenThrottling requests

Der Dienst und Ihr Abonnementtyp bestimmen die zulässige Anzahl von Abfragen pro Sekunde (Queries Per Second, QPS).The service and your subscription type determine the number of queries per second (QPS) that you can make. Stellen Sie sicher, dass Ihre Anwendung die erforderliche Logik enthält, um das Kontingent nicht zu überschreiten.Make sure your application includes the logic to stay within your quota. Wenn der QPS-Grenzwert erreicht oder überschritten wird, ist die Anforderung nicht erfolgreich, und es wird ein HTTP 429-Statuscode zurückgegeben.If the QPS limit is met or exceeded, the request fails and an HTTP 429 status code is returned. Die Antwort enthält den Header Retry-After, der angibt, wie lange bis zum Senden einer weiteren Anforderung gewartet werden muss.The response includes the Retry-After header, which indicates how long you must wait before sending another request.

Denial-of-Service im Vergleich zur DrosselungDenial-of-service versus throttling

Der Dienst unterscheidet zwischen einem DoS-Angriff (Denial-of-Service) und einem QPS-Verstoß.The service makes a differentiation between a denial-of-service (DoS) attack and a QPS violation. Wenn der Dienst einen DoS-Angriff vermutet, ist die Anforderung erfolgreich (HTTP-Statuscode: 200 OK).If the service suspects a DoS attack, the request succeeds (HTTP status code is 200 OK). Der Antworttext ist jedoch leer.However, the body of the response is empty.

Nächste SchritteNext steps