# Google Search Top 100 API

> Run a Google web search and get up to 100 ranked organic results in one call, with true absolute positions rather than per-page numbering. One charge per call whatever the depth, which normally makes it cheaper than paging google.search past roughly 20 results; when the backup source has to answer, the call costs more, up to $0.024. It reads ten pages of Google to build the list, so a call can take up to about five minutes - use google.search when you want the first page back in a second.

Source: https://www.sandbase.ai/apis/google/search-100
API reference: https://www.sandbase.ai/apis/google/search-100/docs

## Facts

- Provider: Google
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/google/search-100`
- Price: From $0.0018 per call
- Capabilities: api, google, social media
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/google/search-100` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `query` | string | yes |  |
| `gl` | string | no |  |
| `hl` | string | no |  |
| `timeframe` | string | no | 1h, 1d, 7d, 1y, all |
| `autocorrect` | boolean | no |  |

## FAQ

### How do I use the Google Search Top 100 API?

Send a POST request to https://api.sandbase.ai/v1/api/google/search-100 with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the Google Search Top 100 API cost?

From $0.0018 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the Google Search Top 100 API accept?

Required: query (string). Optional: gl (string), hl (string), timeframe (one of 1h, 1d, 7d, 1y, all) and autocorrect (boolean). The Parameters table and the Playground on this page list every field.

### What does the Google Search Top 100 API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a Google developer account or API key?

No. Google Search Top 100 runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Google API access separately.

## README

### Google Search Top 100 API

Run a Google web search and get up to 100 ranked organic results in one call, with true absolute positions rather than per-page numbering. One charge per call whatever the depth, which normally makes it cheaper than paging google.search past roughly 20 results; when the backup source has to answer, the call costs more, up to $0.024. It reads ten pages of Google to build the list, so a call can take up to about five minutes - use google.search when you want the first page back in a second.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/google/search-100" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"gl": "us", "hl": "en", "query": "best crm software"}'
```

The result is returned in `outputs[0].data`. A lookup that finds nothing still succeeds and returns `found: false`.

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `query` | string | Yes | The Google search query. |
| `autocorrect` | boolean | No | Toggle Google spelling autocorrect (default true). Set false to search the exact query without correction. |
| `gl` | string | No | Two-letter country code for result localization (e.g. us, gb, de). Default `"us"`. |
| `hl` | string | No | Two-letter interface and results language code (e.g. en, es, de). Default `"en"`. |
| `timeframe` | string | No | Restrict results to a recent time window: 1h, 1d, 7d, 1y, or all. Default all (no time restriction). One of: `1h`, `1d`, `7d`, `1y`, `all`. |

#### Pricing

Billed at the actual cost of each call, usually $0.0018 per request. A call can cost more when the first data source fails and another one answers. Failed calls are not charged. Lookups that find nothing and searches with no results are billed at their actual cost, which is often lower and can be $0.