> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# SerpApi

> Structured Google search, news, maps, and shopping results through the SerpApi search API

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key from `SERPAPI_API_KEY` is sent as the `api_key` query parameter.
* **Docs**: [https://serpapi.com/search-api](https://serpapi.com/search-api)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable          | Required | Description                                                                                     |
| ----------------- | -------- | ----------------------------------------------------------------------------------------------- |
| `SERPAPI_API_KEY` | Yes      | SerpApi private API key from your account dashboard [Docs](https://serpapi.com/manage-api-key). |

## Setup

1. **Create a SerpApi account**: Sign up at [https://serpapi.com/users/sign\_up](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](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](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=](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](https://serpapi.com/search-api)

## Tools

| Tool                   | Access | Description                                                                                             |
| ---------------------- | ------ | ------------------------------------------------------------------------------------------------------- |
| Google Search          | Read   | Run a Google web search and get structured organic results, answer boxes, and related data              |
| Google News Search     | Read   | Search Google News and get structured article results with titles, sources, and publish dates           |
| Google Maps Search     | Read   | Search Google Maps for places and get structured local results with addresses, ratings, and coordinates |
| Google Shopping Search | Read   | Search Google Shopping and get structured product results with prices, merchants, and ratings           |