apps/docs/content/docs/en/tools/serper.mdx
import { BlockInfoCard } from "@/components/ui/block-info-card"
<BlockInfoCard type="serper" color="#2B3543" /> Serper is a Google Search API that provides developers with programmatic access to Google search results. It offers a reliable, high-performance way to integrate Google search capabilities into applications without the complexity of web scraping or the limitations of other search APIs.
With Serper, you can:
In Sim, the Serper integration enables your agents to leverage the power of web search as part of their workflows. This allows for sophisticated automation scenarios that require up-to-date information from the internet. Your agents can formulate search queries, retrieve relevant results, and use this information to make decisions or provide responses. This integration bridges the gap between your workflow automation and the vast knowledge available on the web, enabling your agents to access real-time information without manual intervention. By connecting Sim with Serper, you can create agents that stay current with the latest information, provide more accurate responses, and deliver more value to users.
Integrate Serper into the workflow. Can search the web.
serper_searchA powerful web search tool that provides access to Google search results through Serper.dev API. Supports different types of searches including regular web search, news, places, images, videos, and shopping. Returns comprehensive results including organic results, knowledge graph, answer box, people also ask, related searches, and top stories.
| 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 (e.g., "search", "news", "images", "videos", "places", "shopping") |
apiKey | string | Yes | Serper API Key |
pricing | custom | No | No description |
metadata | string | No | No description |
rateLimit | string | No | No description |
| Parameter | Type | Description |
|---|---|---|
searchResults | array | Search results with titles, links, snippets, and type-specific metadata (date for news, rating for places, imageUrl for images) |
↳ 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) |