SerpAPI integration

Integrate with the SerpAPI tool using LangChain Python.

This notebook goes over how to use the SerpApi component to search the web.

Sign up for a SerpApi account on the sign-up page to get 250 free searches per month. After signing up, you can find your API key on the dashboard.

Then set the environment variable .env file SERPAPI_API_KEY to your API key.

import os
os.environ["SERPAPI_API_KEY"] = SERPAPI_API_KEY

from langchain_community.utilities import SerpAPIWrapper

search = SerpAPIWrapper()

search.run("Obama's first name?")

'Barack Hussein Obama II'

Custom parameters

You can also customize the SerpAPI wrapper with arbitrary parameters. For example, in the below example we will use bing instead of google.

params = {
    "engine": "bing",
    "gl": "us",
    "hl": "en",
}
search = SerpAPIWrapper(params=params)

search.run("Obama's first name?")

'Barack Hussein Obama II is an American politician who served as the 44th president of the United States from 2009 to 2017. A member of the Democratic Party, Obama was the first African-American presi…New content will be added above the current area of focus upon selectionBarack Hussein Obama II is an American politician who served as the 44th president of the United States from 2009 to 2017. A member of the Democratic Party, Obama was the first African-American president of the United States. He previously served as a U.S. senator from Illinois from 2005 to 2008 and as an Illinois state senator from 1997 to 2004, and previously worked as a civil rights lawyer before entering politics.Wikipediabarackobama.com'

from langchain.tools import tool

# You can create the tool to pass to an agent
@tool
def web_search(query: str) -> str:
    """Search the web for information."""
    return search.run(query)

---

Edit this page on GitHub or file an issue.

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.