{ "openapi": "3.0.1", "info": { "title": "Trulia Scraper", "description": "Scrape Trulia listings, full property details, similar homes, local amenities, and location autocomplete. Search by location, ZIP, coordinates, or Trulia URL with price, beds, baths, sqft and property-type filters. One flat row per result plus full raw JSON.", "version": "1.0", "x-build-id": "PJikimHT4Cikvp9Ok" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/one-api~trulia-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-one-api-trulia-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/one-api~trulia-scraper/runs": { "post": { "operationId": "runs-sync-one-api-trulia-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/one-api~trulia-scraper/run-sync": { "post": { "operationId": "run-sync-one-api-trulia-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": { "property_inputs": { "title": "Trulia property URL, full address, or listing ID (one per line)", "type": "array", "description": "Full enriched details for a specific home (price, beds/baths, description, home facts, price history, taxes, HOA, schools, amenities, demographics, neighborhood). Auto-detects each row:\n• `https://www.trulia.com/home/...` or `/home/...` → details by URL (fastest)\n• `10455 SW 42nd Ter, Miami, FL 33165` → details by address\n• `44202084` → details by listing ID (slow / best-effort — URL or address is strongly preferred)", "items": { "type": "string" } }, "search_inputs": { "title": "Location, ZIP, lat,lng,radius, or Trulia search URL (one per line)", "type": "array", "description": "Paginated listing search. Auto-detects each entry. Examples:\n• `Miami, FL` (city/state, neighborhood, or free text)\n• `33101` (ZIP code)\n• `25.7617,-80.1918,5` (lat,lng,radius_miles)\n• `https://www.trulia.com/for_sale/Miami,FL/` (Trulia search URL)\n\nThe filters below apply to every search row. Each LISTING is pushed as one dataset item.", "items": { "type": "string" } }, "searchType": { "title": "Search Type", "enum": [ "FOR_SALE", "FOR_RENT", "SOLD" ], "type": "string", "description": "For Sale (default), For Rent, or Recently Sold. Applies to Search Listings and Autocomplete.", "default": "FOR_SALE" }, "propertyType": { "title": "Property Types", "type": "string", "description": "Comma-separated. Leave empty for all. Allowed: House, Condo, Townhouse, Apartment, Multi_Family, Land, Mobile.", "default": "" }, "priceRange": { "title": "Price Range", "type": "string", "description": "`min:300000`, `max:900000`, or `min:300000,max:900000`.", "default": "" }, "bedsRange": { "title": "Beds Range", "type": "string", "description": "`min:3`, `max:5`, or `min:3,max:5`.", "default": "" }, "bathsRange": { "title": "Baths Range", "type": "string", "description": "Decimals supported: `min:2`, `max:3.5`, or `min:2,max:3.5`.", "default": "" }, "sqftRange": { "title": "Square Feet Range", "type": "string", "description": "`min:1000`, `max:3000`, or `min:1000,max:3000`.", "default": "" }, "yearBuiltRange": { "title": "Year Built Range", "type": "string", "description": "`min:1990`, `max:2020`, or `min:1990,max:2020`.", "default": "" }, "lotSizeRange": { "title": "Lot Size Range (sqft)", "type": "string", "description": "`min:5000`, `max:20000`, or `min:5000,max:20000`.", "default": "" }, "sortOrder": { "title": "Sort Order", "enum": [ "relevance", "newest", "price_low", "price_high", "sqft", "beds", "baths", "photos" ], "type": "string", "description": "How to sort search results. Default: Relevance (Trulia's natural ordering).", "default": "relevance" }, "keywords": { "title": "Keywords", "type": "string", "description": "Free-text keywords (e.g. `pool`, `waterfront`, `renovated`).", "default": "" }, "hasVirtualTour": { "title": "Has Virtual Tour Only", "type": "boolean", "description": "Only keep listings that have a virtual tour.", "default": false }, "soldWithin": { "title": "Sold Within (days)", "minimum": 1, "type": "integer", "description": "For Recently Sold searches: only homes sold within the last N days. Empty = no limit." }, "pages": { "title": "Pages to fetch per search", "minimum": 1, "maximum": 50, "type": "integer", "description": "Each page = up to `Results per page` listings.", "default": 1 }, "resultCount": { "title": "Results per page", "minimum": 1, "maximum": 200, "type": "integer", "description": "Listings per page (1–200). Default 40.", "default": 40 }, "similar_inputs": { "title": "Trulia property URL (one per line)", "type": "array", "description": "Comparable / similar homes for a given Trulia property. One row = a Trulia property URL (e.g. `https://www.trulia.com/home/...`). Each similar home is pushed as one dataset item.", "items": { "type": "string" } }, "amenities_inputs": { "title": "Trulia property URL, or `lat,lng` (one per line)", "type": "array", "description": "Nearby amenities (restaurants, shops, groceries, etc.). Each row is either a Trulia property URL or a `latitude,longitude` pair (e.g. `25.7617,-80.1918`). Each amenity is pushed as one dataset item.", "items": { "type": "string" } }, "amenitiesLimit": { "title": "Max amenities per location", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many amenities to return per Local Amenities row.", "default": 30 }, "autocomplete_inputs": { "title": "Partial location query (one per line)", "type": "array", "description": "Trulia search-box suggestions: cities, neighborhoods, ZIPs, counties, schools. Each suggestion is pushed as one dataset item (Title + Status). Honors the Search Type above.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }