{ "openapi": "3.0.1", "info": { "title": "Realtor.com Scraper with Agents | Enterprise Grade", "description": "Extract US real estate listings from Realtor.com at scale with rich property detail, agent and office data, deep listing metadata, and market insights. Built for enterprise-grade real estate intelligence, lead enrichment, and automated analytics pipelines.", "version": "0.0", "x-build-id": "O0geIFdxKqXg8wTD7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~realtor-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-realtor-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~realtor-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-realtor-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~realtor-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-realtor-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": { "deal_type": { "title": "Choose Deal Type", "enum": [ "buy", "rent", "sold" ], "type": "string", "description": "Choose whether to collect properties for sale, properties for rent, or sold properties. Keep the default when your workflow is focused on for-sale inventory.", "default": "buy" }, "location": { "title": "Choose a Location (eg. \"San Francisco\", \"10001\", \"New York\")", "minItems": 1, "type": "array", "description": "Enter each location as a separate item, for example \"San Francisco\", \"10001\", \"New York\", or \"Austin\". Broader locations can discover more listings; specific locations keep the dataset more targeted.", "items": { "type": "string" } }, "property_type": { "title": "Filter by Property Type", "uniqueItems": true, "type": "array", "description": "Include only the selected Realtor.com property categories. Leave empty to keep all available property types in scope.", "items": { "type": "string", "enum": [ "apartment", "house", "condo", "townhome", "multi_family", "mobile", "land", "farm" ], "enumTitles": [ "Apartment", "House", "Condo", "Townhome", "Multi-family", "Mobile", "Land", "Farm" ] } }, "listing_status": { "title": "Filter by Listing Status", "enum": [ "active", "pending_contingent" ], "type": "string", "description": "Include only active listings or only pending and contingent listings. Leave empty when listing status should not narrow the dataset." }, "home_tours": { "title": "Filter by Home Tour Options", "uniqueItems": true, "type": "array", "description": "Include only listings that offer selected tour options such as open houses, 3D tours, or virtual tours. Leave empty when tour availability is not required.", "items": { "type": "string", "enum": [ "open_house", "3d_tour", "virtual_tour" ], "enumTitles": [ "Open House", "3D Tour", "Virtual Tour" ] } }, "internal_amenities": { "title": "Filter by Interior Amenities", "uniqueItems": true, "type": "array", "description": "Include only listings with selected interior features. Leave empty when interior amenities should not narrow the dataset.", "items": { "type": "string", "enum": [ "accessibility", "basement", "central_air", "central_heat", "den_office", "dining_room", "elevator", "energy_efficient", "family_room", "fireplace", "forced_air", "game_room", "hardwood_floors", "in_home_laundry" ], "enumTitles": [ "Accessibility", "Basement", "Central air", "Central heat", "Den / office", "Dining room", "Elevator", "Energy efficient", "Family room", "Fireplace", "Forced air", "Game room", "Hardwood floors", "In-home laundry" ] } }, "external_amenties": { "title": "Filter by Outdoor Amenities", "uniqueItems": true, "type": "array", "description": "Include only listings with selected exterior or outdoor features. Leave empty when outdoor amenities should not narrow the dataset.", "items": { "type": "string", "enum": [ "carport", "corner_lot", "cul_de_sac", "golf_course_lot", "horse_facility", "pool", "rv_boat_parking", "spa_hot_tub" ], "enumTitles": [ "Carport", "Corner lot", "Cul-de-sac", "Golf course lot", "Horse facility", "Pool", "RV / boat parking", "Spa / hot tub" ] } }, "views": { "title": "Filter by Views and Waterfront", "uniqueItems": true, "type": "array", "description": "Include only listings with selected view or waterfront features. Leave empty when views should not narrow the dataset.", "items": { "type": "string", "enum": [ "city_view", "golf_view", "hill_view", "lake_view", "ocean_view", "river_view", "water_front" ], "enumTitles": [ "City view", "Golf course view", "Hill / mountain view", "Lake view", "Ocean view", "River view", "Waterfront" ] } }, "community": { "title": "Filter by Community Amenities", "uniqueItems": true, "type": "array", "description": "Include only listings with selected neighborhood or community features. Leave empty when community amenities should not narrow the dataset.", "items": { "type": "string", "enum": [ "community_55_plus", "boat_facility", "clubhouse", "golf_course", "horse_facility", "park", "pool", "recreation_facility", "security_feature", "spa_hot_tub", "tennis_court" ], "enumTitles": [ "55+ community", "Boat facility", "Clubhouse", "Golf course", "Horse facility", "Park", "Pool", "Recreation facility", "Security feature", "Spa / hot tub", "Tennis court" ] } }, "expand_radius": { "title": "Set Search Radius", "enum": [ "1", "2", "5", "10", "25", "50" ], "type": "string", "description": "Expand the search around each selected location by the chosen number of miles. Leave empty to use Realtor.com's standard location boundary." }, "max_hoa_fee": { "title": "Set Maximum Monthly HOA Fee", "enum": [ "no_fee", "50", "100", "200", "300", "400", "500", "750", "1000", "1500", "2000", "2500", "3000" ], "type": "string", "description": "Include only listings with no HOA fee or with a monthly HOA fee at or below the selected amount. Leave empty when HOA fees should not narrow the dataset." }, "building_type": { "title": "Filter by Building Type", "enum": [ "house", "row_townhouse", "apartment", "duplex", "triplex", "fourplex", "garden_home", "mobile_home", "manufactured_home_mobile", "special_purpose", "residential_commercial_mix", "manufactured_home", "commercial_apartment", "two_apartment_house", "park_model_mobile_home", "floathome" ], "type": "string", "description": "Include only a specific building format, such as house, apartment, duplex, or row/townhouse. Leave empty when any building type is acceptable." }, "publication_date": { "title": "Filter by Publication Date", "enum": [ "24_hours", "7_days", "14_days", "21_days", "30_days" ], "type": "string", "description": "Include only listings published within the selected recent time window. Leave empty to include listings regardless of publication date." }, "keyword": { "title": "Filter by Keyword", "type": "string", "description": "Enter a term or phrase to focus results on listings that match your text criteria. Leave empty when no keyword filter is needed." }, "open_house_only": { "title": "Include Open House Listings Only", "type": "boolean", "description": "Collect only listings that show open house availability in the next 7 days. Keep this off when you want a broader result set.", "default": false }, "live_stream_only": { "title": "Include Live Stream Showings Only", "type": "boolean", "description": "Collect only listings that show live stream open house availability in the next 7 days. Keep this off for a broader result set.", "default": false }, "price_reduced": { "title": "Include Price-Reduced Listings Only", "type": "boolean", "description": "Collect only listings marked as price reduced. Keep this off when price reductions should not narrow the dataset.", "default": false }, "builder_promotions": { "title": "Include Builder Promotion Listings Only", "type": "boolean", "description": "Collect only listings with builder promotions. Keep this off when builder promotions should not narrow the dataset.", "default": false }, "min_parking": { "title": "Set Minimum Garage Spaces", "enum": [ "1", "2", "3" ], "type": "string", "description": "Include only listings with at least this many garage spaces. Leave empty when garage parking should not narrow the dataset." }, "storey": { "title": "Choose Storey Layout", "enum": [ "single_story", "two_or_more_stories" ], "type": "string", "description": "Collect only single-storey listings or only listings with two or more storeys. Leave empty when storey layout should not narrow the dataset." }, "min_bedroom": { "title": "Set Minimum Bedrooms", "enum": [ "studio", "1", "2", "3", "4", "5" ], "type": "string", "description": "Include only listings with at least this many bedrooms. Choose studio together with maximum bedrooms set to studio when you only want studio listings." }, "max_bedroom": { "title": "Set Maximum Bedrooms", "enum": [ "studio", "1", "2", "3", "4", "5" ], "type": "string", "description": "Include only listings with at most this many bedrooms. Leave empty when there is no maximum bedroom requirement." }, "min_bathroom": { "title": "Set Minimum Bathrooms", "enum": [ "1", "2", "3", "4", "5" ], "type": "string", "description": "Include only listings with at least this many bathrooms. Leave empty when there is no minimum bathroom requirement." }, "max_bathroom": { "title": "Set Maximum Bathrooms", "enum": [ "1", "2", "3", "4", "5" ], "type": "string", "description": "Include only listings with at most this many bathrooms. Leave empty when there is no maximum bathroom requirement." }, "bedroom_count": { "title": "Choose Exact or Minimum Bedrooms", "enum": [ "1+", "2+", "3+", "4+", "5+", "1", "2", "3", "4", "5" ], "type": "string", "description": "Select either a minimum bedroom count, such as 3+, or an exact bedroom count, such as 3. Leave empty when bedroom count should not narrow the dataset." }, "bathroom_count": { "title": "Choose Exact or Minimum Bathrooms", "enum": [ "1+", "2+", "3+", "4+", "5+", "1", "2", "3", "4", "5" ], "type": "string", "description": "Select either a minimum bathroom count, such as 2+, or an exact bathroom count, such as 2. Leave empty when bathroom count should not narrow the dataset." }, "min_price": { "title": "Set Minimum Price", "minimum": 0, "type": "integer", "description": "Include only listings with an asking price at or above this amount. Leave empty when there is no minimum price." }, "max_price": { "title": "Set Maximum Price", "minimum": 0, "type": "integer", "description": "Include only listings with an asking price at or below this amount. Leave empty when there is no maximum price." }, "min_building_area": { "title": "Set Minimum Building Area", "enum": [ "500", "750", "1000", "1250", "1500", "1750", "2000", "2250", "2500", "2750" ], "type": "string", "description": "Include only listings with a building area at or above this many square feet. Leave empty when there is no minimum building size." }, "max_building_area": { "title": "Set Maximum Building Area", "enum": [ "2250", "2500", "2750", "3000", "3250", "3500", "3750", "5000", "7500", "10000" ], "type": "string", "description": "Include only listings with a building area at or below this many square feet. Leave empty when there is no maximum building size." }, "min_land_area": { "title": "Set Minimum Land Area", "enum": [ "2000", "3000", "4000", "5000", "7500", "10890", "21780", "43560", "87120", "217800", "435600", "653400", "871200", "2178000", "4356000" ], "type": "string", "description": "Include only listings with a lot size at or above this value. Leave empty when there is no minimum land size." }, "max_land_area": { "title": "Set Maximum Land Area", "enum": [ "2000", "3000", "4000", "5000", "7500", "10890", "21780", "43560", "87120", "217800", "435600", "653400", "871200", "2178000", "4356000" ], "type": "string", "description": "Include only listings with a lot size at or below this value. Leave empty when there is no maximum land size." }, "min_building_age": { "title": "Set Minimum Building Age", "enum": [ "1", "3", "5", "10", "15", "20", "25", "30", "50", "75", "100" ], "type": "string", "description": "Include only listings with a building age at or above this many years. Leave empty when there is no minimum building age." }, "max_building_age": { "title": "Set Maximum Building Age", "enum": [ "1", "3", "5", "10", "15", "20", "25", "30", "50", "75", "100" ], "type": "string", "description": "Include only listings with a building age at or below this many years. Leave empty when there is no maximum building age." }, "min_year_built": { "title": "Set Earliest Year Built", "enum": [ "2026", "2025", "2024", "2023", "2022", "2021", "2020", "2019", "2018", "2017", "2016", "2015", "2010", "2005", "2000", "1990", "1980", "1970", "1960", "1950", "1940", "1930", "1920", "1910", "1900" ], "type": "string", "description": "Include only listings built in or after this year. Leave empty when there is no earliest year requirement." }, "max_year_built": { "title": "Set Latest Year Built", "enum": [ "2026", "2025", "2024", "2023", "2022", "2021", "2020", "2019", "2018", "2017", "2016", "2015", "2010", "2005", "2000", "1990", "1980", "1970", "1960", "1950", "1940", "1930", "1920", "1910", "1900" ], "type": "string", "description": "Include only listings built in or before this year. Leave empty when there is no latest year requirement." }, "enrich_data": { "title": "Collect Richer Property Listing Details", "type": "boolean", "description": "Enable this for more complete property listing records. This may make the run slower because the actor may spend more time collecting details for each result. Turn it off for faster runs when the standard result fields are enough.", "default": false }, "limit": { "title": "Set Maximum Results per Location", "minimum": 1, "type": "integer", "description": "Enter the maximum number of listings to save for each location. Leave empty to collect as many matching listings as the run can retrieve." } } }, "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 } } } } } } } } } }