---
source_url: "https://docs.crewai.com/v1.15.1/en/tools/search-research/serperdevtool"
title: Google Serper Search - CrewAI
mirrored_at: 2026-08-10T01:04:33.623Z
host: docs.crewai.com
cited_in_42a: true
mirror_canonical: "https://index.42a.ai/docs.crewai.com/v1.15.1/en/tools/search-research/serperdevtool"
---

> **Original source:** https://docs.crewai.com/v1.15.1/en/tools/search-research/serperdevtool

## `SerperDevTool`

## Description

This tool is designed to perform a semantic search for a specified query from a text’s content across the internet. It utilizes the [serper.dev](https://serper.dev/) API to fetch and display the most relevant search results based on the query provided by the user.

## Installation

To effectively use the `SerperDevTool`, follow these steps:

1.  **Package Installation**: Confirm that the `crewai[tools]` package is installed in your Python environment.
2.  **API Key Acquisition**: Acquire a `serper.dev` API key at [https://serper.dev/](https://serper.dev/) (free tier available).
3.  **Environment Configuration**: Store your obtained API key in an environment variable named `SERPER_API_KEY` to facilitate its use by the tool.

To incorporate this tool into your project, follow the installation instructions below:

## Example

The following example demonstrates how to initialize the tool and execute a search with a given query:

Code

## Parameters

The `SerperDevTool` comes with several parameters that will be passed to the API :

-   **search\_url**: The URL endpoint for the search API. (Default is `https://google.serper.dev/search`)
-   **country**: Optional. Specify the country for the search results.
-   **location**: Optional. Specify the location for the search results.
-   **locale**: Optional. Specify the locale for the search results.
-   **n\_results**: Number of search results to return. Default is `10`.

The values for `country`, `location`, `locale` and `search_url` can be found on the [Serper Playground](https://serper.dev/playground).

## Example with Parameters

Here is an example demonstrating how to use the tool with additional parameters:

Code

Code

## Conclusion

By integrating the `SerperDevTool` into Python projects, users gain the ability to conduct real-time, relevant searches across the internet directly from their applications. The updated parameters allow for more customized and localized search results. By adhering to the setup and usage guidelines provided, incorporating this tool into projects is streamlined and straightforward.