# Changelog of Google Trends Scraper & API (pytrends Alternative) (`cleandata-labs/google-trends-explorer`) Actor

- **URL**: https://apify.com/cleandata-labs/google-trends-explorer/changelog.md
- **Full Actor documentation**: https://apify.com/cleandata-labs/google-trends-explorer.md

## Changelog

All notable changes to Google Trends Scraper (Google Trends Explorer). Dates are UTC. Small internal refactors and documentation-only updates are omitted.

### 0.1.17 (2026-10-31)

#### Documentation

- Related topics are currently not returned by Google (observed since 2026-10-27); the README and the input description were clarified. Empty related-topics rows are not charged. Related queries are not affected. No code or pricing changes.

### 0.1.14 (2026-10-29)

#### Fixes

- A run started without any keyword, Trends URL or Trending Now country (for example a bare `{}` API call) now runs the documented demo (`chatgpt` vs `gemini`, US) instead of failing. Fields that are sent but empty stop with a clear message and nothing charged.

### 0.1.12 – 0.1.13 (2026-10-28)

#### Reliability

- HTTP 403 and "unusual traffic" responses are handled like rate limits (new session, backoff) and `Retry-After` is honoured.
- Requests rejected by Google (HTTP 400) stop with a clear message pointing to the wrong geo, time range or category instead of being retried.
- If Apify Proxy refuses the connection, or the chosen proxy group is not available to the account, the run continues without proxy instead of failing.
- When every query fails, the run reports why (for example persistent rate limiting) and confirms that nothing was charged.

#### Fixes

- More forgiving input: lower-case and alias country codes (`uk`, `us_ca`, `worldwide`), custom date ranges such as `2025/01/01 - 2025/06/30` or `2025-01-01 to 2025-06-30`, and a single string where a list is expected. Invalid geos are reported in a free error row instead of breaking the run.

### 0.1 (2026-10-27)

#### Initial release

- Interest over time, interest by region (country, region, city, metro), related queries and related topics (top and rising, with `rank`, `isBreakout` and `growthPercent`), keyword comparison and Trending Now per country.
- Web, YouTube, News, Images and Shopping properties; Google Trends autocomplete suggestions with topic IDs.
- Google Trends URLs accepted as input; optional flat output for CSV and Sheets.
- Session and proxy rotation with backoff; no-data rows and failed queries are free.
