{ "openapi": "3.0.1", "info": { "title": "Trulia Scraper - US Real Estate ($2/1000)", "description": "Scrape Trulia real estate listings in the United States for sale, rent, and sold data with advanced filters (price, beds, baths, property type, amenities, foreclosure). Ideal for housing market research, real estate analytics, lead generation, price tracking, and investment insights.", "version": "0.0", "x-build-id": "3q8kZ83g1DMQ7jTkA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igolaizola~trulia-scraper-ppe/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igolaizola-trulia-scraper-ppe", "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/igolaizola~trulia-scraper-ppe/runs": { "post": { "operationId": "runs-sync-igolaizola-trulia-scraper-ppe", "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/igolaizola~trulia-scraper-ppe/run-sync": { "post": { "operationId": "run-sync-igolaizola-trulia-scraper-ppe", "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", "required": [ "maxItems", "location" ], "properties": { "maxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum number of listings to scrape.", "default": 100 }, "location": { "title": "Location", "type": "string", "description": "Location to search (city, state, ZIP, or neighborhood)." }, "operation": { "title": "Operation", "enum": [ "buy", "rent", "sold" ], "type": "string", "description": "Type of listings to search.", "default": "buy" }, "sortBy": { "title": "Sort By", "enum": [ "best", "newest", "oldest", "price_low", "price_high", "beds", "baths", "sqft", "last_sale" ], "type": "string", "description": "Sort order for results.", "default": "best" }, "propertyTypes": { "title": "Property Types", "type": "array", "description": "Filter by property types (leave empty for defaults).", "items": { "type": "string", "enum": [ "house", "condo", "townhouse", "coops", "apartment", "loft", "tic", "apartment_condo_townhouse", "mobile_manufactured", "farm_ranch", "lot_land", "multi_family", "income_investment", "houseboat", "room_for_rent", "apartment_community" ], "enumTitles": [ "House", "Condo", "Townhouse", "Co-op", "Apartment", "Loft", "TIC", "Apt/Condo/Townhouse", "Mobile/Manufactured", "Farm/Ranch", "Lot/Land", "Multi-family", "Income/Investment", "Houseboat", "Room for rent", "Apartment community" ] } }, "listingTypes": { "title": "Listing Types", "type": "array", "description": "Filter by listing types (leave empty for defaults).", "items": { "type": "string", "enum": [ "resale", "new_homes", "fsbo", "foreclosure", "coming_soon", "accepting_offers", "pending" ], "enumTitles": [ "Resale", "New homes", "FSBO", "Foreclosure", "Coming soon", "Accepting offers", "Pending" ] } }, "foreclosureTypes": { "title": "Foreclosure Types", "type": "array", "description": "Filter by foreclosure types.", "items": { "type": "string", "enum": [ "notice_of_default", "auction", "bank_owned", "for_sale" ], "enumTitles": [ "Notice of default", "Auction", "Bank owned", "For sale" ] } }, "street": { "title": "Street", "type": "string", "description": "Street address filter." }, "mlsId": { "title": "MLS ID", "type": "string", "description": "MLS ID filter." }, "minPrice": { "title": "Min Price", "type": "integer", "description": "Minimum price (0 for any).", "default": 0 }, "maxPrice": { "title": "Max Price", "type": "integer", "description": "Maximum price (0 for any).", "default": 0 }, "minBeds": { "title": "Min Beds", "type": "integer", "description": "Minimum bedrooms.", "default": 0 }, "maxBeds": { "title": "Max Beds", "type": "integer", "description": "Maximum bedrooms.", "default": 0 }, "minBaths": { "title": "Min Baths", "type": "integer", "description": "Minimum bathrooms.", "default": 0 }, "maxBaths": { "title": "Max Baths", "type": "integer", "description": "Maximum bathrooms.", "default": 0 }, "minSqft": { "title": "Min Sqft", "type": "integer", "description": "Minimum square feet.", "default": 0 }, "maxSqft": { "title": "Max Sqft", "type": "integer", "description": "Maximum square feet.", "default": 0 }, "minLotSize": { "title": "Min Lot Size", "type": "integer", "description": "Minimum lot size.", "default": 0 }, "maxLotSize": { "title": "Max Lot Size", "type": "integer", "description": "Maximum lot size.", "default": 0 }, "minHoaFee": { "title": "Min HOA Fee", "type": "integer", "description": "Minimum HOA fee.", "default": 0 }, "maxHoaFee": { "title": "Max HOA Fee", "type": "integer", "description": "Maximum HOA fee.", "default": 0 }, "minPricePerSqft": { "title": "Min Price Per Sqft", "type": "integer", "description": "Minimum price per square foot.", "default": 0 }, "maxPricePerSqft": { "title": "Max Price Per Sqft", "type": "integer", "description": "Maximum price per square foot.", "default": 0 }, "minYearBuilt": { "title": "Min Year Built", "type": "integer", "description": "Minimum year built.", "default": 0 }, "maxYearBuilt": { "title": "Max Year Built", "type": "integer", "description": "Maximum year built.", "default": 0 }, "keywords": { "title": "Keywords", "type": "array", "description": "Keywords to match.", "items": { "type": "string" } }, "soldWithin": { "title": "Sold Within (months)", "type": "integer", "description": "Sold within (months).", "default": 0 }, "pets": { "title": "Pets", "type": "array", "description": "Pet filters.", "items": { "type": "string", "enum": [ "cats", "small_dogs", "large_dogs", "other" ], "enumTitles": [ "Cats", "Small dogs", "Large dogs", "Other" ] } }, "space": { "title": "Space", "enum": [ "entire_space", "room_for_rent", "any" ], "type": "string", "description": "Space filter." }, "brokerFee": { "title": "Broker Fee", "enum": [ "fee", "no_fee" ], "type": "string", "description": "Broker fee filter." }, "buildingAmenities": { "title": "Building Amenities", "type": "array", "description": "Building amenity filters.", "items": { "type": "string", "enum": [ "doorman", "waterfront", "fitnesscenter", "barbeque", "pool", "patio", "elevator", "garage", "sportscourt", "concierge", "systemsecurity", "gatedentry", "intercom", "deck", "porch", "lawn", "garden", "hottub", "basement", "attic" ], "enumTitles": [ "Doorman", "Waterfront", "Fitness center", "Barbeque", "Pool", "Patio", "Elevator", "Garage", "Sports court", "Concierge", "Security system", "Gated entry", "Intercom", "Deck", "Porch", "Lawn", "Garden", "Hot tub", "Basement", "Attic" ] } }, "unitAmenities": { "title": "Unit Amenities", "type": "array", "description": "Unit amenity filters.", "items": { "type": "string", "enum": [ "washerdryer", "aircondition", "refrigerator", "dishwasher", "microwave", "disposal", "fireplace", "ceilingfan", "cablesatellite", "balcony", "doublepanewindows" ], "enumTitles": [ "Washer/dryer", "Air conditioning", "Refrigerator", "Dishwasher", "Microwave", "Disposal", "Fireplace", "Ceiling fan", "Cable/satellite", "Balcony", "Double-pane windows" ] } }, "furnished": { "title": "Furnished", "enum": [ "furnished", "not_furnished" ], "type": "string", "description": "Furnished filter." }, "rentalListingTags": { "title": "Rental Listing Tags", "type": "array", "description": "Rental listing tag filters.", "items": { "type": "string", "enum": [ "best_value", "low_income" ], "enumTitles": [ "Best value", "Low income" ] } }, "landlordPays": { "title": "Landlord Pays", "type": "array", "description": "Landlord pays filters.", "items": { "type": "string", "enum": [ "water", "hot_water", "trash", "heat", "gas", "electric", "sewer" ], "enumTitles": [ "Water", "Hot water", "Trash", "Heat", "Gas", "Electric", "Sewer" ] } }, "view": { "title": "View", "enum": [ "list", "map", "photo" ], "type": "string", "description": "View type." }, "plus55Exclude": { "title": "Exclude 55+ Communities", "type": "boolean", "description": "Exclude 55+ communities.", "default": false }, "airConditioning": { "title": "Air Conditioning", "type": "boolean", "description": "Require air conditioning.", "default": false }, "newListingDaysAgo": { "title": "New Listing Days Ago", "type": "integer", "description": "New listing days ago.", "default": 0 }, "newListingMinDate": { "title": "New Listing Min Date", "type": "string", "description": "New listing minimum date (string).", "default": "" }, "newListingMaxDate": { "title": "New Listing Max Date", "type": "string", "description": "New listing maximum date (string).", "default": "" }, "newListingTimestamp": { "title": "New Listing Timestamp", "type": "integer", "description": "New listing timestamp.", "default": 0 }, "openHomesType": { "title": "Open Homes Type", "enum": [ "t", "w", "p" ], "type": "string", "description": "Open homes type (t, w, p)." }, "openHomesMinDate": { "title": "Open Homes Min Date", "type": "string", "description": "Open homes minimum date (string).", "default": "" }, "openHomesMaxDate": { "title": "Open Homes Max Date", "type": "string", "description": "Open homes maximum date (string).", "default": "" }, "openHomesTimestamp": { "title": "Open Homes Timestamp", "type": "integer", "description": "Open homes timestamp.", "default": 0 }, "recentlyReducedDaysAgo": { "title": "Recently Reduced Days Ago", "type": "integer", "description": "Recently reduced days ago.", "default": 0 }, "recentlyReducedMinDate": { "title": "Recently Reduced Min Date", "type": "string", "description": "Recently reduced minimum date (string).", "default": "" }, "recentlyReducedMaxDate": { "title": "Recently Reduced Max Date", "type": "string", "description": "Recently reduced maximum date (string).", "default": "" }, "recentlyReducedTimestamp": { "title": "Recently Reduced Timestamp", "type": "integer", "description": "Recently reduced timestamp.", "default": 0 }, "transitSystem": { "title": "Transit System", "type": "string", "description": "Transit system filter.", "default": "" }, "transitLine": { "title": "Transit Line", "type": "string", "description": "Transit line filter.", "default": "" }, "transitStation": { "title": "Transit Station", "type": "string", "description": "Transit station filter.", "default": "" }, "includeOffMarket": { "title": "Include Off Market", "type": "boolean", "description": "Include off market listings.", "default": true }, "includeBuilderCommunities": { "title": "Include Builder Communities", "type": "boolean", "description": "Include builder communities.", "default": true }, "hasVirtualTour": { "title": "Has Virtual Tour", "type": "boolean", "description": "Only include homes with virtual tours.", "default": false }, "includeNearBy": { "title": "Include Nearby", "type": "boolean", "description": "Include nearby homes on the first page.", "default": true }, "isAlternateListingSource": { "title": "Alternate Listing Source", "type": "boolean", "description": "Enable alternate listing source.", "default": false } } }, "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 } } } } } } } } } }