Skip to content
Nappai Documentation

Serp Search API

Serp Search API is a tool that lets you ask the web for information. You type a question or keyword, and it returns a list of recent search results from the internet. It’s useful when you need up‑to‑date facts, news, or links that aren’t already in your data.

How it Works

When you run the component, it talks to the SerpApi service. You give it a search query and optional parameters (like language or location). The component sends that request to SerpApi, receives a JSON response, and turns each result into a small data item that contains the title, link, and a short snippet. Those items are then available for the rest of your workflow.

Inputs

This component requires a SerpApi credential.

  1. First, add a SerpApi credential in the Nappai credentials section.
  2. Then, in the component, choose that credential from the Credential field.

Input Fields

  • Input: The search text you want to look up.
  • Parameters: Optional key‑value pairs that tweak the search (for example, {"location": "United States", "hl": "en"}).

Outputs

  • Data: A list of search result items. Each item contains the result’s title, link, and snippet.
  • Tool: A reusable tool that can be called by an LLM to perform a search during a conversation.

Usage Example

  1. Add the Serp Search API component to your flow.
  2. In the Input field, type Nappai automation.
  3. Leave Parameters empty or add {"hl": "en"} to force English results.
  4. Connect the Data output to a “Display” component to show the titles and snippets in your dashboard.

The component will return a list of recent web results that you can display, store, or pass to other parts of your automation.

  • Google Search API – Search Google directly.
  • Bing Search API – Search Bing for results.
  • Web Scraper – Pull data from a specific webpage.

Tips and Best Practices

  • Use Parameters to limit results to a specific country or language.
  • Keep the number of searches low to stay within your API quota.
  • Combine the Tool output with an LLM to let the assistant answer questions on the fly.

Security Considerations

The API key is stored securely in the Nappai credential store. Never expose it in the dashboard or share the component configuration publicly. Always use the credential field to reference the stored key.