# Changelog of Yandex AI Overview Scraper (`searchapi/yandex-ai-overview-scraper`) Actor

- **URL**: https://apify.com/searchapi/yandex-ai-overview-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/searchapi/yandex-ai-overview-scraper.md

## Changelog

All notable changes to the Yandex AI Overview Scraper are documented here.

### \[3.0.0] - 2026-08-29

#### Changed

- Replaced generic Yandex wizard matching with explicit, web-grounded Search with Alice extraction.
- Added authorized Alice web-session and official Yandex Search API modes with single and fair batch inputs.
- Added structured API-response extraction with a DOM fallback, stable IDs, public source/citation normalization, recursive empty omission, and run-level dataset audits.
- Login walls, CAPTCHA pages, ungrounded answers, malformed payloads, and empty results now fail without storing placeholder rows.

#### Security

- Yandex cookies and Search API credentials are accepted only through secret inputs or environment variables and are never logged or stored in output.
- Removed ten-retry CAPTCHA behavior, fabricated model/schema fields, generic generated modules, and vulnerable legacy dependencies.

### \[2.0.1] - 2026-06-13

#### Verified

- End-to-end run completed: 1 record pushed with correct schema (query, aiOverview, sources, hasAiOverview, aiBlockType, searchUrl, language, scrapedAt).
- Yandex.com (en) does not render the AI Overview block; `hasAiOverview=false` is correctly set.
- Yandex.ru (ru) is CAPTCHA-blocked from many server locations; AI overview only renders for Russian-language queries on yandex.ru/search.

### \[2.0.0] - 2026-06-12

#### Added

- **Schema expanded** from 8 to **27 fields**.
- **New fields**: `type`, `resultType`, `position`, `page`, `aiBlockType`, `aiOverviewHtml`, `aiOverviewPlain`, `aiShortSummary`, `sourceCount`, `citations`, `references`, `followUpQuestions`, `modelName`, `modelVersion`, `language`, `region`, `searchUrl`, `searchMetadata`.
- **New view**: `fullDetails` — all 27 fields.
- **INPUT.json** added at project root for local validation.

### \[1.0.0] - 2025-05-20

#### Added

- Initial production release of the Yandex AI Overview Scraper.
- `PlaywrightCrawler`-based architecture using Chrome.
- Modular project structure.
- `validate-datasets.js` for local dataset output validation.
- `Dockerfile` using `apify/actor-node-playwright-chrome` image.
- `README.md` with full Apify usage guide.