Skip to content
Nappai Documentation

Bing Search API

Bing Search API runs web searches with the Bing search engine and returns the results: title, link and a snippet of each page.

You can use it in two ways. As a tool, you connect its Tool output to the Tools input of an agent, and the agent decides when to search and what to type. As a step in the flow, you write the search in Input and collect the results from the Data output.

When to use it

  • An assistant needs current information that is not in your documents, such as news or published prices.
  • You want an agent to check facts online before writing an answer.
  • A flow searches for news about your industry every morning and summarises it.
  • You need a list of web pages on a topic to review later.

Configuration

You need a Bing Search API credential with your Bing subscription key. See Credentials.

FieldWhat it does
Credential (required)The Bing Search API credential used for searches.
InputThe text to search for. Only used with the Data output; when you connect the Tool output the field is hidden, because the agent writes the search.
Number of results (required)How many results each search returns. Defaults to 4.

Advanced options

FieldWhat it does
Bing Search URLAddress of the search service. Leave it empty to use Bing’s.

Output

  • Tool: connects to an agent’s Tools input. The agent receives the results of every search it runs.
  • Data: a list with one item per result, with its title, link and snippet. You can pass it to a component that summarises or stores it.

When you connect one of the two outputs, the other one is hidden.

Example

A marketing team wants a daily summary of news about a competitor.

  1. Add Bing Search API and write the competitor’s name followed by “news” in Input.
  2. Raise Number of results to 10.
  3. Connect the Data output to a component that summarises text, and send the summary by email or chat.
  4. Schedule the flow to run every morning.