Zillow Scraper

Description

The Zillow Scraper API allows you to extract real estate information from Zillow.com. This powerful tool enables developers to integrate Zillow property data into their applications, conduct real estate market analysis, or monitor property trends and pricing history.

How to Use

To use the Zillow Scraper API, you'll need to authenticate your requests using your API key. The API provides four endpoints for retrieving real estate information:

Endpoints

• POST https://taskagi.net/api/real-estate/zillow-scraper/price-history - Retrieve price history for a specific property by URL
• POST https://taskagi.net/api/real-estate/zillow-scraper/properties - Retrieve detailed property information by URL
• POST https://taskagi.net/api/real-estate/zillow-scraper/properties-by-filters - Discover properties using input filters
• POST https://taskagi.net/api/real-estate/zillow-scraper/properties-by-url - Discover properties by URL

Authentication

Include your API key in the request headers:

Authorization: Bearer YOUR_API_KEY

Request Body

The request body should be a JSON object with the following structure:

// For price-history and properties endpoints
{
    "url": "https://www.zillow.com/homedetails/property-id_zpid/"
}

// For properties-by-filters endpoint
{
    "filters": {
        "location": "City, State",
        "price_min": 100000,
        "price_max": 500000,
        "beds_min": 2,
        "baths_min": 2
        // Add other filters as needed
    }
}

// For properties-by-url endpoint
{
    "url": "https://www.zillow.com/homes/for_sale/..."
}

Rate Limiting

Please note that usage is subject to rate limiting. Refer to your plan details for specific limits.

Sample Response

Here's an example of the data you can expect to receive for the price history endpoint:

[
    {
        "input": {
            "url": "https://www.zillow.com/homedetails/8305-Blue-Heron-Way-Raleigh-NC-27615/6468808_zpid/"
        },
        "url": "https://www.zillow.com/homedetails/8305-Blue-Heron-Way-Raleigh-NC-27615/6468808_zpid/",
        "zpid": "6468808",
        "date": "2020-11-13T00:00:00.000Z",
        "event": "Sold",
        "posting_is_rental": false,
        "price": 440000,
        "price_change_rate": 0,
        "price_per_squarefoot": 127,
        "source": "Doorify MLS",
        "source_image": "https://photos.zillowstatic.com/fp/8f81af8b8026a5a5b638c44107c86860-zillow_web_logo_inf_11.jpg"
    },
    {
        "input": {
            "url": "https://www.zillow.com/homedetails/8305-Blue-Heron-Way-Raleigh-NC-27615/6468808_zpid/"
        },
        "url": "https://www.zillow.com/homedetails/8305-Blue-Heron-Way-Raleigh-NC-27615/6468808_zpid/",
        "zpid": "6468808",
        "date": "2020-10-09T00:00:00.000Z",
        "event": "Pending sale",
        "posting_is_rental": false,
        "price": 440000,
        "price_change_rate": 0,
        "price_per_squarefoot": 127,
        "source": "Fathom Realty NC, LLC"
    },
    // ... more price history events
]

import requests
import json

# Your API Key
api_key = 'YOUR_API_KEY'

# API Endpoint for price history
url = 'https://taskagi.net/api/real-estate/zillow-scraper/price-history'

# Headers
headers = {
    'Authorization': f'Bearer {api_key}',
    'Content-Type': 'application/json'
}

# Request Body
data = {
    'url': 'https://www.zillow.com/homedetails/8305-Blue-Heron-Way-Raleigh-NC-27615/6468808_zpid/'
}

# Send POST request
response = requests.post(url, headers=headers, json=data)

# Check if the request was successful
if response.status_code == 200:
    # Parse the JSON response
    price_history = response.json()
    
    # Print the price history information
    print(json.dumps(price_history, indent=2))
else:
    print(f"Error: {response.status_code}")
    print(response.text)

# Example for properties by filters
url = 'https://taskagi.net/api/real-estate/zillow-scraper/properties-by-filters'

# Request Body for filters
data = {
    'filters': {
        'location': 'Raleigh, NC',
        'price_min': 300000,
        'price_max': 500000,
        'beds_min': 3,
        'baths_min': 2
    }
}

# Send POST request
response = requests.post(url, headers=headers, json=data)

# Check if the request was successful
if response.status_code == 200:
    # Parse the JSON response
    properties = response.json()
    
    # Print the properties information
    print(json.dumps(properties, indent=2))
else:
    print(f"Error: {response.status_code}")
    print(response.text)