Trulia Scraper

Overview

Extract public Trulia listing pages. This is a standalone Apify Actor for Trulia 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.trulia.com/CA/San_Francisco/

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": "trulia-scraper",
    "sourcePortal": "Trulia",
    "recordType": "property",
    "listingId": "2075-sutter-st-233-san-francisco-ca-94115-15076113",
    "listingUrl": "https://www.trulia.com/home/2075-sutter-st-233-san-francisco-ca-94115-15076113",
    "title": "2075 Sutter St #233",
    "description": "Conveniently located close to the shops and restaurants on Fillmore Street, this bright, contemporary, 2 bedroom/2 bath townhouse is a rare find. It is the largest (1,193 sq ft), most private and only freestanding unit in this location. There is no one above, below or on either side. The outlooks from within are of trees on one side and a patio and courtyard with shrubs and potted plants on the other. The quiet and private aspects of this special townhome are a primary and exceptional draw. Upon entering the property, you find a remarkably different space and floor plan configuration from any other residence here. The more open space allows for far greater options with furniture placement, interior design flexibility and simple comfort. This unit includes an upgraded kitchen with newer cabinets, stainless appliances, a Bosch dishwasher and featuring both a convection oven with cooktop as well as a convection microwave, each with air fryer. There are also high-end features such as upgraded baths with bidets, both baseboard and wall panel heaters, hardwood floors, woodburning fireplace, recessed lighting, Samsung washer/dryer and quality components throughout, which show special attention to detail. Additional features include an elevator, storage, bike room and easily accessed, 2 car parking in the garage. This most private and remarkable townhome must be seen to be appreciated fully.",
    "listingType": "https://schema.org/instock",
    "propertyType": "property",
    "price": {
        "display": "1395000",
        "value": 1395000,
        "currency": "USD"
    },
    "address": {
        "full": "2075 Sutter St #233, San Francisco, CA 94115",
        "street": "2075 Sutter St #233, San Francisco, CA 94115",
        "locality": "San Francisco",
        "region": "CA",
        "postalCode": "94115",
        "country": "US",
        "latitude": 37.785709381103516,
        "longitude": -122.43453979492188
    },
    "features": {
        "bedrooms": 2,
        "bathrooms": 2,
        "area": {
            "display": "1,193 SQFT",
            "value": 1193,
            "unit": "SQFT"
        },
        "floor": "1,193 sqft"
    },
    "agent": {
        "name": "Joe DeChellis",
        "phone": "(415) 533-1520",
        "phones": [
            "(415) 533-1520"
        ]
    },
    "photos": [
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/8114ae48199f35bb5f0167055b25ef05-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/3b85e91c31799905e93c9fd362b2fadc-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/209b0e8011bf6dba7e2e0aad72a21400-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/9a09979eb2ba834add30fc041119ccca-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/7bddba45cc1cfc472c7ed8e0a57796c1-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/5f837a6b11a05916825b8db78828ed22-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/0899947e48cde70c2e4aaed583884db2-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/b8e20ac60f88c48f92fe1e8aaab341b4-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/e90ab5dc16a7b2f5ac41a2f914cdc68e-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/a2b9b51c0cdc8caaa274b495b8062887-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/5ab0e0bb2676b0fbb672d2093085b464-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/da0cf1376b536eb1288f3c6310198f2b-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/54a31b724f351c6224cac4f751c6321e-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/dd67b30e5ebefad802431a8e9d7070a0-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/d6b878cbc28928325fdcecb938a1d188-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/8ff5003a6424fe4a2823f2e039ade6db-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/c66ef7276db77cc1eaf1c78e0167f063-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/2b8fd2499a8c48d241caeaffc86847cb-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/2de54e7f562460a6a35bb9e54561f2e1-full.jpg",
        "https://www.trulia.com/pictures/thumbs_5/zillowstatic/fp/749778bf9de252ca1098cff72848249a-full.jpg"
    ],
    "missingFields": [
        "amenities"
    ],
    "scrapedAt": "2026-09-10T13:10:04.261Z",
    "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.