Skip to content
Nappai Documentation

Brave Search API Tool

The Brave Search API Tool lets you perform web searches directly from your Nappai dashboard.
Enter a query and choose how many results you want, and the tool will fetch relevant snippets from the Brave Search engine and return them as data that can be used in other parts of your automation.

How it Works

The component talks to the Brave Search API.

  1. Credential – First, you must have a Brave Search API credential set up in Nappai’s Credentials section.
  2. Query – You type a search query into the Input field.
  3. Results Count – You set how many results you want with Number of Results.
  4. The component sends the query to Brave Search, receives a list of results, and turns each result into a Data object that contains the snippet text.
  5. The list of Data objects is returned as the Data output, and the underlying tool object is available as the Tool output for advanced use.

Inputs

Input Fields

  • Input: The search query you want to run against Brave Search.
  • Number of Results: How many search results you want to retrieve (default is 10).

Note: This component uses a Brave Search API credential.

  1. Configure the Brave Search API credential in the Credentials section of Nappai.
  2. Select that credential in the component’s Credential field before running.

Outputs

  • Data: A list of Data objects, each containing a snippet of a search result.
  • Tool: The underlying BaseTool object that can be used by other components if needed.

Usage Example

  1. Drag the Brave Search API Tool onto your workflow.
  2. In the Input field, type Python tutorials.
  3. Leave Number of Results at the default 10 or change it to a different number.
  4. Connect the Data output to a component that displays or processes the results (e.g., a table or a text summarizer).
  5. Run the workflow and see the top search snippets appear in your dashboard.
  • Data Output – Displays the list of search snippets in a readable format.
  • Text Summarizer – Can take the snippets from the Data output and produce a concise summary.

Tips and Best Practices

  • Keep your search queries concise to get the most relevant results.
  • Adjust Number of Results to balance between detail and API usage limits.
  • Use the Tool output if you need to chain multiple search operations in a single workflow.

Security Considerations

  • The Brave Search API key is stored securely in Nappai’s credential store.
  • Never expose the key in public workflows or share the workflow file without removing the credential reference.