# Google Trend Parser Spider (`hello.datawizards/google-trend-parser-spider`) Actor

The Google Trend Parser Spider extracts real-time trending searches, search volumes, scores, related queries, and article references from Google Trends, delivering clean JSON data for SEO research, market insights, automation, and content strategy.

- **URL**: https://apify.com/hello.datawizards/google-trend-parser-spider.md
- **Developed by:** [datawizards](https://apify.com/hello.datawizards) (community)
- **Categories:** Automation, Lead generation, Agents
- **Stats:** 4 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $10.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 Trend Parser Spider · Apify Actor

Unlock **real-time trending search insights** from Google Trends with structured, analytics-ready JSON.
Built and maintained by **[DataWizards](https://linkedin.com/in/data-wizards-aa8080342)** — your trusted partner for scalable data extraction.

---

### 📌 What Is `Google Trend Parser Spider`?

The **Google Trend Parser Spider** is an advanced Apify Actor designed to automatically fetch **daily trending searches**, **search volumes**, **trend scores**, **related queries**, **category IDs**, and **associated article references** from Google Trends.

This actor helps you stay ahead of what the world is searching for — ideal for market analysts, SEO teams, journalists, brands, researchers, and automation engineers.

It delivers **clean, structured, high-quality JSON** with zero manual browsing.

---

### 🧠 Key Features

#### ✅ Real-Time Trending Topics

Fetches current trending keywords directly from Google Trends.

#### ✅ Deep Trend Intelligence

Includes trend score, search volumes, category IDs, and timestamps.

#### ✅ Rich Related Queries

Extracts dozens of related search terms for clustering & SEO insights.

#### ✅ Article Reference Metadata

Captures Google News article IDs, languages, and regions tied to each trend.

#### ✅ Proxy Support Ready

Full Apify Proxy integration — with **RESIDENTIAL IPs** for safer, more consistent scraping.

#### ✅ JSON Output That Works Everywhere

Directly integrates with dashboards, BI tools, NLP processors, SEO tools, and custom analytics systems.

---

### 🛠️ Input Schema

Using this actor is incredibly simple.

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

***

### 📤 Output Example

Below is the **real structure** returned by the actor:

```json
[
  {
    "title": "all's fair",
    "country": "US",
    "started": "2025-11-04 05:20:00",
    "search_volume": 200000,
    "score": 700,
    "related_queries": [
      "all's fair",
      "alls fair",
      "kim kardashian new show",
      "all's fair cast",
      "all's fair reviews",
      "glenn close",
      "naomi watts",
      "all's fair rotten tomatoes",
      "all's fair review",
      "all is fair",
      "hulu",
      "the guardian",
      "guardian",
      "all fair",
      "fair",
      "all's fair hulu",
      "niecy nash"
    ],
    "category_ids": [4],
    "article_refs": [
      [4253690029, "en", "US"],
      [4281399268, "en", "US"],
      [4278887943, "en", "US"],
      [4280182411, "en", "US"],
      [4231096736, "en", "US"],
      [4253690029, "ja", "US"],
      [4279287127, "ja", "US"],
      [4250866464, "ja", "US"],
      [4268488938, "ja", "US"],
      [4256469948, "ja", "US"],
      [4277801962, "ja", "US"],
      [4278920074, "ja", "US"],
      [4276581687, "ja", "US"],
      [4280045641, "ja", "US"],
      [4279560784, "ja", "US"]
    ]
  }
]
```

***

### 🚀 Use Cases

#### 📊 SEO Intelligence

Discover new trending keywords and build opportunity-driven content.

#### 📰 Media & Journalism

Track what the world is searching for — perfect for newsrooms.

#### 🛍️ Product/Brand Monitoring

Identify sudden surges in interest around brands, products, or influencers.

#### 📈 Market Research

Analyze sentiment shifts, viral moments, & global trend patterns.

#### 🤖 Automation Workflows

Feed real-time trend data into your monitoring bots or dashboards.

#### 🧵 Social Media Content Strategy

Plan high-performing posts based on what people are actively searching.

***

### ✅ Best Practices

✔ Always enable **RESIDENTIAL proxies** to minimize blocking.
✔ Schedule the actor hourly or daily to build long-term trend datasets.
✔ Store article references for news-source correlation analysis.
✔ Use related queries for clustering, NLP, or semantic SEO models.
✔ Combine with your own market research pipelines for deeper insights.

***

### 🧰 Extended Features You Can Request

DataWizards can enhance this actor based on your needs:

✨ Export to CSV, XLSX, or BigQuery
✨ Custom scoring system
✨ Region-based trend breakdowns
✨ Auto-translation of trending topics
✨ Enriched article metadata crawling

If you need something tailored — **we build it for you.**

***

### 🤝 Support

Need custom fields, specific formats, or integration assistance?
**DataWizards are always ready for you!**

📩 Email: **<hello.datawizard@gmail.com>**
✉️ **Subject**: `Google Trend Parser Spider – Custom Support`
🔗 Connect: **<https://linkedin.com/in/data-wizards-aa8080342>**

***

### 🐞 Feedback & Bug Reporting

Found an issue? Want a new feature?

📧 Email: **<hello.datawizard@gmail.com>**
✉️ **Subject**: `Bug Report – Google Trend Parser Spider`

Or open an issue directly on **Apify**.

***

### 💡 Final Notes

If you'd like changes, improvements, or simplified outputs — **DataWizards always has your back.**
Fast, accurate, and scalable data extraction is what we do.

***

#### 🏁 Start analyzing real-time Google Trends like a pro with **Google Trend Parser Spider**.

# Actor input Schema

## `CountryCode` (type: `string`):

The country code for the spider.

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

Specifies proxy servers that will be used by the scraper in order to hide its origin.

## Actor input object example

```json
{
  "CountryCode": "US",
  "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 = {
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("hello.datawizards/google-trend-parser-spider").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 = { "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    } }

# Run the Actor and wait for it to finish
run = client.actor("hello.datawizards/google-trend-parser-spider").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 '{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call hello.datawizards/google-trend-parser-spider --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=hello.datawizards/google-trend-parser-spider",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Google Trend Parser Spider",
        "description": "The Google Trend Parser Spider extracts real-time trending searches, search volumes, scores, related queries, and article references from Google Trends, delivering clean JSON data for SEO research, market insights, automation, and content strategy.",
        "version": "0.0",
        "x-build-id": "x8Ez398lhqpLIN3BU"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/hello.datawizards~google-trend-parser-spider/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-hello.datawizards-google-trend-parser-spider",
                "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/hello.datawizards~google-trend-parser-spider/runs": {
            "post": {
                "operationId": "runs-sync-hello.datawizards-google-trend-parser-spider",
                "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/hello.datawizards~google-trend-parser-spider/run-sync": {
            "post": {
                "operationId": "run-sync-hello.datawizards-google-trend-parser-spider",
                "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": {
                    "CountryCode": {
                        "title": "Country Code",
                        "type": "string",
                        "description": "The country code for the spider.",
                        "default": "US"
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Specifies proxy servers that will be used by the scraper in order to hide its origin.",
                        "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```