Skip to content
Nappai Documentation

Bing Search API

The Bing Search API component lets you ask Bing for information right from your Nappai dashboard.
Just type a question or keyword, choose how many results you want, and the component will return a list of web snippets that you can use in your workflow or feed to an AI model.

How it Works

When you run the component, it talks to Microsoft’s Bing Search service.

  1. It uses the Bing Search API key you set up in Nappai’s credentials.
  2. It sends the text you entered in Input as a search query.
  3. It asks for the number of results you specified in Number of results.
  4. It receives a list of web pages, keeps the snippet (short description) of each page, and returns that list as Data.
  5. It also creates a reusable Tool that can be plugged into other parts of your workflow or into an LLM prompt.

Inputs

  • Bing Search URL: If you have a custom Bing endpoint, put it here. Leave it empty to use the default Bing API URL.
  • Input: The text you want to search for. This can be a question, a keyword, or any phrase.
  • Number of results: How many search results you want to retrieve. The default is 4, but you can set it to any positive integer.

Credential
This component needs a Bing Search API key.

  1. Go to the Credentials section of Nappai and add a new credential of type Bing Search API.
  2. Enter your Bing Search API Key (the password field).
  3. In the component, select that credential from the Credential dropdown.

Outputs

  • Data: A list of Data objects, each containing a web page snippet that you can display or pass to another component.
  • Tool: A Tool object that can be used by LLMs or other components to perform the same Bing search operation.

Usage Example

  1. Add the component to your workflow.
  2. Configure the inputs:
    • Input: “AI in healthcare”
    • Number of results: 5
    • Bing Search URL: leave blank
  3. Select the credential you created earlier.
  4. Run the component.
  5. The Data output will give you five snippets about AI in healthcare that you can display in a dashboard or feed into a summarization step.
  • BingSearchResults – A tool‑only version that can be called directly from an LLM prompt.
  • Web Scraper – Use after BingSearchAPI to pull full content from the URLs returned.
  • Summarizer – Take the snippets from Data and produce a concise summary.

Tips and Best Practices

  • Keep your search queries short and specific to get the most relevant results.
  • Use the Number of results field to limit the amount of data you process, which can save time and cost.
  • If you have a custom Bing endpoint (e.g., for a corporate subscription), fill in the Bing Search URL to use it.
  • Store your Bing API key securely in Nappai’s credential store; never hard‑code it in your workflow.

Security Considerations

  • The Bing Search API key is stored in Nappai’s credential system, so it’s protected and not exposed in the workflow.
  • Always use the credential dropdown instead of typing the key directly into the component.
  • If you share the workflow with others, they will only see the component’s inputs and outputs, not the actual API key.