{ "openapi": "3.0.1", "info": { "title": "Trulia Scraper", "description": "Extract rental and for-sale property listings from Trulia. Get prices, addresses, coordinates, bedrooms, bathrooms, square footage, property type, tags, and images. Filter by location, price range, bedrooms, pet policy, parking, and more. Export as JSON, CSV, or Excel.", "version": "1.0", "x-build-id": "7GLR7hiE0t5yHl8ZW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~trulia-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-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/parseforge~trulia-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-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/parseforge~trulia-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-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": { "startUrl": { "title": "Start URL", "type": "string", "description": "Direct Trulia listing or search URL. If provided, location and filters below are ignored." }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 100. Paid users: Optional, max 1,000,000" }, "location": { "title": "Location", "type": "string", "description": "City and state to search (e.g. 'New York, NY', 'Chicago, IL', or a ZIP code)." }, "listingType": { "title": "Listing Type", "enum": [ "FOR_RENT", "FOR_SALE" ], "type": "string", "description": "Type of listings to search for.", "default": "FOR_RENT" }, "priceMin": { "title": "Min Price ($/month)", "minimum": 0, "type": "integer", "description": "Minimum price in USD." }, "priceMax": { "title": "Max Price ($/month)", "minimum": 0, "type": "integer", "description": "Maximum price in USD." }, "bedroomsMin": { "title": "Min Bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Minimum number of bedrooms." }, "bedroomsMax": { "title": "Max Bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum number of bedrooms." }, "bathroomsMin": { "title": "Min Bathrooms", "minimum": 0, "type": "number", "description": "Minimum number of bathrooms." }, "propertyType": { "title": "Property Type", "enum": [ "", "APARTMENT", "HOUSE", "CONDO", "TOWNHOUSE", "MULTI_FAMILY" ], "type": "string", "description": "Filter by property type." }, "squareFeetMin": { "title": "Min Square Feet", "minimum": 0, "type": "integer", "description": "Minimum living area in square feet." }, "squareFeetMax": { "title": "Max Square Feet", "minimum": 0, "type": "integer", "description": "Maximum living area in square feet." }, "petFriendly": { "title": "Pet Friendly", "type": "boolean", "description": "Only show pet-friendly listings.", "default": false }, "parkingAvailable": { "title": "Parking Available", "type": "boolean", "description": "Only show listings with parking.", "default": false }, "laundryInUnit": { "title": "Laundry In Unit", "type": "boolean", "description": "Only show listings with in-unit laundry.", "default": false }, "airConditioning": { "title": "Air Conditioning", "type": "boolean", "description": "Only show listings with air conditioning.", "default": false }, "moveInDate": { "title": "Move-in Date", "type": "string", "description": "Earliest available move-in date (ISO format: YYYY-MM-DD)." }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum number of parallel detail requests.", "default": 3 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Residential proxies required for Trulia (PerimeterX protection)." } } }, "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 } } } } } } } } } }