{ "openapi": "3.0.1", "info": { "title": "Trulia Property Scraper (US)", "description": "Scrapes homes for sale, for rent and recently sold from Trulia — Zillow Group's US portal. Search any US city with price, bedroom and property-type filters; returns price, address, coordinates, beds/baths, photos, full descriptions, features, price history, taxes and Trulia's value estimate.", "version": "0.1", "x-build-id": "Jx0zrEENUVCT93xdF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapyx~trulia-properties-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapyx-trulia-properties-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scrapyx~trulia-properties-scraper/runs": { "post": { "operationId": "runs-sync-scrapyx-trulia-properties-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scrapyx~trulia-properties-scraper/run-sync": { "post": { "operationId": "run-sync-scrapyx-trulia-properties-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchType": { "title": "Market side", "enum": [ "for_sale", "for_rent", "sold" ], "type": "string", "description": "For sale, for rent, or recently sold. Each uses a different Trulia path grammar — the actor builds the right one for you.", "default": "for_sale" }, "locations": { "title": "Locations (city + state)", "type": "array", "description": "One search per entry, each with its own SEARCH_SUMMARY row. Write them as 'San Francisco, CA', 'Austin, TX', 'New York, NY' — the state is REQUIRED because a bare city name is ambiguous across states.\n\nIf Trulia does not recognise a city it does NOT return an error: it silently returns that whole STATE's listings instead (California alone is 126,601 homes). The actor detects this via Trulia's own canonicalUrl echo, refuses to page it, and reports locationApplied: false — so a typo costs you one row, not a dataset full of wrong-city listings.\n\nBecause Trulia caps each query at 1,000 rows, several narrow cities return far more data than one broad one.", "default": [], "items": { "type": "string" } }, "propertyType": { "title": "Property type", "enum": [ "", "SINGLE-FAMILY_HOME", "CONDO", "TOWNHOUSE", "MULTI-FAMILY", "APARTMENT", "LOT%7CLAND", "MOBILE%7CMANUFACTURED", "COOP" ], "type": "string", "description": "Only these values are real Trulia type segments. Anything else is NOT rejected upstream — Trulia answers HTTP 200 with the UNFILTERED baseline, so a typo would look like a successful filtered search. Values outside this list are refused before the run starts.", "default": "" }, "minBeds": { "title": "Minimum bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Leave empty or 0 for any. Trulia is honest at the edges here — an impossible value returns a clean zero-match search rather than widening.", "default": 0 }, "minPrice": { "title": "Minimum price ($)", "minimum": 0, "type": "integer", "description": "Leave empty or 0 for no minimum. For rentals this is monthly rent.", "default": 0 }, "maxPrice": { "title": "Maximum price ($)", "minimum": 0, "type": "integer", "description": "Leave empty or 0 for no maximum. For rentals this is monthly rent.", "default": 0 }, "propertyUrls": { "title": "Property URLs (direct mode)", "type": "array", "description": "Scrape specific listings directly, skipping search. Accepts a full Trulia home URL (https://www.trulia.com/home/123-main-st-austin-tx-78701-12345678). A bare numeric id does NOT work — Trulia's detail URL is an address slug. Can be combined with a location search in the same run.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max properties per location", "minimum": 0, "type": "integer", "description": "Stop paginating a location after this many properties. Set to 0 for unlimited — note Trulia itself stops at 1,000 rows per query (25 pages × 40) however many matches it reports, and past that it silently re-serves page 1. Split into smaller cities to reach the rest.", "default": 100 }, "includePropertyDetails": { "title": "Fetch full property details", "type": "boolean", "description": "Fetch the complete listing (full description, all features, price and tax history, schools, neighbourhood info, every photo, Trulia's own value estimate) via one extra request per property. Turn this off for a fast listing-only crawl — search rows already carry price, address, coordinates, beds, baths, floor space and tags.", "default": true }, "maxConcurrency": { "title": "Max concurrent requests", "minimum": 1, "maximum": 16, "type": "integer", "description": "Upper bound on requests in flight at once, across location pagination and detail fetches.", "default": 4 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Trulia runs PerimeterX and is a US-only portal, so this defaults to Residential pinned to the US. Do not remove the country pin without re-verifying — a geo-mismatched exit IP is exactly the signal a US-only real-estate site scores against.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }