{ "openapi": "3.0.1", "info": { "title": "Trulia Property Scraper with Contacts & Features", "description": "Extract Trulia property listings with prices, coordinates, photos, full descriptions, amenities, history, and available agent contacts. Use enrichment and coverage mode for comps, market research, inventory monitoring, CRM, BI, ETL, and AI workflows.", "version": "0.1", "x-build-id": "VTb3OzAZcDg3jIUdK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~trulia-property-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-trulia-property-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/fatihtahta~trulia-property-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-trulia-property-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/fatihtahta~trulia-property-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-trulia-property-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": { "location": { "title": "Set a Location (city, state, ZIP code, neighborhood, or market)", "type": "string", "description": "Enter a Trulia-supported location such as Austin, TX; 75001; Brooklyn, NY; or Los Angeles, CA. Use one focused market per run for cleaner comparisons, recurring monitoring, dashboard refreshes, and downstream deduplication." }, "deal_type": { "title": "Choose the Property Listing Mode", "enum": [ "buy", "rent", "sold" ], "type": "string", "description": "Choose sale listings, rental listings, or recently sold properties. Query-based runs use this mode with the location above. URL-based runs should select the mode that matches the supplied Trulia search page.", "default": "buy" }, "min_price": { "title": "Minimum Price", "minimum": 0, "type": "integer", "description": "Only include listings at or above this price." }, "max_price": { "title": "Maximum Price", "minimum": 0, "type": "integer", "description": "Only include listings at or below this price." }, "min_bedroom": { "title": "Minimum Bedrooms", "enum": [ "1+", "2+", "3+", "4+", "5+" ], "type": "string", "description": "Choose the minimum number of bedrooms." }, "min_bathroom": { "title": "Minimum Bathrooms", "enum": [ "1+", "2+", "3+", "4+", "5+" ], "type": "string", "description": "Choose the minimum number of bathrooms." }, "property_type": { "title": "Property Types", "uniqueItems": true, "type": "array", "description": "Select one or more property categories. Leave empty to include every category.", "items": { "type": "string", "enum": [ "house", "condo", "townhome", "multi_family", "land", "mobile_manufactured", "other" ], "enumTitles": [ "House", "Condo", "Townhome", "Multi-Family", "Land", "Mobile/Manufactured", "Other" ] }, "default": [] }, "seller_type": { "title": "Seller Types", "uniqueItems": true, "type": "array", "description": "Choose agent-listed properties, owner-listed properties, or both.", "items": { "type": "string", "enum": [ "agent_listed", "for_sale_by_owner" ], "enumTitles": [ "Agent listed", "For Sale By Owner" ] }, "default": [] }, "listing_type": { "title": "Listing Types", "uniqueItems": true, "type": "array", "description": "Limit results to selected special listing categories.", "items": { "type": "string", "enum": [ "new_construction", "foreclosures", "coming_soon" ], "enumTitles": [ "New Construction", "Foreclosures", "Coming Soon" ] }, "default": [] }, "listing_status": { "title": "Listing Status Filters", "uniqueItems": true, "type": "array", "description": "Apply recency and contract-status filters to the search.", "items": { "type": "string", "enum": [ "new_listings_past_week", "price_reduced_past_week", "include_accepting_backup_offers", "include_pending_under_contract" ], "enumTitles": [ "New Listings (Past Week)", "Price Reduced (Past Week)", "Include Accepting Backup Offers", "Include Pending & Under Contract" ] }, "default": [] }, "min_building_year": { "title": "Minimum Year Built", "minimum": 0, "type": "integer", "description": "Only include properties built in or after this year." }, "max_building_year": { "title": "Maximum Year Built", "minimum": 0, "type": "integer", "description": "Only include properties built in or before this year." }, "min_floor_area": { "title": "Minimum Floor Area (sq ft)", "minimum": 0, "type": "integer", "description": "Only include properties at or above this interior floor area." }, "max_floor_area": { "title": "Maximum Floor Area (sq ft)", "minimum": 0, "type": "integer", "description": "Only include properties at or below this interior floor area." }, "keyword": { "title": "Keyword", "type": "string", "description": "Match a word or phrase in the listing, such as pool, waterfront, or fixer upper." }, "max_hoa_fee": { "title": "Maximum HOA Fee", "minimum": 0, "type": "integer", "description": "Only include listings with an HOA fee at or below this amount." }, "open_house_only": { "title": "Open House Only", "type": "boolean", "description": "Only include listings with an upcoming open house.", "default": false }, "3d_tour_only": { "title": "3D Tour Only", "type": "boolean", "description": "Only include listings that advertise a virtual or 3D tour.", "default": false }, "exclude_55_plus_communities": { "title": "Exclude 55+ Communities", "type": "boolean", "description": "Exclude listings in age-restricted 55+ communities.", "default": false }, "aircon_only": { "title": "Air Conditioning Only", "type": "boolean", "description": "Only include listings that advertise air conditioning.", "default": false }, "mls_id": { "title": "MLS ID", "type": "string", "description": "Find a listing by its exact MLS identifier." }, "url": { "title": "Add a Trulia City or Market Search URL", "type": "array", "description": "Paste a supported Trulia search URL, such as https://www.trulia.com/CA/Los_Angeles/ or a matching Trulia for-sale, rental, or sold-results URL. Select the corresponding listing mode below so the collected records match the intended sale, rent, or sold market.", "items": { "type": "string" } }, "enrich_data": { "title": "Add Richer Property, Media, History, and Contact Details", "type": "boolean", "description": "Keep this enabled to add fuller descriptions, photo galleries, property features and amenities, available price or tax history, and available agent or agency contact details. Turn it off for faster validation or monitoring runs when lightweight search-result fields are sufficient.", "default": true }, "maximize_coverage": { "title": "Collect More Matching Listings Beyond the Standard Result Window", "type": "boolean", "description": "Enable this for large exports or market-wide analysis where the maximum result count is at least 950, or where no maximum is supplied. Leave it disabled for faster exploratory runs, scheduled samples, and bounded validation work.", "default": true }, "limit": { "title": "Set the Maximum Number of Property Listings to Save", "minimum": 1, "type": "integer", "description": "Choose the maximum number of records to save in this run. Start with a small value such as 5 or 20 to validate the grouped dataset, then increase it for production ingestion. Leave empty to use the actor's standard bounded run behavior; combining an empty limit with maximum coverage can produce a substantially larger run." }, "mcpConnectors": { "title": "MCP Delivery Connectors", "uniqueItems": true, "type": "array", "description": "Choose user-authorized MCP connectors for optional post-run delivery of a compact run summary with dataset, summary, report, and map links when Apify provides them. Leave empty to only save listings to the Apify dataset and key-value store.", "default": [] } } }, "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 } } } } } } } } } }