# Alberta Residential Warranty Scraper (`agenscrape/alberta-residential-warranty-scraper`) Actor

Extract comprehensive warranty and property data from Alberta's official residential protection registry. Access detailed information about residential properties, warranty coverage, builders, and legal descriptions across all Alberta municipalities.

- **URL**: https://apify.com/agenscrape/alberta-residential-warranty-scraper.md
- **Developed by:** [Agenscrape](https://apify.com/agenscrape) (community)
- **Categories:** Real estate, Agents, Automation
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🏘️ Alberta Residential Warranty Property Scraper

> Extract comprehensive warranty and property data from Alberta's official residential protection registry. Access detailed information about residential properties, warranty coverage, builders, and legal descriptions across all Alberta municipalities.

### 💡 Why Use This Actor?

Access **complete warranty and builder information** for residential properties in Alberta, Canada. Perfect for real estate professionals, investors, market analysts, and property researchers who need verified warranty data at scale.

**What makes this actor valuable:**

- ✅ Official registry data - verified and up-to-date
- ✅ Complete property and builder details in one place
- ✅ Flexible filtering by property type and municipality
- ✅ Fast and reliable extraction
- ✅ Export-ready structured data

***

### 🚀 Quick Start

#### Basic Configuration

```json
{
  "municipality": "Calgary",
  "singleFamilyHomes": true,
  "multiFamilyHomes": true,
  "rentalProperties": true,
  "maxResults": 100
}
```

#### Run the actor and receive structured data with:

- Complete property warranty information
- Builder contact details and credentials
- Legal descriptions and property identifiers
- Warranty provider information

***

### 📋 Input Parameters

| Parameter | Type | Description | Default | Required |
|-----------|------|-------------|---------|----------|
| **Municipality** | String | Alberta municipality to search (see list below) | - | ✅ Yes |
| **Include Single-Family Homes** | Boolean | Search single-family residential properties | `true` | No |
| **Include Multi-Family Homes** | Boolean | Search multi-family residential properties | `true` | No |
| **Include Rental Properties** | Boolean | Search rental properties | `true` | No |
| **Maximum Results** | Integer | Limit results (0 = unlimited) | `0` | No |

***

### 📊 Output Data Structure

Each extracted property record contains **22 detailed fields** organized into three categories:

#### 🏠 Property Information

- **Warranty Commencement Date** - When warranty coverage began
- **Property Street Address** - Complete street address
- **Municipality** - City/town location
- **Province** - Province (AB)
- **Postal Code** - Property postal code
- **Property Type** - Type of residential property
- **Property Status** - Current warranty status
- **Lot Block Plan** - Legal lot, block, and plan designation
- **Legal Description** - Full legal property description
- **LINC** - Land Identification Number Code

#### 🛡️ Warranty Information

- **Warranty Provider** - Company providing coverage
- **File Number** - Unique file reference number
- **Warranty Phone** - Provider contact number
- **Warranty Website** - Provider website URL

#### 🏗️ Builder Information

- **Legal Name** - Builder's registered legal name
- **Doing Business As (DBA)** - Trade name if different
- **Builder Street Address** - Builder's office address
- **Builder Municipality** - Builder's city/town
- **Builder Province** - Builder's province
- **Builder Postal Code** - Builder's postal code
- **Builder Phone** - Builder contact number
- **Builder Website** - Builder website URL

***

### 💼 Use Cases & Applications

#### Real Estate Professionals

- **Property Due Diligence**: Verify warranty coverage before property transactions
- **Client Services**: Provide comprehensive warranty reports to buyers and sellers
- **Market Research**: Analyze warranty coverage patterns across neighborhoods

#### Property Investors

- **Investment Analysis**: Assess warranty status for investment properties
- **Risk Assessment**: Identify properties with active warranty coverage
- **Portfolio Management**: Track warranty information across multiple properties

#### Market Analysts & Researchers

- **Industry Analysis**: Study residential construction trends in Alberta
- **Builder Research**: Compile comprehensive builder databases
- **Market Reports**: Generate warranty coverage statistics by municipality
- **Competitive Intelligence**: Track builder activity across regions

#### Legal & Insurance Professionals

- **Warranty Verification**: Confirm warranty details for legal proceedings
- **Builder Information**: Access builder contact and registration details
- **Coverage Analysis**: Review warranty provider distribution

#### Data & Lead Generation

- **Builder Contacts**: Generate verified builder contact lists
- **Property Databases**: Build comprehensive property databases
- **Market Segmentation**: Segment properties by type, location, and builder

***

### 🌆 Supported Municipalities

**Major Cities:**
Calgary • Edmonton • Red Deer • Lethbridge • Medicine Hat • Grande Prairie • Airdrie • Fort McMurray

**Additional Municipalities:**
Spruce Grove • Okotoks • Cochrane • Canmore • Chestermere • Beaumont • St. Albert • Leduc • Camrose • Brooks • Sylvan Lake • Lacombe • and many more

*Covers all municipalities in Alberta's residential protection registry*

***

### 📤 Output Formats

Export your data in multiple formats:

- **JSON** - Perfect for APIs and data integration
- **CSV** - Easy import into Excel, Google Sheets
- **Excel (XLSX)** - Ready for analysis and reporting
- **XML** - For enterprise systems integration

All data is clean, structured, and ready to use immediately.

***

### ⚡ Performance & Efficiency

- **Fast Extraction**: Process hundreds of properties in minutes
- **Smart Optimization**: Automatically handles large datasets
- **Reliable**: Built-in retry mechanisms ensure complete data extraction
- **Scalable**: Works efficiently with small or large result sets

**Typical Performance:**

- 100 properties: ~1 minute
- 500 properties: ~3-5 minutes
- 1000+ properties: Scales automatically

***

### 📖 Example Use Case

**Scenario:** Real estate investor analyzing Calgary's residential market

**Input Configuration:**

```json
{
  "municipality": "Calgary",
  "singleFamilyHomes": true,
  "multiFamilyHomes": false,
  "rentalProperties": false,
  "maxResults": 0
}
```

**Output:** Complete database of single-family homes in Calgary with:

- Current warranty status for each property
- Builder contact information for follow-up
- Legal descriptions for due diligence
- Warranty provider contacts for verification

***

### 🎯 Data Quality

All data is extracted from **Alberta's official residential protection registry**, ensuring:

- ✅ **Accuracy** - Official government records
- ✅ **Completeness** - All available fields captured
- ✅ **Reliability** - Direct from authoritative source
- ✅ **Currency** - Access to current registry data

***

### 🔄 Integration Examples

#### Use with Other Tools

**Integrate with CRM systems:**

```javascript
// Example: Push to your CRM
const dataset = await actor.call({
  municipality: "Calgary",
  maxResults: 100
});
// Process and import to your system
```

**Combine with other datasets:**

- Merge with property assessment data
- Cross-reference with MLS listings
- Enhance with demographic information

**Automate workflows:**

- Schedule regular extractions
- Set up alerts for new properties
- Build automated reporting pipelines

***

### ❓ Frequently Asked Questions

**Q: How many properties can I extract?**
A: You can extract as many properties as available in the registry for your selected municipality. Use `maxResults` to limit if needed.

**Q: How current is the data?**
A: Data is extracted directly from Alberta's official registry in real-time.

**Q: Can I search multiple municipalities at once?**
A: Run the actor multiple times with different municipalities, or set up scheduled runs for automation.

**Q: What if a field is empty?**
A: Empty fields indicate the information is not available in the registry for that property.

**Q: Can I get historical data?**
A: The actor extracts current registry data. Historical snapshots require running the actor periodically.

***

### 🎁 What You Get

Every run provides:

- **Structured Dataset** - Clean, organized property records
- **Complete Information** - All 22 data fields per property
- **Export Options** - Multiple format choices
- **Reliable Results** - Consistent, accurate extractions
- **Fast Delivery** - Results in minutes, not hours

***

### 🚦 Getting Started

1. **Configure** your search parameters (municipality, property types, limits)
2. **Run** the actor with one click
3. **Download** your data in your preferred format
4. **Use** the data for your analysis, research, or business needs

**Start extracting Alberta property warranty data today!**

***

### 📈 Perfect For

- 🏢 Real Estate Agencies
- 📊 Market Research Firms
- 💰 Property Investors
- 🏗️ Construction Industry Analysis
- 📋 Legal & Compliance Teams
- 💼 Business Development
- 📱 App Developers
- 🎯 Lead Generation

***

*This actor provides access to publicly available information from Alberta's residential protection registry. Use responsibly and in accordance with applicable terms of service and data usage policies.*

# Actor input Schema

## `municipality` (type: `string`):

Select a municipality in Alberta to search for properties

## `singleFamilyHomes` (type: `boolean`):

Search for single-family homes

## `multiFamilyHomes` (type: `boolean`):

Search for multi-family homes

## `rentalProperties` (type: `boolean`):

Search for rental properties

## `maxResults` (type: `integer`):

Maximum number of properties to scrape (0 = unlimited)

## Actor input object example

```json
{
  "municipality": "Calgary",
  "singleFamilyHomes": true,
  "multiFamilyHomes": true,
  "rentalProperties": true,
  "maxResults": 100
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "municipality": "Calgary",
    "singleFamilyHomes": true,
    "multiFamilyHomes": true,
    "rentalProperties": true,
    "maxResults": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("agenscrape/alberta-residential-warranty-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "municipality": "Calgary",
    "singleFamilyHomes": True,
    "multiFamilyHomes": True,
    "rentalProperties": True,
    "maxResults": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("agenscrape/alberta-residential-warranty-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "municipality": "Calgary",
  "singleFamilyHomes": true,
  "multiFamilyHomes": true,
  "rentalProperties": true,
  "maxResults": 100
}' |
apify call agenscrape/alberta-residential-warranty-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,agenscrape/alberta-residential-warranty-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ZvqKprWR2GDKF1K8U/builds/NKS5k5oMaDVbJKQZq/openapi.json
