# Google Search

Serper

Search Google and return organic results, answer boxes and related query data.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Google Search (tool ID: serper.google-search). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Search the web](https://scrollport.com/tools/web-search-api)

**Current price:** $0.0025/request

**Availability:** Ready to run

## Tool details

**About this tool**

Search Google through Serper for standard search results, news, places or images. Set gl to a two-letter country code and hl to a language code when the market and language matter; num accepts 1 to 100 results. The price is flat per search, so result count does not change the Scrollport charge.

**Inputs and outputs**

### Input

`gl` string · optional

Optional two-letter country code for market targeting, for example gb, us or nz.

minLength: 2 · maxLength: 2

`hl` string · optional

Optional result language code, for example en, fr or de.

`num` integer · optional

The number of results to request. Serper charges the same flat price for 1 to 100 results.

minimum: 1 · maximum: 100

`query` string · required

The Google search query.

minLength: 1

`type` string · optional

The Serper result type.

enum: search, news, places, images

### Output

`organic` array

Returned organic value.

**Example request and output**

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

### Request

```
{
  "tool_id": "serper.google-search",
  "input": {
    "gl": "nz",
    "hl": "en",
    "num": 5,
    "type": "search",
    "query": "best specialty coffee roasters in Wellington"
  }
}
```

### Output

```
{
  "organic": [
    {
      "date": "Nov 17, 2017",
      "link": "https://www.doubleskinnymacchiato.com/2017/11/wellington-new-zealand-specialty-coffee-guide-map-cafes-roasters.html",
      "title": "12 Specialty Coffee Spots To Visit in Wellington, New Zealand",
      "snippet": "A Wellington specialty-coffee guide covering local cafes and roasters including Coffee Supreme and Mojo Coffee.",
      "position": 1
    }
  ]
}
```

**Errors and limitations**

- `invalid_input`: query is required and must not be emptyexample: {"query":"best specialty coffee roasters in Wellington","type":"search","num":5,"gl":"nz","hl":"en"}
- `invalid_input`: type must be search, news, places or images; num must be an integer from 1 to 100example: {"query":"UK AI funding","type":"news","num":10,"gl":"gb","hl":"en"}
- `invalid_input`: gl must be a two-letter country code when provideduse "gl":"gb" with "hl":"en" for UK English results

---

Canonical page: https://scrollport.com/tools/providers/serper/google-search