Skip to main content

Serper - Google Search API

This page covers how to use the Serper Google Search API within LangChain. Serper is a low-cost Google Search API that can be used to add answer box, knowledge graph, and organic results data from Google Search. It is broken into two parts: setup, and then references to the specific Google Serper wrapper.


  • Go to to sign up for a free account
  • Get the api key and set it as an environment variable (SERPER_API_KEY)



There exists a GoogleSerperAPIWrapper utility which wraps this API. To import this utility:

from langchain_community.utilities import GoogleSerperAPIWrapper

You can use it as part of a Self Ask chain:

from langchain_community.utilities import GoogleSerperAPIWrapper
from langchain_openai import OpenAI
from langchain.agents import initialize_agent, Tool
from langchain.agents import AgentType

import os

os.environ["SERPER_API_KEY"] = ""
os.environ['OPENAI_API_KEY'] = ""

llm = OpenAI(temperature=0)
search = GoogleSerperAPIWrapper()
tools = [
name="Intermediate Answer",,
description="useful for when you need to ask with search"

self_ask_with_search = initialize_agent(tools, llm, agent=AgentType.SELF_ASK_WITH_SEARCH, verbose=True)"What is the hometown of the reigning men's U.S. Open champion?")


Entering new AgentExecutor chain...
Follow up: Who is the reigning men's U.S. Open champion?
Intermediate answer: Current champions Carlos Alcaraz, 2022 men's singles champion.
Follow up: Where is Carlos Alcaraz from?
Intermediate answer: El Palmar, Spain
So the final answer is: El Palmar, Spain

> Finished chain.

'El Palmar, Spain'

For a more detailed walkthrough of this wrapper, see this notebook.


You can also easily load this wrapper as a Tool (to use with an Agent). You can do this with:

from langchain.agents import load_tools
tools = load_tools(["google-serper"])
API Reference:load_tools

For more information on tools, see this page.

Was this page helpful?

You can also leave detailed feedback on GitHub.