# Google Search API

> Organic results, People Also Ask, the AI Overview and related searches for any query, localized to a country or a city, as JSON. Autocomplete and Google News on the same key.

Canonical page: https://scrapercompany.com/google-search-api. Endpoints and prices checked against the API on 2026-11-11.

The Google Search API returns one Google results page as structured data: each organic result with its position, title, link, displayed URL and snippet, the People Also Ask questions, the AI Overview text and its sources when Google shows one, and the related searches.

Results can be localized to a country with gl or to a city with a place name such as “Austin,Texas,United States”, which is how rank tracking and local SEO work. Google Autocomplete suggestions and Google News articles are separate, cheaper calls on the same key.

Price: $4.00 per 1,000 calls with a credit pack, down to $1.33 on the Business plan. Failed requests cost 0 credits.

## What you get

- `organic_results[]`: position, title, link, displayed URL and snippet
- `people_also_ask[]`: the questions Google lists for the query
- `ai_overview, ai_overview_sources`: the AI Overview text and the pages it cites
- `related_searches[]`: Google’s related queries
- `suggestions[]`: autocomplete suggestions with relevance (autocomplete endpoint)
- `news_results[]`: articles with source and publish time (news endpoint)

## Endpoints and price per call

| Endpoint | Method and path | What it returns | Credits per successful call | Price per call |
| --- | --- | --- | --- | --- |
| [Web search](https://scrapercompany.com/docs/reference/google-search) | `POST /v1/google/search` | One results page with organic results, People Also Ask and AI Overview | 4 credits | $0.0049 on Starter, $0.0040 on Growth, $0.0032 on Scale, $0.0027 on Business |
| [Autocomplete](https://scrapercompany.com/docs/reference/google-autocomplete) | `POST /v1/google/autocomplete` | Suggestions for a partial query | 2 credits | $0.0024 on Starter, $0.0020 on Growth, $0.0016 on Scale, $0.0013 on Business |
| [Google News](https://scrapercompany.com/docs/reference/news) | `POST /v1/news` | Articles for a query or a news section | 2 credits | $0.0024 on Starter, $0.0020 on Growth, $0.0016 on Scale, $0.0013 on Business |

Pricing: free trial of 50 calls or 14 days, whichever ends first, no card needed; Starter $49/month for 40,000 credits; Growth $149/month for 150,000 credits; Scale $399/month for 500,000 credits; Business $999/month for 1,500,000 credits; credit packs $15 for 7,500, $60 for 35,000, $200 for 125,000 (valid 12 months). Failed requests (4xx or 5xx) and empty results cost 0 credits. https://scrapercompany.com/pricing

## Example

`POST /v1/google/search`, 4 credits per successful call.

```bash
curl -X POST "https://api.scrapercompany.com/v1/google/search" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "Hilton Chicago"
  }'
```

Response (trimmed):

```json
{
  "search_parameters": {
    "engine": "google_search",
    "q": "best time to visit japan",
    "page": 1
  },
  "organic_results": [
    {
      "position": 1,
      "title": "Best Time to Visit Japan: Seasons, Months, Weather & Events",
      "link": "https://www.google.com/goto?url=CAESeQHrOzAVJE8lGsYKYT",
      "display_url": "https://en.japantravel.com › Culture",
      "source": "Japan Travel",
      "snippet": "Mar 25, 2026 — If we're going by popular opinion, spring (March to May) is the best time to visit Japan…"
    },
    {
      "position": 2,
      "title": "The Best Time to Visit Japan",
      "link": "https://www.google.com/goto?url=CAESdAHrOzAVksx1otYJyS",
      "display_url": "https://www.japan-guide.com › travel-essentials",
      "source": "japan-guide.com",
      "snippet": "The best time to visit Japan is in spring (March to May) for cherry blossoms, or autumn (October to November) for foliage…"
    }
  ],
  "people_also_ask": [
    "Is $5000 enough for a week in Japan?",
    "What is the cheapest month to go to Japan?"
  ],
  "related_searches": [
    "Best time to visit Japan reddit",
    "Cheapest time to visit Japan"
  ],
  "ai_overview": "Spring: Cherry Blossoms (March – May)\nHighlights: Mild temperatures (45–70°F) and famous cherry blossoms (sakura) peaking in late March to early April.\nDrawbacks: Extremely crowded and expensive.",
  "ai_overview_sources": [],
  "discussions": [
    {
      "title": "When is the best time to travel to Japan for sightseeing and cultural ...",
      "link": "https://www.google.com/goto?url=CAESogEB6zswFTkbhF"
    }
  ],
  "total": 2,
  "meta": {
    "source": "google_search",
    "elapsed_s": 8.2,
    "rendered": true
  }
}
```

## Fields in the response

Arrays show their first item; every item has the same fields.

| Field | Type | Example | What it is |
| --- | --- | --- | --- |
| `organic_results` | array |  | Position, title, link, displayed URL and snippet |
| `organic_results[].position` | integer | `1` |  |
| `organic_results[].title` | string | `"Best Time to Visit Japan: Seasons, Mont…"` | Title as the site shows it. |
| `organic_results[].link` | string | `"https://www.google.com/goto?url=CAESeQH…"` | Address of the item on the site. |
| `organic_results[].display_url` | string | `"https://en.japantravel.com › Culture"` |  |
| `organic_results[].snippet` | string | `"Mar 25, 2026 — If we're going by popula…"` |  |
| `people_also_ask` | array |  | The questions Google lists for the query |
| `related_searches` | array |  | Google’s related queries |
| `ai_overview` | string | `"Spring: Cherry Blossoms (March – May)\n…"` | The AI Overview text and the pages it cites |
| `ai_overview_sources` | array |  | The AI Overview text and the pages it cites |
| `discussions` | array |  |  |
| `discussions[].title` | string | `"When is the best time to travel to Japa…"` | Title as the site shows it. |
| `discussions[].link` | string | `"https://www.google.com/goto?url=CAESogE…"` | Address of the item on the site. |
| `total` | integer | `2` | Total for the whole stay or request, in currency. |
| `meta` | object |  | About the call: what was asked for and how big the answer is. |
| `meta.rendered` | boolean | `true` |  |

## Inputs

| Input | Type | Required | What it does |
| --- | --- | --- | --- |
| `gl` | string | no | Country market (Google gl). Default us. |
| `hl` | string | no | Interface language (Google hl). Default en. |
| `location` | string \| null | no | City-level geo-targeting: a Google canonical place name such as Austin,Texas,United States (The standard SERP API location). min length 2, max length 200. |
| `uule` | string \| null | no | Raw Google uule passthrough (w+... min length 10, max length 1024. |
| `q` | string | yes | Search query. min length 1, max length 400. |
| `page` | integer | no | Result page (10 results per page). Default 1. min 1, max 10. |
| `num` | integer | no | Results per page. Default 10. min 1, max 20. |
| `resolve` | boolean | no | Follow each result's /goto redirect to the destination URL (one HTTP request per result). Default false. |

## Your first call in three steps

1. **Get an API key.** Create an account and verify your email, then copy a key from the dashboard. The free trial is 50 calls or 14 days, whichever ends first, no card needed.
2. **Send POST /v1/google/search.** Put the key in the `x-api-key` header and pass `q`. Every other input is optional and listed above.
3. **Read the JSON.** The answer is one JSON object with `organic_results`, `people_also_ask`, `related_searches`, `ai_overview` and `ai_overview_sources`, typed and named the same way on every call. A failed call costs 0 credits, so retrying is free.

## Limits and coverage

- Where it works (Google Search): Every Google country and language
- Where it works (Google Autocomplete): Every Google country and language
- Where it works (Google News): Every Google News edition
- Up to 10 pages deep (`page`)
- Up to 20 results per page (`num`)
- Google Search: Links are Google redirects unless you ask for them resolved to the destination URL.
- Google Autocomplete: An empty answer is not charged.

## Is it legal to scrape Google Search?

**Public pages only.** The API reads what Google Search shows anyone who opens the page without signing in. It uses no account and opens nothing behind a paywall.

**Facts are not the same as content.** A price on a date, a rating or a count is a fact, and copyright does not protect facts. Review text, photos, descriptions and transcripts belong to their authors or the site. Counting, scoring or summarising them is a different use from republishing them, and republishing usually needs permission.

**Databases have their own right in the EU and UK.** Whoever invested in building a database there can stop others taking a substantial part of it, and repeated extraction of small parts can add up to a substantial part. Collect the fields and dates you need, not a copy of Google Search.

**Personal data is yours to handle.** Reviews and place listings can carry reviewer names and profile photos. If you keep it, the GDPR and UK GDPR apply to people in Europe and the UK, and other places have their own privacy laws: you need a lawful basis, must tell people you hold their data unless an exemption applies, should collect no more than you need, and should delete it on a schedule. The simplest route is not to keep it: drop names and handles before you store anything. A hashed name is still personal data.

**The site’s terms, and ours.** The terms of use of Google Search may limit automated access to it or reuse of its data. Our Terms make you responsible for how you use the data you collect, for following the terms of the sites it comes from, for data protection law, and for having the rights you need.

This is general information, not legal advice. For a specific use, ask a lawyer where you operate. Google Search is a trademark of its owner. ScraperCompany is independent: not affiliated with or endorsed by Google Search, and this is not an official Google Search API.
Our Terms: https://scrapercompany.com/terms#data-use

## FAQ

### Is this the Google Custom Search JSON API?

No. Google’s Custom Search JSON API searches a site or a configured set of sites. This API returns the regular Google results page, including People Also Ask and the AI Overview, which Custom Search does not provide.

### Can I track rankings in a specific city?

Yes. Pass location as a Google place name such as “Austin,Texas,United States” and set gl to the place’s country. Each organic result carries its position.

### Does it capture the AI Overview?

When Google generates one for the query, the response includes the AI Overview text and the sources it cites. Not every query gets an AI Overview.

### Why does a Google Search call cost 4 credits?

Each call returns the full results page, with People Also Ask and the AI Overview, and takes seconds rather than milliseconds to collect. Autocomplete and News are lighter and cost 2 credits.

### Do failed requests cost credits?

No. A failed or blocked call (any 4xx or 5xx response) costs 0 credits, and so does a search page that comes back empty. You pay only for successful results.

### How do I get an API key?

Create an account on the sign-up page and verify your email. You get a free trial of 50 calls or 14 days, whichever ends first, no card needed on the travel endpoints (hotels, vacation rentals, flights, reviews) and 10 calls to the other sources; for everything else, and after the trial, buy a credit pack (from $15) or pick a plan. You create and rotate keys yourself in the dashboard.

## Read next

- [Google Search reference](https://scrapercompany.com/docs/reference/google-search)
- [Vertical engines guide](https://scrapercompany.com/docs/guides/vertical-engines)
- [All SERP APIs](https://scrapercompany.com/serp-api)
- [Web search](https://scrapercompany.com/docs/guides/vertical-engines#web-search)
- [People Also Ask and AI Overview](https://scrapercompany.com/docs/guides/vertical-engines#paa)
- [Google News](https://scrapercompany.com/docs/guides/vertical-engines#news)
- [All APIs](https://scrapercompany.com/apis.md)
