# Serper (/integrations/serper)



{/* MANUAL-CONTENT-START:intro */}

[Serper](https://serper.dev/) provides web search results for a query. Use the returned titles, snippets, and URLs as inputs to later workflow steps, and configure the search options listed below.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Search the web.

## Actions [#actions]

### Web Search [#web-search]

Search Google through the Serper.dev API for web, news, places, images, videos, shopping, scholar, or patent results. Available response sections include organic results, a knowledge graph, an answer box, related questions, related searches, and top stories.

#### Input [#input]

| Parameter | Type | Required | Description |
| - | - | - | - |
| `query` | string | Yes | The search query (e.g., "latest AI news", "best restaurants in NYC") |
| `num` | number | No | Number of results to return (e.g., 10, 20, 50) |
| `gl` | string | No | Country code for search results (e.g., "us", "uk", "de", "fr") |
| `hl` | string | No | Language code for search results (e.g., "en", "es", "de", "fr") |
| `type` | string | No | Type of search to perform. Must be one of "search", "news", "places", "images", "videos", "shopping", "scholar", "patents" — any other value is rejected. |
| `apiKey` | string | Yes | Serper API Key |

#### Output [#output]

| Parameter | Type | Description |
| - | - | - |
| `searchResults` | array | Search results with titles, links, snippets, and type-specific metadata (date for news, rating for places, imageUrl for images, duration/source for videos, price/source for shopping) |
| ↳ `title` | string | Result title |
| ↳ `link` | string | Result URL |
| ↳ `snippet` | string | Result description/snippet |
| ↳ `position` | number | Position in search results |
| ↳ `date` | string | Publication date (news/videos) |
| ↳ `imageUrl` | string | Image URL (images/news/shopping) |
| ↳ `source` | string | Source name (news/videos/shopping) |
| ↳ `rating` | number | Rating (places) |
| ↳ `ratingCount` | number | Number of reviews (places) |
| ↳ `address` | string | Address (places) |
| ↳ `price` | string | Price (shopping) |
| ↳ `duration` | string | Duration (videos) |