Gtrends Actor

Introduction

The Gtrends Actor is a powerful tool designed to scrape and extract trending search data from Google Trends for specified countries. It provides real-time insights into popular search queries, enabling users to analyze trends, monitor public interest, and gather data for various analytical purposes. This actor is ideal for researchers, marketers, and businesses seeking actionable intelligence from global search behaviors.

Features

• Real-Time Data Extraction: Fetches the latest trending topics and search volumes directly from Google Trends.
• Country-Specific Insights: Supports targeted data retrieval for any country using standard country codes (e.g., US for United States).
• Customizable Item Limits: Allows users to specify the maximum number of trends to process, ensuring efficient and focused results.
• Detailed Trend Breakdown: Provides comprehensive lists of related queries for each trend, enhancing depth of analysis.
• High Reliability: Built with robust error handling to ensure consistent performance and data accuracy.
• JSON Output: Delivers structured data in JSON format, compatible with various data processing tools.
• Fast and Scalable: Optimized for quick execution, suitable for both small-scale queries and larger data collection tasks.

Input Parameters

Parameter	Type	Required	Description	Example
country_code	string	Yes	The ISO country code for the region to fetch trends from (e.g., US for United States, NP for Nepal).	"US"
itemLimit	integer	No	Specifies the maximum number of trending items to process. Defaults to 5 if not provided.	10

Example Usage

Input Example

{
  "country_code": "IN",
  "itemLimit": 5
}

Output Example

[
  {
    "title": "new zealand vs india",
    "search_volume": 10000000,
    "started": "2026-01-11 04:30:00",
    "trend_breakdown": [
      "new zealand vs india",
      "ind vs nz",
      "india national cricket team vs new zealand national cricket team match scorecard",
      "india vs new zealand",
      "nz vs ind",
      "new zealand national cricket team vs india national cricket team match scorecard",
      "ind vs nz odi 2026",
      "india vs new zealand 2026",
      "odi",
      "ind vs nz 2nd odi",
      "rajkot",
      "ind vs nz toss",
      "rajkot stadium",
      "ind vs nz 1st odi",
      "ind vs nz odi",
      "shubman gill",
      "ind vs nz toss time",
      "ind vs nz time",
      "india vs nz",
      "india national cricket team vs new zealand national cricket team players",
      "india versus new zealand",
      "ind nz",
      "india-new zealand",
      "india-new zealand match",
      "ind",
      "ind vs nz live",
      "vadodara",
      "in vs nz",
      "ind vs",
      "ind v nz",
      "kuldeep yadav",
      "india national cricket team vs new zealand national cricket team timeline",
      "ind vs new",
      "india new zealand odi",
      "india national cricket team vs new zealand national cricket team",
      "india vs new zealand odi",
      "match score",
      "new zealand national cricket team vs india national cricket team timeline",
      "live match",
      "ind match",
      "cricinfo",
      "india vs",
      "ind vs nz t20",
      "india match today",
      "match today",
      "ind vs new zealand",
      "odi match",
      "odi ind vs nz",
      "where to watch india national cricket team vs new zealand national cricket team",
      "live cricket match",
      "baroda",
      "new zealand national cricket team",
      "hotstar",
      "vadodara international cricket stadium",
      "ind vs nez",
      "today match",
      "ind vs nz scorecard",
      "today match score live",
      "ind vsnz",
      "cricket score live",
      "ind vs nz live score",
      "india versus new zealand match",
      "india-new zealand live match",
      "india-new zealand score",
      "ind vs nz live streaming",
      "ind va nz",
      "new zealand national cricket team vs india national cricket team",
      "india vs new zealand live",
      "india vs new zealand cricket match",
      "today india match",
      "live cricket match today",
      "ind nz odi",
      "india-new zealand live score",
      "kotambi",
      "india vs nz odi",
      "new zealand at india",
      "today cricket match",
      "live match score",
      "india vs new zealand live streaming channel",
      "india-new zealand ka match",
      "india new zealand odi match",
      "live cricket match india vs new zealand",
      "imd vs nz",
      "ind vs nz score",
      "new zealand-india",
      "odi match today",
      "cricket live score today",
      "indvs nz",
      "india national cricket team vs new zealand national cricket team stats",
      "today cricket match live",
      "india vs new zealand odi 2026",
      "ind vs newzealand",
      "india-new zealand one day",
      "where to watch new zealand national cricket team vs india national cricket team",
      "yesterday match",
      "match live",
      "ind nz match",
      "live cricket match today india",
      "virat kohli total centuries",
      "cricbuzz live",
      "ins vs nz",
      "india live match",
      "new zealand",
      "live cricket scores",
      "india cricket match",
      "ind vs bz",
      "cricket match new zealand",
      "new zealand cricket",
      "ind live score",
      "india-new zealand live",
      "cricket odi india vs new zealand",
      "india vs new zealand live match",
      "ind cricket",
      "nz vs ind odi",
      "yesterday match result",
      "nz vs india",
      "ind vs nz.",
      "india today match",
      "india vs new zealand live score",
      "india nz",
      "ind live",
      "live match today",
      "cricket match today",
      "india-new zealand one day match",
      "kohli total centuries",
      "virat kohli total century",
      "kohli centuries",
      "indvsnz",
      "new zealand national cricket team vs india national cricket team stats",
      "india vs nz cricket",
      "india vs new zealand odi squad 2026",
      "new zealand live cricket match",
      "india versus new zealand odi",
      "today match live score",
      "ind vs mz",
      "live cricket score today",
      "dream11",
      "virat kohli international centuries",
      "vadodara cricket stadium",
      "india vs new zealand score",
      "gill",
      "virat kohli century",
      "ind vs nz man of the match",
      "india vs newzeland",
      "new zealand vs india live",
      "india-new zealand match live",
      "kotambi stadium vadodara",
      "vadodara international cricket stadium, kotambi",
      "virat kohli odi centuries",
      "ind vs nz highlights",
      "score ind vs nz",
      "kotambi stadium",
      "nz vs ind live",
      "india national cricket team vs new zealand national cricket",
      "k l rahul",
      "ind matches",
      "india national cricket team vs new zealand national cricket team match scorecard man of the match",
      "india national cricket team vs south africa national cricket team match scorecard",
      "ind vs nzl",
      "india national cricket team vs new zealand national cricket team matches",
      "india vs new zealand toss",
      "india vs new",
      "india cricket schedule",
      "today match time",
      "cricket scores",
      "today live match",
      "ind vs nz today",
      "india new zealand match",
      "ind vs nz where to watch",
      "ind vs nz odi live",
      "india-new zealand odi",
      "ind vs nw",
      "today cricket",
      "cricket india",
      "kohli odi centuries",
      "ind bs nz",
      "india match schedule",
      "india national cricket team vs new zealand national cricket team man of the match"
    ]
  }
]

