# Google Search Scraper (`scrapeai/google-search-scraper`) Actor

Scrape Google Search results with deep extraction. Collect organic results (20+ fields), featured snippets, People Also Ask, Knowledge Panel, Top Stories, videos, image packs, and related searches. Supports localized Google domains, 200+ countries/languages, and time-based filters.

- **URL**: https://apify.com/scrapeai/google-search-scraper.md
- **Developed by:** [ScrapeAI](https://apify.com/scrapeai) (community)
- **Categories:** Developer tools, SEO tools, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $15.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Google Search Scraper 🔍

Google Search Scraper collects real-time Google search results for given keywords. It extracts result title, link, snippet/description, position, and optional metadata like sitelinks. Useful for SEO analysis, competitor tracking, and lead generation. 🚀

### Features ✨

- 🔍 Scrape Google organic search results with deep data extraction (20+ structured fields per listing)
- 🧠 Collect complete Knowledge Panel data including title, summary, key facts, social links, and related entities
- 📰 Extract Top Stories / News carousel results (headline, URL, publisher, publish date, image preview)
- 🎥 Capture Video search results (title, link, platform/channel name, duration, upload date)
- 💡 Identify and extract Featured Snippets (paragraph, list, and table formats with source attribution)
- ❓ Scrape People Also Ask (PAA) questions for better keyword insights
- 🖼️ Extract Image Pack / image carousel results with image preview links
- 🔗 Fetch Related Searches suggestions shown by Google
- 🌐 Supports multiple Google regional domains (google.com, google.co.in, google.co.uk, etc.)
- 📢 Capable of retrieving up to 50,000 results per execution
- 🌍 Works with 200+ countries and multilingual search support
- ⏳ Supports time-based search filters (past hour, 24 hours, week, month, year, or custom range)

### Use Cases 💡

- 📊 SEO research and keyword ranking analysis
- 🏢 Competitor research and market analysis
- 📈 SERP monitoring and tracking
- 🔗 Link building research
- 📰 Content research and ideation
- 🧠 Knowledge graph data extraction

### How It Works 🛠️

1. Set your search query and parameters in the input
2. The Actor searches Google using localized domains
3. All organic results and SERP features are extracted with maximum detail
4. Each result type is pushed as individual dataset items
5. All data is saved to your Apify dataset

### Input Parameters 📝

| Parameter | Type | Description | Default |
|-----------|------|-------------|---------|
| `query` | string | Your search term | "Elon Musk" |
| `maxItems` | integer | Maximum organic results to collect (10-50000) | 10 |
| `gl` | string | Google country code (e.g., "us", "in", "uk") | - |
| `hl` | string | UI language (e.g., "en", "hi", "fr") | - |
| `lr` | string | Language of results (e.g., "lang_en") | - |
| `cr` | string | Country restriction for results | - |
| `time_period` | string | Time filter (last_hour/day/week/month/year/custom) | - |
| `nfpr` | integer | Disable auto-correction (0 or 1) | - |
| `filter` | integer | Filter similar results (0 or 1) | - |

### Output 📊

#### Organic Results (`type: "organic"`)

| Field | Description |
|-------|-------------|
| `position` | Result position (1, 2, 3...) |
| `title` | Page title |
| `link` | Full URL |
| `domain` | Domain name |
| `siteName` | Site name (e.g., "Wikipedia", "Forbes") |
| `displayedUrl` | URL as displayed in Google |
| `favicon` | Favicon image URL |
| `breadcrumbs` | URL breadcrumb path segments |
| `snippet` | Description snippet |
| `snippetHtml` | Full HTML of the snippet |
| `emphasis` | Bold/emphasized words in snippet |
| `date` | Date if present in snippet |
| `rating` | Star rating if present |
| `ratingCount` | Number of reviews |
| `price` | Price if present |
| `thumbnail` | Thumbnail image URL |
| `richResultType` | Rich result type (review, recipe, video, faq) |
| `additionalInfo` | Extra info line |
| `cacheLink` | Google cache URL |
| `sitelinks` | Sitelink sub-results |
| `searchQuery` | The search query used |
| `searchPage` | Page number |
| `scrapedAt` | ISO timestamp |

#### Knowledge Panel (`type: "knowledgePanel"`)

| Field | Description |
|-------|-------------|
| `title` | Entity name |
| `subtitle` | Entity type/category |
| `description` | Wikipedia description |
| `descriptionSource` | Source of description |
| `descriptionLink` | Link to source |
| `image` | Entity image URL |
| `facts` | Key-value facts (Born, Spouse, etc.) |
| `socialProfiles` | Social media links |
| `peopleAlsoSearchFor` | Related entities |
| `website` | Official website |

#### Top Stories (`type: "topStory"`)

| Field | Description |
|-------|-------------|
| `title` | Article headline |
| `link` | Article URL |
| `source` | Publisher name |
| `date` | Publication date |
| `thumbnail` | Article thumbnail |

#### Video Results (`type: "video"`)

| Field | Description |
|-------|-------------|
| `title` | Video title |
| `link` | Video URL |
| `source` | Video platform |
| `channel` | Channel name |
| `date` | Upload date |
| `duration` | Video length |
| `thumbnail` | Video thumbnail |

#### Other SERP Features

- **Featured Snippet** (`type: "featuredSnippet"`): Answer box with text, sourceUrl, snippetType
- **People Also Ask** (`type: "peopleAlsoAsk"`): Array of related questions
- **Image Pack** (`type: "image"`): Thumbnail, alt text, source URL
- **Related Searches** (`type: "relatedSearch"`): Query text and search link
- **Search Metadata** (`type: "searchMetadata"`): Summary with counts of all features

### Example Output 📋

#### Result
```json
{
	"position": 1,
	"title": "Elon Musk",
	"link": "https://en.wikipedia.org/wiki/Elon_Musk",
	"displayedUrl": "https://en.wikipedia.org › wiki › Elon_Musk",
	"domain": "en.wikipedia.org",
	"siteName": "Wikipedia",
	"favicon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAAAcCAAAAABXZoBIAAAAnklEQVR4AeTNIQiDQABG4b+u17X1aF6PK3YEO9iMJqPVau82y4FgMezS0oVLhqsHtrcqeqzDXv3CEz/6L4yTtZM3dnHmPTtjzXZAXKYVo4agkU2GI2Lloc6JDez1+flswMu1EQZ3xlE7lK8eKDkjtwE+crBMV+wesKmCiisGGepZIfQJpMj9SNb2MYWrChjVkULuCyCfRvsdmBieyQQAsoDk/9ryhFMAAAAASUVORK5CYII=",
	"breadcrumbs": [
		"› wiki › Elon_Musk",
		"Wikipedia",
		"› wiki › Elon_Musk"
	],
	"snippet": "Elon Reeve Musk is a businessman and entrepreneur known for his leadership of Tesla, SpaceX, X, and xAI. Musk has been the wealthiest person in the world ...Read more",
	"snippetHtml": "<div class=\"VwiC3b yXK7lf p4wth r025kc Hdw6tb\" style=\"-webkit-line-clamp:2\"><span>Elon Reeve Musk is <em>a businessman and entrepreneur</em> known for his leadership of Tesla, SpaceX, X, and xAI. Musk has been the wealthiest person in the world&nbsp;...</span><a class=\"vzmbzf\" aria-describedby=\"_diX7ady_DZqrp84Pt_rKuAU_39\" href=\"https://en.wikipedia.org/wiki/Elon_Musk#:~:text=Elon%20Reeve%20Musk%20(%2F%CB%88i%CB%90l%C9%92n%2F%20EE%2Dlon%3B&amp;text=is%20a%20businessman%20and%20entrepreneur,wealthiest%20person%20in%20the%20world\" ping=\"/url?sa=t&amp;source=web&amp;rct=j&amp;opi=89978449&amp;url=https://en.wikipedia.org/wiki/Elon_Musk%23:~:text%3DElon%2520Reeve%2520Musk%2520(%252F%25CB%2588i%25CB%2590l%25C9%2592n%252F%2520EE%252Dlon%253B%26text%3Dis%2520a%2520businessman%2520and%2520entrepreneur,wealthiest%2520person%2520in%2520the%2520world&amp;ved=2ahUKEwjc0vyCx6SUAxWa1ckDHTe9ElcQ77oQegQIJhAC\"><span>Read more</span></a></div>",
	"emphasis": [
		"a businessman and entrepreneur"
	],
	"date": "",
	"thumbnail": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABwAAAAcCAAAAABXZoBIAAAAnklEQVR4AeTNIQiDQABG4b+u17X1aF6PK3YEO9iMJqPVau82y4FgMezS0oVLhqsHtrcqeqzDXv3CEz/6L4yTtZM3dnHmPTtjzXZAXKYVo4agkU2GI2Lloc6JDez1+flswMu1EQZ3xlE7lK8eKDkjtwE+crBMV+wesKmCiisGGepZIfQJpMj9SNb2MYWrChjVkULuCyCfRvsdmBieyQQAsoDk/9ryhFMAAAAASUVORK5CYII=",
	"richResultType": "faq",
	"type": "organic",
	"searchQuery": "Elon Musk",
	"searchPage": 1,
	"searchUrl": "https://www.google.com/search?q=Elon+Musk&start=0&num=10&sei=dSX7afv0AorJwN4P5I68oQo",
	"scrapedAt": "2026-05-06T11:23:38.562Z"
}
````

### Proxy Configuration 🌐

For best results, use **RESIDENTIAL** proxy group:

```json
{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}
```

# Actor input Schema

## `query` (type: `string`):

The search term to use

## `maxItems` (type: `integer`):

Maximum number of search results to retrieve

## `gl` (type: `string`):

The Google country to use for the query

## `hl` (type: `string`):

The Google UI language to return results

## `lr` (type: `string`):

Limit the results to a specific language

## `cr` (type: `string`):

Limit the results to a specific country

## `time_period` (type: `string`):

Time period for results

## `time_period_min` (type: `string`):

Minimum date for custom time period (MM/DD/YYYY)

## `time_period_max` (type: `string`):

Maximum date for custom time period (MM/DD/YYYY)

## `nfpr` (type: `integer`):

Exclude results from auto-corrected queries (0 or 1)

## `filter` (type: `integer`):

Enable/disable Similar Results and Omitted Results filters (0 or 1)

## `proxyConfiguration` (type: `object`):

Apify Proxy configuration. Use RESIDENTIAL group for best results.

## Actor input object example

```json
{
  "query": "Elon Musk",
  "maxItems": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "query": "Elon Musk",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapeai/google-search-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "query": "Elon Musk",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapeai/google-search-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "query": "Elon Musk",
  "maxItems": 10
}' |
apify call scrapeai/google-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapeai/google-search-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Search Scraper",
        "description": "Scrape Google Search results with deep extraction. Collect organic results (20+ fields), featured snippets, People Also Ask, Knowledge Panel, Top Stories, videos, image packs, and related searches. Supports localized Google domains, 200+ countries/languages, and time-based filters.",
        "version": "0.0",
        "x-build-id": "deobzpmdv3jgVIYce"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/scrapeai~google-search-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-scrapeai-google-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/scrapeai~google-search-scraper/runs": {
            "post": {
                "operationId": "runs-sync-scrapeai-google-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/scrapeai~google-search-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-scrapeai-google-search-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "query",
                    "maxItems"
                ],
                "properties": {
                    "query": {
                        "title": "Search Query",
                        "type": "string",
                        "description": "The search term to use",
                        "default": "Elon Musk"
                    },
                    "maxItems": {
                        "title": "Maximum Items",
                        "minimum": 10,
                        "maximum": 50000,
                        "type": "integer",
                        "description": "Maximum number of search results to retrieve",
                        "default": 10
                    },
                    "gl": {
                        "title": "Google Country",
                        "enum": [
                            "af",
                            "al",
                            "dz",
                            "as",
                            "ad",
                            "ao",
                            "ai",
                            "aq",
                            "ag",
                            "ar",
                            "am",
                            "aw",
                            "ac",
                            "au",
                            "at",
                            "az",
                            "bs",
                            "bh",
                            "bd",
                            "bb",
                            "by",
                            "be",
                            "bz",
                            "bj",
                            "bm",
                            "bt",
                            "bo",
                            "ba",
                            "bw",
                            "bv",
                            "br",
                            "io",
                            "bn",
                            "bg",
                            "bf",
                            "bi",
                            "kh",
                            "cm",
                            "ca",
                            "cv",
                            "cat",
                            "ky",
                            "cf",
                            "td",
                            "cl",
                            "cn",
                            "cx",
                            "cc",
                            "co",
                            "km",
                            "cg",
                            "cd",
                            "ck",
                            "cr",
                            "ci",
                            "hr",
                            "cy",
                            "cz",
                            "dk",
                            "dj",
                            "dm",
                            "do",
                            "tl",
                            "ec",
                            "eg",
                            "sv",
                            "gq",
                            "er",
                            "ee",
                            "et",
                            "fk",
                            "fo",
                            "fj",
                            "fi",
                            "fr",
                            "gf",
                            "pf",
                            "tf",
                            "ga",
                            "gm",
                            "ge",
                            "de",
                            "gh",
                            "gi",
                            "gr",
                            "gl",
                            "gd",
                            "gp",
                            "gu",
                            "gt",
                            "gn",
                            "gw",
                            "gy",
                            "ht",
                            "hm",
                            "hn",
                            "hk",
                            "hu",
                            "is",
                            "in",
                            "id",
                            "iq",
                            "ie",
                            "il",
                            "it",
                            "jm",
                            "jp",
                            "jo",
                            "kz",
                            "ke",
                            "ki",
                            "kw",
                            "kg",
                            "la",
                            "lv",
                            "lb",
                            "ls",
                            "lr",
                            "ly",
                            "li",
                            "lt",
                            "lu",
                            "mo",
                            "mk",
                            "mg",
                            "mw",
                            "my",
                            "mv",
                            "ml",
                            "mt",
                            "mh",
                            "mq",
                            "mr",
                            "mu",
                            "yt",
                            "mx",
                            "fm",
                            "md",
                            "mc",
                            "mn",
                            "ms",
                            "ma",
                            "mz",
                            "na",
                            "nr",
                            "np",
                            "nl",
                            "an",
                            "nc",
                            "nz",
                            "ni",
                            "ne",
                            "ng",
                            "nu",
                            "nf",
                            "mp",
                            "no",
                            "om",
                            "pk",
                            "pw",
                            "ps",
                            "pa",
                            "pg",
                            "py",
                            "pe",
                            "ph",
                            "pn",
                            "pl",
                            "pt",
                            "pr",
                            "qa",
                            "re",
                            "ro",
                            "ru",
                            "rw",
                            "kn",
                            "lc",
                            "vc",
                            "ws",
                            "sm",
                            "st",
                            "sa",
                            "sn",
                            "cs",
                            "sc",
                            "sl",
                            "sg",
                            "sk",
                            "si",
                            "sb",
                            "so",
                            "za",
                            "gs",
                            "kr",
                            "es",
                            "lk",
                            "sh",
                            "pm",
                            "sr",
                            "sj",
                            "sz",
                            "se",
                            "ch",
                            "tw",
                            "tj",
                            "tz",
                            "th",
                            "tg",
                            "tk",
                            "to",
                            "tt",
                            "tn",
                            "tr",
                            "tm",
                            "tc",
                            "tv",
                            "ug",
                            "ua",
                            "ae",
                            "gb",
                            "us",
                            "um",
                            "uy",
                            "uz",
                            "vu",
                            "va",
                            "ve",
                            "vn",
                            "vg",
                            "vi",
                            "wf",
                            "eh",
                            "ye",
                            "zm",
                            "zw"
                        ],
                        "type": "string",
                        "description": "The Google country to use for the query"
                    },
                    "hl": {
                        "title": "UI Language",
                        "enum": [
                            "af",
                            "ak",
                            "sq",
                            "am",
                            "ar",
                            "hy",
                            "az",
                            "eu",
                            "be",
                            "bem",
                            "bn",
                            "bh",
                            "bs",
                            "br",
                            "bg",
                            "km",
                            "ca",
                            "chr",
                            "ny",
                            "zh-cn",
                            "zh-tw",
                            "co",
                            "hr",
                            "cs",
                            "da",
                            "nl",
                            "en",
                            "eo",
                            "et",
                            "ee",
                            "fo",
                            "tl",
                            "fi",
                            "fr",
                            "fy",
                            "gaa",
                            "gl",
                            "ka",
                            "de",
                            "el",
                            "gn",
                            "gu",
                            "ht",
                            "ha",
                            "haw",
                            "he",
                            "iw",
                            "hi",
                            "hu",
                            "is",
                            "ig",
                            "id",
                            "ia",
                            "ga",
                            "it",
                            "ja",
                            "jw",
                            "kn",
                            "kk",
                            "rw",
                            "rn",
                            "kg",
                            "ko",
                            "kri",
                            "ku",
                            "ckb",
                            "ky",
                            "lo",
                            "la",
                            "lv",
                            "ln",
                            "lt",
                            "loz",
                            "lg",
                            "ach",
                            "mk",
                            "mg",
                            "ms",
                            "ml",
                            "mt",
                            "mi",
                            "mr",
                            "mfe",
                            "mo",
                            "mn",
                            "sr-ME",
                            "ne",
                            "pcm",
                            "nso",
                            "no",
                            "nn",
                            "oc",
                            "or",
                            "om",
                            "ps",
                            "fa",
                            "pl",
                            "pt",
                            "pt-br",
                            "pt-pt",
                            "pa",
                            "qu",
                            "ro",
                            "rm",
                            "nyn",
                            "ru",
                            "gd",
                            "sr",
                            "sh",
                            "st",
                            "tn",
                            "crs",
                            "sn",
                            "sd",
                            "si",
                            "sk",
                            "sl",
                            "so",
                            "es",
                            "es-419",
                            "su",
                            "sw",
                            "sv",
                            "tg",
                            "ta",
                            "tt",
                            "te",
                            "th",
                            "ti",
                            "to",
                            "lua",
                            "tum",
                            "tr",
                            "tk",
                            "tw",
                            "ug",
                            "uk",
                            "ur",
                            "uz",
                            "vi",
                            "cy",
                            "wo",
                            "xh",
                            "yi",
                            "yo",
                            "zu"
                        ],
                        "type": "string",
                        "description": "The Google UI language to return results"
                    },
                    "lr": {
                        "title": "Language Results",
                        "enum": [
                            "lang_ar",
                            "lang_hy",
                            "lang_be",
                            "lang_bg",
                            "lang_ca",
                            "lang_zh-cn",
                            "lang_zh-tw",
                            "lang_hr",
                            "lang_cs",
                            "lang_da",
                            "lang_nl",
                            "lang_en",
                            "lang_eo",
                            "lang_et",
                            "lang_tl",
                            "lang_fi",
                            "lang_fr",
                            "lang_de",
                            "lang_el",
                            "lang_iw",
                            "lang_hu",
                            "lang_is",
                            "lang_id",
                            "lang_it",
                            "lang_ja",
                            "lang_ko",
                            "lang_lv",
                            "lang_lt",
                            "lang_no",
                            "lang_fa",
                            "lang_pl",
                            "lang_pt",
                            "lang_ro",
                            "lang_ru",
                            "lang_sr",
                            "lang_sk",
                            "lang_sl",
                            "lang_es",
                            "lang_sv",
                            "lang_th",
                            "lang_tr",
                            "lang_uk",
                            "lang_vi"
                        ],
                        "type": "string",
                        "description": "Limit the results to a specific language"
                    },
                    "cr": {
                        "title": "Country Results",
                        "enum": [
                            "af",
                            "al",
                            "dz",
                            "as",
                            "ad",
                            "ao",
                            "ai",
                            "aq",
                            "ag",
                            "ar",
                            "am",
                            "aw",
                            "ac",
                            "au",
                            "at",
                            "az",
                            "bs",
                            "bh",
                            "bd",
                            "bb",
                            "by",
                            "be",
                            "bz",
                            "bj",
                            "bm",
                            "bt",
                            "bo",
                            "ba",
                            "bw",
                            "bv",
                            "br",
                            "io",
                            "bn",
                            "bg",
                            "bf",
                            "bi",
                            "kh",
                            "cm",
                            "ca",
                            "cv",
                            "cat",
                            "ky",
                            "cf",
                            "td",
                            "cl",
                            "cn",
                            "cx",
                            "cc",
                            "co",
                            "km",
                            "cg",
                            "cd",
                            "ck",
                            "cr",
                            "ci",
                            "hr",
                            "cy",
                            "cz",
                            "dk",
                            "dj",
                            "dm",
                            "do",
                            "tl",
                            "ec",
                            "eg",
                            "sv",
                            "gq",
                            "er",
                            "ee",
                            "et",
                            "fk",
                            "fo",
                            "fj",
                            "fi",
                            "fr",
                            "gf",
                            "pf",
                            "tf",
                            "ga",
                            "gm",
                            "ge",
                            "de",
                            "gh",
                            "gi",
                            "gr",
                            "gl",
                            "gd",
                            "gp",
                            "gu",
                            "gt",
                            "gn",
                            "gw",
                            "gy",
                            "ht",
                            "hm",
                            "hn",
                            "hk",
                            "hu",
                            "is",
                            "in",
                            "id",
                            "iq",
                            "ie",
                            "il",
                            "it",
                            "jm",
                            "jp",
                            "jo",
                            "kz",
                            "ke",
                            "ki",
                            "kw",
                            "kg",
                            "la",
                            "lv",
                            "lb",
                            "ls",
                            "lr",
                            "ly",
                            "li",
                            "lt",
                            "lu",
                            "mo",
                            "mk",
                            "mg",
                            "mw",
                            "my",
                            "mv",
                            "ml",
                            "mt",
                            "mh",
                            "mq",
                            "mr",
                            "mu",
                            "yt",
                            "mx",
                            "fm",
                            "md",
                            "mc",
                            "mn",
                            "ms",
                            "ma",
                            "mz",
                            "na",
                            "nr",
                            "np",
                            "nl",
                            "an",
                            "nc",
                            "nz",
                            "ni",
                            "ne",
                            "ng",
                            "nu",
                            "nf",
                            "mp",
                            "no",
                            "om",
                            "pk",
                            "pw",
                            "ps",
                            "pa",
                            "pg",
                            "py",
                            "pe",
                            "ph",
                            "pn",
                            "pl",
                            "pt",
                            "pr",
                            "qa",
                            "re",
                            "ro",
                            "ru",
                            "rw",
                            "kn",
                            "lc",
                            "vc",
                            "ws",
                            "sm",
                            "st",
                            "sa",
                            "sn",
                            "cs",
                            "sc",
                            "sl",
                            "sg",
                            "sk",
                            "si",
                            "sb",
                            "so",
                            "za",
                            "gs",
                            "kr",
                            "es",
                            "lk",
                            "sh",
                            "pm",
                            "sr",
                            "sj",
                            "sz",
                            "se",
                            "ch",
                            "tw",
                            "tj",
                            "tz",
                            "th",
                            "tg",
                            "tk",
                            "to",
                            "tt",
                            "tn",
                            "tr",
                            "tm",
                            "tc",
                            "tv",
                            "ug",
                            "ua",
                            "ae",
                            "gb",
                            "us",
                            "um",
                            "uy",
                            "uz",
                            "vu",
                            "va",
                            "ve",
                            "vn",
                            "vg",
                            "vi",
                            "wf",
                            "eh",
                            "ye",
                            "zm",
                            "zw"
                        ],
                        "type": "string",
                        "description": "Limit the results to a specific country"
                    },
                    "time_period": {
                        "title": "Time Period",
                        "enum": [
                            "last_hour",
                            "last_day",
                            "last_week",
                            "last_month",
                            "last_year",
                            "custom"
                        ],
                        "type": "string",
                        "description": "Time period for results"
                    },
                    "time_period_min": {
                        "title": "Custom Time Period Min",
                        "type": "string",
                        "description": "Minimum date for custom time period (MM/DD/YYYY)"
                    },
                    "time_period_max": {
                        "title": "Custom Time Period Max",
                        "type": "string",
                        "description": "Maximum date for custom time period (MM/DD/YYYY)"
                    },
                    "nfpr": {
                        "title": "No Autocorrect",
                        "minimum": 0,
                        "maximum": 1,
                        "type": "integer",
                        "description": "Exclude results from auto-corrected queries (0 or 1)"
                    },
                    "filter": {
                        "title": "Filter",
                        "minimum": 0,
                        "maximum": 1,
                        "type": "integer",
                        "description": "Enable/disable Similar Results and Omitted Results filters (0 or 1)"
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Apify Proxy configuration. Use RESIDENTIAL group for best results.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
