Skip to main content

​
At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from SERPAPI_API_KEY is sent as the api_key query parameter.
  • Provider documentation: Authentication reference.

​
Credentials

Set these per environment. See Connect an integration.

​
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.

​
Provider notes

  • 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.

​
Tools

​
Verify the connection

Call a read tool such as serpapi__google_search with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.