{
  "markdown": "# Google Trends Scraper - Trending Now, Search Volume & Trend Duration\n\nReliable Google Trends data on the [Apify](https://apify.com) platform, billed pay-per-event\nin USD. Built and maintained by **orbots**.\n\n> **Not affiliated with, endorsed by, or sponsored by Google LLC.** \"Google\" and \"Google\n> Trends\" are trademarks of Google LLC. This is an independent tool that reads publicly\n> available Google Trends data; it is not an official Google product.\n\n**▶️ Run it on Apify:** https://apify.com/orbots/google-trends-scraper\n\n---\n\n## What it does\n\n- **Trending searches** for 100+ countries and sub-regions (e.g. `US-CA`, `FR-75`), with\n  estimated search volume.\n- **Active trends vs. ended**, plus **trend duration**: how long each trend has been running.\n- **Topic categories** on every term (Google's own 19 categories), with an optional\n  `categories` filter to keep only one vertical.\n- **Interest over time** and **interest by region** for keywords you provide.\n- Up to ~370 terms per run in large markets. **No item cap.**\n- A run that collects nothing is **not charged at all**.\n\n## Why this one\n\n- **Reliability first.** The official Google Trends source is flaky; this Actor is built to\n  degrade gracefully. When part of a request is throttled, it returns the regions that\n  responded and reports the ones that didn't, instead of failing the whole run.\n- **Honest pricing.** A small start fee plus a per-result fee that scales down with volume.\n  A run that returns zero rows costs nothing.\n- **Built for schedules.** With `onlyNew: true` each run returns only the trends you have\n  not received before, per country and window, so a daily schedule stops paying for the\n  same list twice.\n- **Agent-ready.** Exposed to AI agents through Apify's MCP server;\n  see the [MCP page](https://apify.com/orbots/google-trends-scraper/api/mcp).\n\n## Output (shape)\n\nEach row is one trend (trending mode) or one interest data point (keywords mode). Typical\nfields in trending mode:\n\n| field | meaning |\n|---|---|\n| `type` | `trending_now` (or `interest_over_time` / `interest_by_region` in keywords mode) |\n| `term` | the trending query |\n| `rank` | position in the feed (1 = hottest) |\n| `geo` | country or sub-region code (e.g. `US`, `US-CA`, `FR-75`) |\n| `search_volume` / `formatted_volume` | Google's estimated volume, as a number (`200000`) and as the label shown in the UI (`200K+`) |\n| `category` / `categories` | Google's topic category for the term |\n| `is_active` | whether the trend is still running |\n| `started_at` / `ended_at` | trend window timestamps (`ended_at` is `null` while active) |\n| `duration_minutes` | how long the trend lasted, once it has ended |\n| `trends_url` | direct link to the term's Google Trends explore page |\n\n## Quick start\n\nRun from the [Actor page](https://apify.com/orbots/google-trends-scraper), or call it via the\nApify API and get the rows back in one request:\n\n```bash\ncurl -X POST \"https://api.apify.com/v2/acts/orbots~google-trends-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ \"mode\": \"trending\", \"trendingGeos\": [\"US\", \"GB\", \"BR\"], \"trendingHours\": 24 }'\n```\n\nAdd `\"onlyNew\": true` for schedules, or `\"categories\": [\"Sports\"]` to keep one vertical.\nFull input options and examples are on the Actor page.\n\n## Support\n\nIssues and feature requests: open an issue in this repository, or use the **Issues** tab on\nthe [Apify Actor page](https://apify.com/orbots/google-trends-scraper).\n\n---\n\n*orbots builds small, reliable data Actors on Apify. Data is read from publicly available\nsources; see each Actor's page for details and terms.*\n",
  "bytes": 3649,
  "sha": "e86626a8d1fc7c17bd78cb227ff99a8def91b6556eaad2ae4e72a47a174f138d",
  "repo_slug": "orbotshq/google-trends-scraper",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_orbotshq_google_trends_scraper_3f5e746c/readme"
}