# Changelog of Google Trends Scraper: Reliable & Fast (`cylindrical_lighthouse/google-trends`) Actor

- **URL**: https://apify.com/cylindrical\_lighthouse/google-trends/changelog.md
- **Full Actor documentation**: https://apify.com/cylindrical\_lighthouse/google-trends.md

## Changelog

All notable changes to this Actor are documented here. Format: [Keep a Changelog](https://keepachangelog.com/), versioning: [SemVer](https://semver.org/).

### \[1.0.1] - 2026-09-29

First public release on Apify Store.

#### Added

- Output schema: all six dataset views plus the `RUN_SUMMARY` record.

#### Fixed

- A completely empty input now runs the Console example (coffee, tea) instead of failing. This is done in code, not as a schema default: a short-lived schema default (build 1.0.5) also added coffee/tea reports to Trending-Now-only runs, and that is fixed.

#### Changed

- Pay-per-event prices set for all six tiers: `keyword-report` $0.003 / $0.0025 / $0.0022 / $0.002; `trending-now-item` $0.0005 / $0.0004 / $0.00035 / $0.0003; `actor-start` $0.0005.

### \[1.0.0] - 2026-09-29

#### Added

- Keyword reports from Google Trends: interest over time (ISO-8601 UTC dates, `isPartial` flag), interest by region (country, region, metro or city level), and top and rising related queries with `isBreakout`.
- Comparisons of up to 5 terms on one shared 0–100 scale, with `comparedWith` on each report.
- Filters: 3,600+ locations, 1,100+ categories, web/image/news/Shopping/YouTube search, preset time ranges and custom date ranges, and topic IDs.
- Summary statistics: `averageInterest`, `peakInterest`, `peakDate`, `latestInterest`.
- Trending Now per country (4 h / 24 h / 48 h / 7 d), with search volume, % increase, start and end time, breakdown queries and categories, plus category and active-only filters.
- Reliable HTTP client: recognises Google's cookie handshake (first 429), rotates to a fresh IP only on real rate limits, falls back to residential proxy, and stops before the run timeout instead of hanging.
- Pay-per-event pricing: `actor-start`, `keyword-report`, `trending-now-item`. "Not enough data" reports and failed queries are not charged. Honours the maximum cost per run and `maxItems`.
- Migration-safe progress (no duplicate work or charges after a platform migration).
- Dataset views: Keyword overview, Interest over time, Interest by region, Related queries, Trending Now, Errors.
- `RUN_SUMMARY` record with totals and request statistics.