Use cases and templates: Serper integration for AI agents
Serper 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.
Use the block
Search the web.
Actions
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
| 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
| 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) |