# Google Trends Scraper (`leadsbrary/google-trends-scraper`) Actor

FAST & CHEAP — $1 / 1,000 results. Scrape Google Trends by keyword or URL: trends over time, subregions, related queries/topics, locations, time ranges and categories. Export data, run via API, schedule and monitor runs.

- **URL**: https://apify.com/leadsbrary/google-trends-scraper.md
- **Developed by:** [Alexandre Manguis](https://apify.com/leadsbrary) (community)
- **Categories:** Automation, SEO tools, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 Trends Scraper

Extract Google Trends data for any search term — interest over time, interest by region, and related queries. Supports single terms, comparison groups, Google Trends URLs, and public Google Sheets.

No API key required.

---

### What you get

For each term or URL, the actor returns one item in the dataset:

| Field | Description |
|---|---|
| `interestOverTime_timelineData` | Weekly or daily interest scores (0–100) over the selected period |
| `interestOverTime_averages` | Average interest score per compared term |
| `interestBy` | Interest by country (when geo = Worldwide) |
| `interestBySubregion` | Interest by region within a country |
| `interestByCity` | Interest by city |
| `interestByMetro` | Interest by metro area |
| `relatedQueries_top` | Top related search queries |
| `relatedQueries_rising` | Breakout related search queries |
| `relatedTopics_top` | Top related topics |
| `relatedTopics_rising` | Rising related topics |
| `widgetErrors` | List of widgets that returned no data (empty = everything worked) |

---

### Input

#### Single term

```json
{
  "searchTerms": ["web scraping"]
}
````

#### Compare terms

Separate terms with a comma inside the same item and enable `isMultiple`. Google Trends compares up to 5 terms.

```json
{
  "searchTerms": ["ChatGPT, Claude, Gemini"],
  "isMultiple": true
}
```

#### Specific country + time range

```json
{
  "searchTerms": ["intelligence artificielle"],
  "geo": "FR",
  "timeRange": "today 12-m",
  "viewedFrom": "fr"
}
```

#### From a Google Trends URL

Paste any Google Trends explore URL directly. All parameters (term, geo, date, category) are read from the URL.

```json
{
  "startUrls": [
    { "url": "https://trends.google.com/trends/explore?date=today%2012-m&geo=US&q=web+scraping" }
  ]
}
```

#### From a public Google Sheet

Provide the spreadsheet ID. The actor reads the first column, skipping the first row (treated as a header).

```json
{
  "spreadsheetId": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms"
}
```

***

### All input parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `searchTerms` | string\[] | — | Search terms to scrape |
| `isMultiple` | boolean | `false` | Treat commas as comparison groups |
| `startUrls` | object\[] | — | Google Trends explore URLs |
| `spreadsheetId` | string | — | Public Google Sheet ID (one term per row) |
| `timeRange` | string | `""` | See options below |
| `customTimeRange` | string | — | Custom date range, e.g. `2024-01-01 2024-12-31` |
| `geo` | string | `""` | Country code (`US`, `FR`, `DE`…). Empty = Worldwide |
| `viewedFrom` | string | — | Proxy country for geo-accurate results (`us`, `fr`…) |
| `category` | string | `""` | Google Trends category ID. Empty = All categories |
| `maxItems` | number | `0` | Max tasks to process. `0` = unlimited |
| `maxConcurrency` | number | `10` | Number of parallel requests |
| `maxRequestRetries` | number | `7` | Retries per failed request |
| `pageLoadTimeoutSecs` | number | `180` | Timeout in seconds per task |

#### Time range options

| Value | Period |
|---|---|
| `""` | Past 12 months *(default)* |
| `now 1-H` | Past hour |
| `now 4-H` | Past 4 hours |
| `now 1-d` | Past day |
| `now 7-d` | Past 7 days |
| `today 1-m` | Past 30 days |
| `today 3-m` | Past 90 days |
| `today 5-y` | Past 5 years |
| `all` | 2004–present |

***

### Output example

```json
{
  "searchTerm": "web scraping",
  "searchTerms": ["web scraping"],
  "geo": "",
  "timeRange": "today 12-m",
  "exploreUrl": "https://trends.google.com/trends/explore?date=today+12-m&q=web+scraping&hl=en-US",

  "interestOverTime_timelineData": [
    {
      "time": "1747526400",
      "formattedTime": "May 18 – 24, 2025",
      "value": [33],
      "formattedValue": ["33"],
      "hasData": [true]
    }
  ],
  "interestOverTime_averages": [72],

  "interestBy": [
    {
      "geoCode": "US",
      "geoName": "United States",
      "value": [100],
      "formattedValue": ["100"],
      "hasData": [true]
    },
    {
      "geoCode": "IN",
      "geoName": "India",
      "value": [87],
      "formattedValue": ["87"],
      "hasData": [true]
    }
  ],

  "interestBySubregion": [],
  "interestByCity": [],
  "interestByMetro": [],

  "relatedQueries_top": [
    {
      "query": "web data scraping",
      "value": 100,
      "formattedValue": "100",
      "hasData": true,
      "link": "/trends/explore?q=web+data+scraping&date=today+12-m"
    },
    {
      "query": "python web scraping",
      "value": 78,
      "formattedValue": "78",
      "hasData": true,
      "link": "/trends/explore?q=python+web+scraping&date=today+12-m"
    }
  ],
  "relatedQueries_rising": [
    {
      "query": "ai web scraping",
      "value": 5000,
      "formattedValue": "Breakout",
      "hasData": true,
      "link": "/trends/explore?q=ai+web+scraping&date=today+12-m"
    }
  ],

  "relatedTopics_top": [],
  "relatedTopics_rising": [],

  "widgetErrors": [],
  "scrapedAt": "2026-05-20T07:44:57.000Z"
}
```

> `interestBySubregion`, `interestByCity`, and `interestByMetro` are only populated when a specific `geo` country is set. `interestBy` (countries) is returned for Worldwide searches. Some fields may be empty for low-volume terms or short time ranges.

***

### Tips

- **For country-specific results**, set both `geo` (e.g. `"US"`) and `viewedFrom` (e.g. `"us"`). `viewedFrom` routes requests through a residential proxy in that country, which gives the most accurate local data.
- **For comparisons**, enable `isMultiple` and separate terms with a comma: `"ChatGPT, Claude"`. Each result item will include a `searchTerm` field identifying which term the data belongs to.
- **For large lists**, use `spreadsheetId` with a public Google Sheet and set `maxConcurrency` between 3 and 5 to stay within rate limits.
- **Empty `widgetErrors`** means all data was retrieved successfully.

***

### Keywords

google trends, search trends, keyword trends, trending topics, interest over time, related queries, related topics, geographic interest, search volume, trend analysis, keyword research, SEO trends, topic popularity, google search data, search interest, trend scraper, google data, market research, trend monitoring, google trends api, trending keywords, search popularity, breakout queries, rising queries, trend data export, google trends csv, competitor comparison, brand tracking, search demand

# Actor input Schema

## `searchTerms` (type: `array`):

Required if spreadsheetId and startUrls are not provided. Add one search term per item. When Multiple terms is enabled, commas inside an item are treated as a Google Trends comparison group.

## `isMultiple` (type: `boolean`):

If checked, a comma inside a searchTerms item is handled as multiple compared terms, for example: bitcoin, ethereum.

## `timeRange` (type: `string`):

Choose a predefined search time range. Empty value means Past 12 months.

## `geo` (type: `string`):

Google Trends geo area. Empty value means Worldwide. Google Trends URLs in startUrls override this value.

## `viewedFrom` (type: `string`):

Optional country code for Apify residential proxies to improve geo-correct Google Trends results. Leave empty for direct requests.

## `skipDebugScreen` (type: `boolean`):

By default, a small debug JSON snapshot for each input is saved to the Key-value store. Enable this to skip those snapshots.

## `startUrls` (type: `array`):

Copy Google Trends explore URLs here. URL query parameters such as q, date, geo, cat, gprop, hl, and tz override the corresponding input settings for that URL.

## `spreadsheetId` (type: `string`):

Optional public Google Sheet ID. The first column is read as search terms and row 1 is skipped as a header. The sheet must be publicly accessible.

## `category` (type: `string`):

Choose a category to filter the search. Empty value means All categories.

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

Maximum number of input tasks to scrape. Zero means no limit.

## `customTimeRange` (type: `string`):

Custom time range. If present, it takes precedence over timeRange. Format: YYYY-MM-DD YYYY-MM-DD, for example 2024-01-01 2024-12-31.

## `maxConcurrency` (type: `integer`):

How many Google Trends inputs will be processed in parallel.

## `maxRequestRetries` (type: `integer`):

How many times the Actor retries failed Google Trends API requests.

## `pageLoadTimeoutSecs` (type: `integer`):

HTTP request timeout in seconds.

## Actor input object example

```json
{
  "searchTerms": [
    "web scraping"
  ],
  "isMultiple": false,
  "timeRange": "",
  "geo": "",
  "viewedFrom": "",
  "skipDebugScreen": false,
  "startUrls": [
    {
      "url": "https://trends.google.com/trends/explore?date=today%2012-m&q=web%20scraping"
    }
  ],
  "category": "",
  "maxItems": 0,
  "maxConcurrency": 10,
  "maxRequestRetries": 7,
  "pageLoadTimeoutSecs": 180
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "searchTerms": [
        "web scraping"
    ],
    "startUrls": [
        {
            "url": "https://trends.google.com/trends/explore?date=today%2012-m&q=web%20scraping"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("leadsbrary/google-trends-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 = {
    "searchTerms": ["web scraping"],
    "startUrls": [{ "url": "https://trends.google.com/trends/explore?date=today%2012-m&q=web%20scraping" }],
}

# Run the Actor and wait for it to finish
run = client.actor("leadsbrary/google-trends-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 '{
  "searchTerms": [
    "web scraping"
  ],
  "startUrls": [
    {
      "url": "https://trends.google.com/trends/explore?date=today%2012-m&q=web%20scraping"
    }
  ]
}' |
apify call leadsbrary/google-trends-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Trends Scraper",
        "description": "FAST & CHEAP — $1 / 1,000 results. Scrape Google Trends by keyword or URL: trends over time, subregions, related queries/topics, locations, time ranges and categories. Export data, run via API, schedule and monitor runs.",
        "version": "0.1",
        "x-build-id": "CTm04j6dVXfQvmz0v"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/leadsbrary~google-trends-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-leadsbrary-google-trends-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/leadsbrary~google-trends-scraper/runs": {
            "post": {
                "operationId": "runs-sync-leadsbrary-google-trends-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/leadsbrary~google-trends-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-leadsbrary-google-trends-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",
                "properties": {
                    "searchTerms": {
                        "title": "Search terms",
                        "type": "array",
                        "description": "Required if spreadsheetId and startUrls are not provided. Add one search term per item. When Multiple terms is enabled, commas inside an item are treated as a Google Trends comparison group.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "isMultiple": {
                        "title": "Multiple terms",
                        "type": "boolean",
                        "description": "If checked, a comma inside a searchTerms item is handled as multiple compared terms, for example: bitcoin, ethereum.",
                        "default": false
                    },
                    "timeRange": {
                        "title": "Time range",
                        "enum": [
                            "",
                            "now 1-H",
                            "now 4-H",
                            "now 1-d",
                            "now 7-d",
                            "today 1-m",
                            "today 3-m",
                            "today 5-y",
                            "all"
                        ],
                        "type": "string",
                        "description": "Choose a predefined search time range. Empty value means Past 12 months.",
                        "default": ""
                    },
                    "geo": {
                        "title": "Geo area",
                        "enum": [
                            "",
                            "AF",
                            "AL",
                            "DZ",
                            "AS",
                            "AD",
                            "AO",
                            "AI",
                            "AQ",
                            "AG",
                            "AR",
                            "AM",
                            "AW",
                            "AU",
                            "AT",
                            "AZ",
                            "BS",
                            "BH",
                            "BD",
                            "BB",
                            "BY",
                            "BE",
                            "BZ",
                            "BJ",
                            "BM",
                            "BT",
                            "BO",
                            "BQ",
                            "BA",
                            "BW",
                            "BV",
                            "BR",
                            "IO",
                            "BN",
                            "BG",
                            "BF",
                            "BI",
                            "CV",
                            "KH",
                            "CM",
                            "CA",
                            "KY",
                            "CF",
                            "TD",
                            "CL",
                            "CN",
                            "CX",
                            "CC",
                            "CO",
                            "KM",
                            "CG",
                            "CD",
                            "CK",
                            "CR",
                            "CI",
                            "HR",
                            "CU",
                            "CW",
                            "CY",
                            "CZ",
                            "DK",
                            "DJ",
                            "DM",
                            "DO",
                            "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",
                            "GG",
                            "GN",
                            "GW",
                            "GY",
                            "HT",
                            "HM",
                            "VA",
                            "HN",
                            "HK",
                            "HU",
                            "IS",
                            "IN",
                            "ID",
                            "IR",
                            "IQ",
                            "IE",
                            "IM",
                            "IL",
                            "IT",
                            "JM",
                            "JP",
                            "JE",
                            "JO",
                            "KZ",
                            "KE",
                            "KI",
                            "KP",
                            "KR",
                            "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",
                            "ME",
                            "MS",
                            "MA",
                            "MZ",
                            "MM",
                            "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",
                            "BL",
                            "SH",
                            "KN",
                            "LC",
                            "MF",
                            "PM",
                            "VC",
                            "WS",
                            "SM",
                            "ST",
                            "SA",
                            "SN",
                            "RS",
                            "SC",
                            "SL",
                            "SG",
                            "SX",
                            "SK",
                            "SI",
                            "SB",
                            "SO",
                            "ZA",
                            "GS",
                            "SS",
                            "ES",
                            "LK",
                            "SD",
                            "SR",
                            "SJ",
                            "SZ",
                            "SE",
                            "CH",
                            "SY",
                            "TW",
                            "TJ",
                            "TZ",
                            "TH",
                            "TL",
                            "TG",
                            "TK",
                            "TO",
                            "TT",
                            "TN",
                            "TR",
                            "TM",
                            "TC",
                            "TV",
                            "UG",
                            "UA",
                            "AE",
                            "GB",
                            "US",
                            "UM",
                            "UY",
                            "UZ",
                            "VU",
                            "VE",
                            "VN",
                            "VG",
                            "VI",
                            "WF",
                            "EH",
                            "YE",
                            "ZM",
                            "ZW"
                        ],
                        "type": "string",
                        "description": "Google Trends geo area. Empty value means Worldwide. Google Trends URLs in startUrls override this value.",
                        "default": ""
                    },
                    "viewedFrom": {
                        "title": "Country to view Trends from",
                        "enum": [
                            "",
                            "us",
                            "af",
                            "al",
                            "dz",
                            "as",
                            "ad",
                            "ao",
                            "ai",
                            "aq",
                            "ag",
                            "ar",
                            "am",
                            "aw",
                            "au",
                            "at",
                            "az",
                            "bs",
                            "bh",
                            "bd",
                            "bb",
                            "by",
                            "be",
                            "bz",
                            "bj",
                            "bm",
                            "bt",
                            "bo",
                            "ba",
                            "bw",
                            "br",
                            "io",
                            "bn",
                            "bg",
                            "bf",
                            "bi",
                            "kh",
                            "cm",
                            "ca",
                            "cv",
                            "ky",
                            "cf",
                            "td",
                            "cl",
                            "cn",
                            "cx",
                            "cc",
                            "co",
                            "km",
                            "cg",
                            "cd",
                            "ck",
                            "cr",
                            "ci",
                            "hr",
                            "cu",
                            "cy",
                            "cz",
                            "dk",
                            "dj",
                            "dm",
                            "do",
                            "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",
                            "va",
                            "hn",
                            "hk",
                            "hu",
                            "is",
                            "in",
                            "id",
                            "ir",
                            "iq",
                            "ie",
                            "il",
                            "it",
                            "jm",
                            "jp",
                            "jo",
                            "kz",
                            "ke",
                            "ki",
                            "kp",
                            "kr",
                            "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",
                            "me",
                            "ms",
                            "ma",
                            "mz",
                            "mm",
                            "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",
                            "sh",
                            "kn",
                            "lc",
                            "pm",
                            "vc",
                            "ws",
                            "sm",
                            "st",
                            "sa",
                            "sn",
                            "rs",
                            "sc",
                            "sl",
                            "sg",
                            "sk",
                            "si",
                            "sb",
                            "so",
                            "za",
                            "gs",
                            "ss",
                            "es",
                            "lk",
                            "sd",
                            "sr",
                            "sj",
                            "sz",
                            "se",
                            "ch",
                            "sy",
                            "tw",
                            "tj",
                            "tz",
                            "th",
                            "tl",
                            "tg",
                            "tk",
                            "to",
                            "tt",
                            "tn",
                            "tr",
                            "tm",
                            "tc",
                            "tv",
                            "ug",
                            "ua",
                            "ae",
                            "gb",
                            "um",
                            "uy",
                            "uz",
                            "vu",
                            "ve",
                            "vn",
                            "vg",
                            "vi",
                            "wf",
                            "eh",
                            "ye",
                            "zm",
                            "zw"
                        ],
                        "type": "string",
                        "description": "Optional country code for Apify residential proxies to improve geo-correct Google Trends results. Leave empty for direct requests.",
                        "default": ""
                    },
                    "skipDebugScreen": {
                        "title": "Do not save snapshot",
                        "type": "boolean",
                        "description": "By default, a small debug JSON snapshot for each input is saved to the Key-value store. Enable this to skip those snapshots.",
                        "default": false
                    },
                    "startUrls": {
                        "title": "Google Trends URLs",
                        "type": "array",
                        "description": "Copy Google Trends explore URLs here. URL query parameters such as q, date, geo, cat, gprop, hl, and tz override the corresponding input settings for that URL.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL",
                                    "description": "A Google Trends explore URL, e.g. https://trends.google.com/trends/explore?date=today%2012-m&q=web%20scraping"
                                }
                            }
                        }
                    },
                    "spreadsheetId": {
                        "title": "Google sheet ID (To get input data from Google sheet)",
                        "type": "string",
                        "description": "Optional public Google Sheet ID. The first column is read as search terms and row 1 is skipped as a header. The sheet must be publicly accessible."
                    },
                    "category": {
                        "title": "Category of trends",
                        "enum": [
                            "",
                            "3",
                            "47",
                            "44",
                            "22",
                            "12",
                            "5",
                            "7",
                            "71",
                            "8",
                            "45",
                            "65",
                            "11",
                            "13",
                            "958",
                            "19",
                            "16",
                            "299",
                            "14",
                            "66",
                            "29",
                            "533",
                            "174",
                            "18",
                            "20",
                            "67"
                        ],
                        "type": "string",
                        "description": "Choose a category to filter the search. Empty value means All categories.",
                        "default": ""
                    },
                    "maxItems": {
                        "title": "Max items",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of input tasks to scrape. Zero means no limit.",
                        "default": 0
                    },
                    "customTimeRange": {
                        "title": "Custom time range",
                        "type": "string",
                        "description": "Custom time range. If present, it takes precedence over timeRange. Format: YYYY-MM-DD YYYY-MM-DD, for example 2024-01-01 2024-12-31."
                    },
                    "maxConcurrency": {
                        "title": "Max concurrency",
                        "minimum": 1,
                        "type": "integer",
                        "description": "How many Google Trends inputs will be processed in parallel.",
                        "default": 10
                    },
                    "maxRequestRetries": {
                        "title": "Max request retries",
                        "minimum": 1,
                        "type": "integer",
                        "description": "How many times the Actor retries failed Google Trends API requests.",
                        "default": 7
                    },
                    "pageLoadTimeoutSecs": {
                        "title": "Page load timeout",
                        "minimum": 30,
                        "type": "integer",
                        "description": "HTTP request timeout in seconds.",
                        "default": 180
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
