{ "openapi": "3.0.1", "info": { "title": "Homes.com Scraper with Contacts & History", "description": "Extract Homes.com listings at scale with rich property detail, agent and agency contacts, pricing, media, sale and rental history, MLS data, and flexible market filters. Built for enterprise-grade real estate intelligence, lead enrichment, inventory monitoring, and automated analytics pipelines.", "version": "0.0", "x-build-id": "sF34VWXe3vUOPG4bB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~homes-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-homes-com-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~homes-com-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-homes-com-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~homes-com-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-homes-com-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", "required": [ "location" ], "properties": { "location": { "title": "Enter Search Location", "type": "string", "description": "Provide a city, state, ZIP code, neighborhood, or market name. Use a specific area for targeted runs or a broader market for wider discovery." }, "deal_type": { "title": "Choose Listing Type", "enum": [ "buy", "rent", "sold", "not_for_sale", "all" ], "type": "string", "description": "Choose whether to collect for-sale listings, rental listings, sold properties, not-for-sale properties, or all available inventory for the selected location.", "default": "buy" }, "min_price": { "title": "Set Minimum Price", "minimum": 0, "type": "integer", "description": "Only include listings priced at or above this amount. Leave empty when no lower price boundary is needed." }, "max_price": { "title": "Set Maximum Price", "minimum": 0, "type": "integer", "description": "Only include listings priced at or below this amount. Leave empty when no upper price boundary is needed." }, "property_type": { "title": "Choose Property Types", "uniqueItems": true, "type": "array", "description": "Select one or more property types to include. Sale, sold, not-for-sale, and all-inventory searches support residential ownership categories; rental searches support rental-focused categories such as apartments.", "items": { "type": "string", "enum": [ "house", "townhouse", "condo", "co_op", "lot_land", "mobile_homes", "multifamily", "other", "apartment" ], "enumTitles": [ "House", "Townhouse", "Condo", "Co-op", "Lot / land", "Mobile home", "Multifamily", "Other", "Apartment" ] } }, "min_bedroom": { "title": "Set Minimum Bedrooms", "enum": [ "studio", "1", "2", "3", "4", "5+" ], "type": "string", "description": "Only include listings with at least this many bedrooms. Leave empty when no minimum bedroom count is required." }, "max_bedroom": { "title": "Set Maximum Bedrooms", "enum": [ "studio", "1", "2", "3", "4", "5+" ], "type": "string", "description": "Only include listings with no more than this many bedrooms. Leave empty when no maximum bedroom count is required." }, "min_bathroom": { "title": "Set Minimum Bathrooms", "enum": [ "1", "2", "3", "4", "5+" ], "type": "string", "description": "Only include listings with at least this many bathrooms. Leave empty when no minimum bathroom count is required." }, "max_bathroom": { "title": "Set Maximum Bathrooms", "enum": [ "1", "2", "3", "4", "5+" ], "type": "string", "description": "Only include listings with no more than this many bathrooms. Leave empty when no maximum bathroom count is required." }, "min_building_area": { "title": "Set Minimum Building Size", "enum": [ "500", "750", "1000", "1250", "1500", "1750", "2000", "2250", "2500", "2750", "3000", "3500", "4000", "4500", "5000", "6000", "7000", "8000", "9000", "10000" ], "type": "string", "description": "Only include listings with at least this many square feet of building area. Leave empty when no minimum size is required." }, "max_building_area": { "title": "Set Maximum Building Size", "enum": [ "500", "750", "1000", "1250", "1500", "1750", "2000", "2250", "2500", "2750", "3000", "3500", "4000", "4500", "5000", "6000", "7000", "8000", "9000", "10000" ], "type": "string", "description": "Only include listings with no more than this many square feet of building area. Leave empty when no maximum size is required." }, "min_land_area": { "title": "Set Minimum Lot Size", "enum": [ "3000_sqft", "5000_sqft", "7000_sqft", "0.25_acre", "0.5_acre", "0.75_acre", "1_acre", "1.5_acres", "2_acres", "2.5_acres", "3_acres", "4_acres", "5_acres", "10_acres", "15_acres", "20_acres", "50_acres", "100_acres", "500_acres", "1000_acres" ], "type": "string", "description": "Only include listings with at least this lot size. Leave empty when no minimum land area is required." }, "max_land_area": { "title": "Set Maximum Lot Size", "enum": [ "3000_sqft", "5000_sqft", "7000_sqft", "0.25_acre", "0.5_acre", "0.75_acre", "1_acre", "1.5_acres", "2_acres", "2.5_acres", "3_acres", "4_acres", "5_acres", "10_acres", "15_acres", "20_acres", "50_acres", "100_acres", "500_acres", "1000_acres" ], "type": "string", "description": "Only include listings with no more than this lot size. Leave empty when no maximum land area is required." }, "min_psf": { "title": "Set Minimum Price Per Square Foot", "minimum": 0, "type": "integer", "description": "Only include listings with price per square foot at or above this amount. Leave empty when no lower value-density boundary is needed." }, "max_psf": { "title": "Set Maximum Price Per Square Foot", "minimum": 0, "type": "integer", "description": "Only include listings with price per square foot at or below this amount. Leave empty when no upper value-density boundary is needed." }, "keyword": { "title": "Add a Keyword Filter", "type": "string", "description": "Enter a keyword or phrase to narrow matching listings. Leave empty when you want the location and other filters to define the search." }, "mls_number": { "title": "Enter MLS Number", "type": "string", "description": "Enter a specific MLS number to narrow the run to matching listing records. Leave empty for normal market searches." }, "sale_listing_status": { "title": "Choose Sale Statuses", "uniqueItems": true, "type": "array", "description": "Select the sale listing statuses to include. This setting only applies when the listing type is set to properties for sale.", "items": { "type": "string", "enum": [ "coming_soon", "active", "under_contract", "pending" ], "enumTitles": [ "Coming soon", "Active", "Under contract", "Pending" ] }, "default": [ "coming_soon", "active" ] }, "sale_listing_type": { "title": "Choose Sale Types", "uniqueItems": true, "type": "array", "description": "Select the sale listing types to include. This setting only applies when the listing type is set to properties for sale.", "items": { "type": "string", "enum": [ "resale", "new_construction", "pre_foreclosure", "foreclosure", "short_sale", "auction" ], "enumTitles": [ "Resale", "New construction", "Pre-foreclosure", "Foreclosure", "Short sale", "Auction" ] } }, "publication_date": { "title": "Choose Listing Age", "enum": [ "last_24_hours", "less_than_3_days", "less_than_7_days", "less_than_1_month", "more_than_7_days", "more_than_14_days", "more_than_1_month", "more_than_3_months", "more_than_6_months", "more_than_1_year" ], "type": "string", "description": "Only include listings within the selected publication-date window. This applies to properties for sale and properties for rent." }, "price_reduction_period": { "title": "Choose Price Reduction Window", "enum": [ "last_3_days", "last_7_days", "last_14_days", "last_30_days", "over_1_month", "over_2_months", "over_3_months" ], "type": "string", "description": "Only include listings with price reductions in the selected period. This applies only when the listing type is set to properties for sale." }, "min_parking": { "title": "Set Minimum Parking", "enum": [ "1+", "2+", "3+", "4+" ], "type": "string", "description": "Only include listings with at least this many parking spaces. Leave empty when parking should not narrow the search." }, "garage_parking": { "title": "Require Garage Parking", "type": "boolean", "description": "Only include listings with garage parking. This setting only matters when minimum parking is set.", "default": false }, "open_house_and_tours": { "title": "Choose Tour Availability", "enum": [ "open_house", "3d_tours", "matterport_3d_tour", "video" ], "type": "string", "description": "Only include listings with the selected open house, 3D tour, Matterport tour, or video option." }, "min_greatschools_rating": { "title": "Set Minimum GreatSchools Rating", "enum": [ "5+", "6+", "7+", "8+", "9+", "10" ], "type": "string", "description": "Only include listings with GreatSchools ratings at or above the selected value. Leave empty when this rating should not narrow the search." }, "min_niche_grade_rating": { "title": "Set Minimum Niche Grade", "enum": [ "C", "B", "B+", "A-", "A", "A+" ], "type": "string", "description": "Only include listings with Niche grade ratings at or above the selected grade. Leave empty when this rating should not narrow the search." }, "views": { "title": "Choose View Types", "uniqueItems": true, "type": "array", "description": "Only include for-sale or rental listings with the selected view types. Leave empty to keep view type unrestricted.", "items": { "type": "string", "enum": [ "mountain_hills", "water", "city", "woods", "other" ], "enumTitles": [ "Mountain / hills", "Water", "City", "Woods", "Other" ] } }, "min_building_year": { "title": "Set Earliest Year Built", "enum": [ "1900", "1925", "1950", "1960", "1970", "1980", "1990", "2000", "2005", "2010", "2015", "2018", "2019", "2020", "2021", "2022", "2023", "2024", "2025", "2026" ], "type": "string", "description": "Only include listings built in or after this year. Leave empty when no earliest construction year is required." }, "max_building_year": { "title": "Set Latest Year Built", "enum": [ "1900", "1925", "1950", "1960", "1970", "1980", "1990", "2000", "2005", "2010", "2015", "2018", "2019", "2020", "2021", "2022", "2023", "2024", "2025", "2026" ], "type": "string", "description": "Only include listings built in or before this year. Leave empty when no latest construction year is required." }, "min_stories": { "title": "Set Minimum Stories", "enum": [ "1", "2", "3" ], "type": "string", "description": "Only include listings with at least this many stories. Leave empty when no minimum story count is required." }, "max_stories": { "title": "Set Maximum Stories", "enum": [ "1", "2", "3" ], "type": "string", "description": "Only include listings with no more than this many stories. Leave empty when no maximum story count is required." }, "sort_by": { "title": "Set Result Order", "enum": [ "recommended", "newest", "price_low_to_high", "price_high_to_low", "rental_rate_low_to_high", "rental_rate_high_to_low", "year_built" ], "type": "string", "description": "Select the order used for matching listings. Some price-based options are intended for sale prices, while rental-rate options are intended for rental searches.", "default": "recommended" }, "maximize_coverage": { "title": "Maximize Broad-Market Coverage", "type": "boolean", "description": "Enable this for large markets when you want the actor to make a stronger effort to collect more available results. It can increase run time, so leave it off for quick validation runs or tightly filtered searches.", "default": false }, "limit": { "title": "Set Maximum Results", "minimum": 1, "type": "integer", "description": "Set the maximum number of records to save. Leave empty to collect as many matching results as the configured search can return." } } }, "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 } } } } } } } } } }