Zillow Scrape: Address/URL/ZPID

Overview

Extract public Zillow listing pages. This is a standalone Apify Actor for Zillow with its own input schema, source adapter, dataset, run summary, diagnostics, and output files.

Features

• Extracts publicly visible listing fields and structured page data.
• Opens detail pages when available to enrich title, price, address, features, media, and facts.
• Deduplicates records by source listing URL or identifier.
• Emits only source-backed live records with dataOrigin: "live-page".
• Omits unknown values instead of inventing them or inserting JSON null values.
• Saves per-run status and access-block diagnostics in storage/key_value_stores/default.

Default source URL

https://www.zillow.com/san-francisco-ca/

Input

Field	Type	Default	Description
startUrls	array	source default	Public search, listing, or detail URLs for this portal.
maxItemsPerActor	integer	10	Maximum detailed records.
maxPagesPerActor	integer	2	Maximum list/search pages.
includeDetails	boolean	true	Enrich records from detail pages.
includeRawData	boolean	true	Keep selected structured source data.
proxyEnabled	boolean	false	Use an authorized Apify or user-supplied proxy.
maxRequestRetries	integer	3	Bounded retry/backoff for transient failures.

Sample live output

{
    "actorName": "zillow-scrape-address-url-zpid",
    "sourcePortal": "Zillow",
    "recordType": "property",
    "listingId": "440731281",
    "listingUrl": "https://www.zillow.com/homedetails/22-Appleton-Ave-San-Francisco-CA-94110/440731281_zpid/",
    "title": "22 Appleton Ave, San Francisco, CA, 94110",
    "description": "Edwardian Elegance Meets Modern Bernal Heights Living. Ideally situated on a peaceful street, this beautifully updated 3-bedroom, 2-bath condominium blends timeless architectural character with thoughtful contemporary improvements. Original details including high ceilings and restored hardwood floors showcase the home's classic Edwardian appeal, while owned solar panels help offset PG&E costs. The flexible layout offers plenty of possibilities, including a spacious en-suite bedroom and additional rooms that can easily adapt as bedrooms, a home office, dining room, or comfortable living spaces. The remodeled kitchen is designed for both everyday living and entertaining, featuring sleek countertops, a generous island, and stainless steel appliances. Enjoy shared outdoor space with a mature lemon tree, plus a custom patio with fire pitan inviting setting for relaxing or gathering with friends. From here, Cortland Avenue's vibrant shops, cafes, and restaurants are approximately a 10-minute walk away, while Holly Park is just two minutes from home. Convenient access to Muni, Silicon Valley shuttles, and downtown San Francisco adds to the appeal. A rare opportunity to enjoy character, flexibility, and modern comfort in one of the city's most beloved neighborhoods.",
    "listingType": "sale",
    "propertyType": "apartment",
    "price": {
        "display": "899000",
        "value": 899000,
        "currency": "USD"
    },
    "address": {
        "full": "22 Appleton Ave",
        "street": "22 Appleton Ave",
        "locality": "San Francisco",
        "region": "CA",
        "postalCode": "94110",
        "country": "USA",
        "latitude": 37.73845,
        "longitude": -122.42324
    },
    "features": {
        "bedrooms": 3,
        "bathrooms": 2,
        "area": {
            "display": "1526 sqft",
            "value": 1526,
            "unit": "sqft"
        },
        "yearBuilt": 1909
    },
    "agent": {
        "name": "Christopher Lee",
        "company": "NEXTGEN Properties",
        "phone": "650-489-6036",
        "phones": [
            "650-489-6036"
        ]
    },
    "photos": [
        "https://photos.zillowstatic.com/fp/70d5a6051040c52e2a601a2a6a218ec2-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/0b9f4ddf3b09bd4b2a2a81b65eab7ec0-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/4a4ac717110bdf00a193c81bbebb9ae9-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/8be4542d5a8b874bcc14314b280f7571-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/faa44f69a981fcfd2b5c95e32052dc3a-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/5a9ec7ea4b937d704267767db318b21f-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/92484a720f844cd298bb616f20666973-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/91c34dae1f0f899efe6c0f34af871f3f-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/8fcac38b707720d5346407e215b03868-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/ed890876c3f9d85cb9dc6ae85fdef40b-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/41048d793fba9e18988c1aeea4453a50-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/12e451301b0f665498887f12a9b5686f-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/863b9e25fa92cd0f5ecefebf92353f97-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/bf4e04313b875cfbd90879560aad0d9d-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/158874911e2d51c8849b74c1e7f10aee-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/590b654d608b997eb97b6c561658a63d-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/542620865cdc829ffe961093fdd72bbd-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/b87e22c1592dae0484d138057b615b6b-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/72d8269a1d5f5cc7d59492844196ad40-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/06c5954658c7aa4b3d6200c64898e164-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/954d85207af8c4a5e204ff3eae4531ed-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/929789af6899c48cbf192e762faea1b1-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/8eb8c9ab99a5b07440fbacb7a1e33d9f-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/552f13d6e2863977a3d26264d5d89f67-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/b4280d8b7f703f75a5bfeece0197a44e-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/c76b7ec22dea2280719cf773b3ede788-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/d6dd28a8d6dc6e8f72fc9deeb571bb95-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/9d69220fd7a570bda1543736b5ccd711-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/e707329b34ff06abccff62f6b73f32e0-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/3d8acf3d39b30ec20afd6935e64d1319-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/027c31355f1cb74b5697d65d86a4e28a-cc_ft_1536.jpg",
        "https://photos.zillowstatic.com/fp/da447f7070dcbd850a3288fa5ed1ffb4-cc_ft_1536.jpg"
    ],
    "facts": {
        "mlsId": "426155888",
        "mlsName": "SFAR",
        "daysOnZillow": 1,
        "lotAreaValue": 2809.62,
        "lotAreaUnits": "Square Feet",
        "bathrooms": 2,
        "bathroomsFull": 2,
        "bathroomsThreeQuarter": 0,
        "bathroomsHalf": 0,
        "bathroomsOneQuarter": 0,
        "bedrooms": 3,
        "homeType": "Condo",
        "lotSize": "2,809 sqft",
        "pricePerSquareFoot": 589,
        "yearBuilt": 1909,
        "propertySubType": [
            "Condominium"
        ],
        "carportParkingCapacity": 0,
        "coveredParkingCapacity": 0,
        "garageParkingCapacity": 0,
        "hasAttachedGarage": true,
        "hasCarport": false,
        "hasGarage": true,
        "hasOpenParking": true,
        "openParkingCapacity": 0,
        "parkingCapacity": 1,
        "parkingFeatures": [
            "Driveway",
            "Attached",
            "Garage Faces Front",
            "Tandem",
            "On Site (Single Family Only)"
        ]
    },
    "missingFields": [
        "amenities"
    ],
    "scrapedAt": "2026-09-10T13:10:20.915Z",
    "dataOrigin": "live-page"
}

Local development

Run this folder as its own Actor:

$apify run --input-file storage/key_value_stores/default/INPUT.json

Validate the Actor contract and stored live records:

apify validate-schema
node dataset-validator.js

Access and compliance

If the source portal returns a challenge or access denial, the Actor records diagnostics and omits that page rather than fabricating output. Use only public pages and an authorized purpose. Proxy access can incur account costs and does not authorize bypassing CAPTCHA, authentication, robots directives, or other access controls.

Output files

• .actor: Actor metadata and schemas.
• src: This portal's standalone adapter and shared extraction runtime.
• storage/datasets/default: Apify-style local result records.
• storage/key_value_stores/default/RUN_SUMMARY.json: run result and diagnostics summary.
• output/dataset.json and output/dataset.jsonl: exported live-only result files.