# Changelog of Blue Book Contractor Scraper: US Leads by State, Trade and City (`getascraper/thebluebook-contractor-directory`) Actor

- **URL**: https://apify.com/getascraper/thebluebook-contractor-directory/changelog.md
- **Full Actor documentation**: https://apify.com/getascraper/thebluebook-contractor-directory.md

## 📋 Changelog

All notable changes to this Actor are documented here.

### \[0.3.0] - 2026-09-27

#### 💰 Changed

- 🧾 Pricing now has two parts: a fee per company found, and a smaller fee per profile opened while searching. A broad search stays inexpensive; a narrow city or trade search costs a little more per company because more profiles have to be checked to find one, but it never costs more than what it actually finds.
- 📖 Rewrote the Store listing and this README to describe what the Actor does today.

### \[0.2.1] - 2026-09-27

#### ✨ Added

- 🏙️ Filter by city.
- 🌐 Optionally keep only companies that have published a website.

#### 🧹 Changed

- 📁 Reorganized the input form into Sources, filters, connection, and output and limits, so related fields sit together.

### \[0.2.0] - 2026-09-27

#### 🛠️ Fixed

- ✅ The Actor now returns real companies. Earlier versions returned nothing because every search page was refused.

#### ✨ Changed

- 🗺️ Choose one or more states, then narrow by company type: general contractors, subcontractors, material suppliers, manufacturers, vendor services, engineers or architects.
- 🧰 Filter by trade keyword, matched against each company's trades, services and CSI codes.
- 🔗 Collect specific companies by pasting their profile links.
- 📇 Each company comes with its city, ZIP, phone, website, annual volume and DUNS number when published, description, trades, services, CSI codes, and the states and counties it serves.
- 🧹 Removed contact, certification and project-history fields, which the site does not publish on public profiles.

### \[0.1.0] - 2026-08-23

#### ✨ Added

- 🔍 Structured filters for state, city, trade category, and company name (no more hand-built search URLs).
- 🏢 Company profile extraction: address, phone, website, and trade categories.
- 👤 Contact directory fields where thebluebook.com exposes named contacts and direct phone numbers.
- 🎖️ Diversity certification (MBE/WBE/DBE), establishment year, company size, and annual volume fields when present.
- 📁 Project history fields (completion dates, general contractor) when present on the profile.
- 🛡️ Default `maxItems` safeguard against unfiltered runs against thebluebook.com's 800K+ listing catalog.

#### 🛡️ Security

- 🔒 No emails are extracted or fabricated. thebluebook.com gates all contact emails behind its own on-site contact form sitewide; this is a source-site limitation, not something this Actor can bypass.