Connectors Reference

Bing Search

Microsoft Cognitive Services Bing Search API allows you to search content across the web.

 

Status: Preview

Tier: Standard

Version: 1.0

 

Actions:

Name

Summary

GetNews (string q, [Optional]string mkt, [Optional]string safeSearch, [Optional]string count, [Optional]string offset)

List news by query

 

Triggers:

Name

Summary

TrigNewNews (string q, [Optional]string mkt, [Optional]string safeSearch, [Optional]string count, [Optional]string offset)

On new news article

 

Objects:

Name

Summary

NewsArticle

 

 

Actions:

GetNews

Summary: List news by query

Description: Returns a list of news articles for a given query.

 

Syntax:

BingSearch.GetNews (string q, [Optional]string mkt, [Optional]string safeSearch, [Optional]string count, [Optional]string offset)

 

Parameters:

Name

Type

Summary

Required

Related Action

q

string

(Search Query)

The search query string.

True

mkt

string

(Market)Values: [es-AR, en-AU, de-AT, nl-BE, fr-BE, pt-BR, en-CA, fr-CA, es-CL, da-DK, fi-FI, fr-FR, de-DE, zh-HK, en-IN, en-ID, en-IE, it-IT, ja-JP, ko-KR, en-MY, es-MX, nl-NL, en-NZ, no-NO, zh-CN, pl-PL, pt-PT, en-PH, ru-RU, ar-SA, en-ZA, es-ES, sv-SE, fr-CH, de-CH, zh-TW, tr-TR, en-GB, en-US, es-US]

The market where the results come from. Typically, this is the country where the user is making the request from; however, it could be a different country if the user is not located in a country where Bing delivers results. The market must be in the form -. For example, en-US.

False

safeSearch

string

(Safe Search)Values: [Moderate, Off, Strict]

A filter used to filter results for adult content.

False

count

string

(Count)

The number of search results to return in the response. The actual number delivered may be less than requested.

False

offset

string

(Offset)

The zero-based offset that indicates the number of search results to skip before returning results.

False

 

Returns:

          Type:array of (NewsArticle)

 

Triggers:

Trigger TrigNewNews

Summary: On new news article

Description: Triggers when a news article matches the given query.

 

Syntax:

BingSearch.TrigNewNews (string q, [Optional]string mkt, [Optional]string safeSearch, [Optional]string count, [Optional]string offset)

 

Parameters:

Name

Type

Summary

Required

Related Action

q

string

(Search Query)

The search query string.

True

mkt

string

(Market)Values: [es-AR, en-AU, de-AT, nl-BE, fr-BE, pt-BR, en-CA, fr-CA, es-CL, da-DK, fi-FI, fr-FR, de-DE, zh-HK, en-IN, en-ID, en-IE, it-IT, ja-JP, ko-KR, en-MY, es-MX, nl-NL, en-NZ, no-NO, zh-CN, pl-PL, pt-PT, en-PH, ru-RU, ar-SA, en-ZA, es-ES, sv-SE, fr-CH, de-CH, zh-TW, tr-TR, en-GB, en-US, es-US]

The market where the results come from. Typically, this is the country where the user is making the request from; however, it could be a different country if the user is not located in a country where Bing delivers results. The market must be in the form -. For example, en-US.

False

safeSearch

string

(Safe Search)Values: [Moderate, Off, Strict]

A filter used to filter results for adult content.

False

count

string

(Count)

The number of search results to return in the response. The actual number delivered may be less than requested.

False

offset

string

(Offset)

The zero-based offset that indicates the number of search results to skip before returning results.

False

 

Returns:

          Type:array of (NewsArticle)

 


 

NewsArticle

Summary:

Description:

 

          Properties:

Name

Type

Summary

name

string

Name

The name of the news article.

url

string

URL

The URL to the news article.

description

string

Description

A short description of the news article.

datePublished

string(date-time)

Date Published

The datetime the article was published.

category

string

Category

The category of the news article, such as ScienceAndTechnology.