Block: Serper Block — Zelaxy Docs

The Serper block gives your workflow real-time web search results through Serper's Google Search API integration. Reach for it when you need structured, up-to-date search data — web pages, news, images, or places — with control over the result language and region.

Overview

Property	Value
Type	`serper`
Category	tools
Color	`#2B3543`

When to Use

Pull fresh web results to ground an agent's answer in current information.
Search recent news articles on a topic for monitoring or summarization.
Look up local places and businesses for a given query.
Retrieve image search results for a subject.
Tailor results to a specific country (e.g. US, GB, DE) and language (e.g. en, es, fr).
Cap the number of returned results (10 through 100) to keep downstream processing focused.

Configuration

Search Query

The terms to search for. Required free-text input.

Search Type

Dropdown selecting which Serper index to query: search, news, places, or images. Defaults to search.

Number of Results

Dropdown limiting how many results to return: 10, 20, 30, 40, 50, or 100.

Country

Dropdown for the geographic region (gl): US, GB, CA, AU, DE, or FR.

Language

Dropdown for the result language (hl): en, es, fr, de, or it.

API Key

Your Serper API key. Required and stored as a secret.

Inputs & Outputs

Inputs:
- query (string) — Search query terms
- apiKey (string) — Serper API key
- num (number) — Number of results to return
- gl (string) — Country code for search results
- hl (string) — Language code for search results
- type (string) — Search type (search, news, places, images)
Outputs:
- searchResults (json) — Search results data; each result contains title, link, snippet, and position, plus type-specific fields: date for news, rating/reviews/address for places, and imageUrl for images and news

Tools

Web Search (serper_search) — Queries the Serper.dev Google Search API and returns structured results. Supports web (search), news, places, and images search types. Required params: query and apiKey. Optional params: num, gl, and hl.

YAML Example

serper_1:
  type: serper
  name: "Serper"
  inputs:
    query: "{{start.input}}"
    type: "search"
    num: "10"
    gl: "US"
    hl: "en"
    apiKey: "{{SERPER_API_KEY}}"
  connections:
    outgoing:
      - target: next-block-id

Serper Block