Use Cases

• Market Research: Analyze trending topics to identify consumer interests and emerging markets in specific countries.
• Competitive Intelligence: Monitor search trends for competitors' products or services to stay ahead.
• Content Creation: Discover popular queries to create relevant blog posts, videos, or social media content.
• Academic Research: Gather data on public interest in topics like sports, politics, or health for studies.
• Business Automation: Automate trend monitoring for timely decision-making in marketing campaigns.
• Event Tracking: Track real-time search spikes during events like sports matches or elections.

Installation and Usage

1. Search for "Gtrends Actor" in the Apify Store.
2. Click "Try for free" or "Run".
3. Configure input parameters (e.g., country_code and itemLimit).
4. Click "Start" to begin extraction.
5. Monitor progress in the log.
6. Export results in your preferred format (JSON, CSV, Excel).

Output Format

The output is a JSON array of objects, each representing a trending topic. Key fields include:

• title: The main trend title (string).
• search_volume: Estimated search volume (integer).
• started: Timestamp when the trend started (string in ISO format).
• trend_breakdown: An array of related search queries (strings) for deeper insights.

This structured format allows easy integration with data analysis tools.

Error Handling

The actor includes built-in error handling for invalid inputs, network issues, or API rate limits. Check the run logs for details on failures. If errors persist, ensure the country_code is valid and retry with lower itemLimit.

Rate Limiting and Best Practices

Google Trends may impose rate limits; avoid excessive runs. Best practices: Use reasonable itemLimits, cache results, and run during off-peak hours. For large-scale needs, contact support for optimizations.

Support

For custom/simplified outputs or bug reports, please contact:

• Email: support@getdataforme.com
• Subject line: "custom support"
• Contact form: https://getdataforme.com/contact/

We're here to help you get the most out of this Actor!