Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.
VariableRequiredDescription
SERPAPI_API_KEYYesSerpApi private API key from your account dashboard Docs.

Setup

  1. Create a SerpApi account: Sign up at https://serpapi.com/users/sign_up. The free plan includes a monthly allowance of searches, which is enough for testing.
  2. Copy your private API key: Open https://serpapi.com/manage-api-key and copy the private API key shown for your account.
  3. Store the key: Set the key as SERPAPI_API_KEY. You can verify it works by opening https://serpapi.com/search?engine=google&q=coffee&api_key=YOUR_KEY in a browser and checking that JSON results come back.
  • SerpApi authenticates by passing the API key as an api_key query parameter on every request (https://serpapi.com/search?engine=google&q=…&api_key=…); it does not accept the key in an HTTP header.
  • Each request consumes one search from your plan; the engine parameter selects the result type (google, google_news, google_maps, google_shopping, and more).
Provider API reference: https://serpapi.com/search-api

Tools

ToolAccessDescription
Google SearchReadRun a Google web search and get structured organic results, answer boxes, and related data
Google News SearchReadSearch Google News and get structured article results with titles, sources, and publish dates
Google Maps SearchReadSearch Google Maps for places and get structured local results with addresses, ratings, and coordinates
Google Shopping SearchReadSearch Google Shopping and get structured product results with prices, merchants, and ratings