# Changelog of Unsplash Image Scraper (`parsebird/unsplash-image-scraper`) Actor

- **URL**: https://apify.com/parsebird/unsplash-image-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/parsebird/unsplash-image-scraper.md

## Changelog

### v1.5 — 2026-09-27

- Much faster and more reliable: search results are now fetched directly from Unsplash's own search data instead of through a full browser that had to pass Unsplash's bot check (runs used to take minutes and sometimes timed out). Output fields are unchanged.
- A search query that finds no images is no longer charged; it still gets a `NO_RESULTS` row so you can see what happened
- Uses Apify's residential proxy by default (Unsplash rejects most datacenter IPs); choose specific proxy groups in the input to override
- A run that finds no images for any query now fails with a clear message

### v1.4 — 2026-06-01

- Removed sortBy, orientation, and color filter inputs to simplify configuration and reduce 0-result runs
- Scraper now always returns the most relevant images without filter constraints

### v1.3 — 2026-05-28

- Fresh browser context and new proxy IP for each retry attempt to avoid session-level blocks
- Filter fallback: when a filtered URL (e.g. orientation=landscape) fails all retries, automatically retries without filters
- Increased max retries from 3 to 4
- Proxy rotation via ProxyConfiguration object instead of reusing a single URL
- Better challenge detection keywords (anubis, please wait, checking your browser)
- Wait for domcontentloaded after challenge redirect for more reliable data extraction

### v1.2 — 2026-05-28

- Fixed bot challenge handling — 401 responses are now treated as solvable challenges instead of fatal errors
- Increased challenge wait time to 45 seconds for slower proof-of-work resolutions
- Improved challenge detection to watch for page redirects after challenge passes

### v1.1 — 2026-05-23

- Switched default proxy to residential for improved reliability
- Added retry logic with up to 3 attempts per page
- Added bot challenge detection and automatic wait-for-resolution
- Increased page load timeout to 90 seconds
- Improved proxy URL parsing for Apify platform compatibility

### v1.0 — 2026-05-23

- Initial release
- Search Unsplash images by keyword with multiple queries per run
- Filter by orientation (landscape, portrait, squarish), dominant color (12 options), and sort order (relevant, latest)
- Extract image URLs in 5 resolutions (raw, full, regular, small, thumb)
- Collect photographer attribution, tags, dimensions, and engagement metrics
- Per-query and total item limits for cost control
- Pay-per-event pricing at $0.002 per image