# Changelog of Competitor Keywords Scraper — Ranked Keywords of Any Domain (`steadyfetch/competitor-keywords-scraper`) Actor

- **URL**: https://apify.com/steadyfetch/competitor-keywords-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/steadyfetch/competitor-keywords-scraper.md

## Changelog

### 1.0.4 — 2026-10-07

- **The input form's descriptions now lead with an example.** Every field's first sentence shows the kind of value it takes with one example, "Sort keywords by" now names the values an API call sends — `traffic`, `volume` and `position` — beside what each does, and the description says in plain words that an empty input `{}` returns the ahrefs.com sample. It also points to the sibling actors for scores, volume and CPC on a list you already have, and for keyword ideas grown from a seed. The price, the input fields, the sort orders and the output columns are unchanged.

### 1.0.3 — 2026-10-06

- **A Traditional Chinese language tag now looks up Traditional Chinese.** `zh-HK`, `zh-MO` and `zh-Hant` used to be read as Simplified Chinese, and tags like `zh-Hant-TW` were not read at all, so a Hong Kong or Taiwan run was refused. They now read as Chinese (Traditional), the same as `zh-TW`, and `zh-Hans-*` tags read as Chinese (Simplified). What is charged for a run is exactly what the plain `zh-TW` or `zh-CN` code charges.

### 1.0.2 — 2026-10-04

- **The README links a real sample dataset:** ten keywords one well-known domain ranks for in the United States, from one verified run, unedited, with the domain's overview row and the run's summary row last. Nothing changes about the price, the input fields or the output columns.

### 1.0.1 — 2026-10-04

- First release. Give one or more domains, or single pages, and get the keywords each one ranks for in Google's top 100, one row per keyword: its organic and absolute position, the page that ranks, monthly search volume, CPC, competition, keyword difficulty (0–100), search intent and estimated monthly traffic — in 94 countries, organic results only.
- Each row says when the source last checked the result and how its position moved since the check before (`serpTrend`).
- Each domain also gets one uncharged overview row: how many keywords it ranks for in total, how they spread over positions, and their estimated traffic. The run's uncharged summary row comes last.
- Each delivered keyword is charged once ($0.003 on the Apify free plan, from $0.0015 on paid plans), plus one $0.02 domain lookup per block of up to 1,000 keywords from one domain. A domain with no ranked keywords, and a request the source refuses or cannot answer, is never charged.
- Filters for the worst position to keep and the minimum search volume run at the source, so a keyword outside them is never delivered or charged. Sort by estimated traffic (the default), search volume or position.
- Your account remembers each domain's positions per country and language, so the next run of the same domain fills `previousPosition`, `positionChange` and `isNew` on every row.
- `maxResultsPerDomain` (100 by default, up to 5,000) and your maximum total charge are hard limits: the run finishes successfully and its last row says what was delivered and what stopped it.