{
  "openapi": "3.0.1",
  "info": {
    "title": "Realtor.com Scraper 💰 $0.90/1K — Sold, Rentals & Risk Data",
    "description": "🏠 Scrape Realtor.com properties for sale, for rent, sold and off market — by search link, location or address. Prices, history, taxes, schools, climate risk, market statistics, AVM estimates, agent and office contacts.",
    "version": "0.0",
    "x-build-id": "DkapWu6wrqSGpGW6P"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/dz_omar~realtor-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-dz_omar-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/dz_omar~realtor-scraper/runs": {
      "post": {
        "operationId": "runs-sync-dz_omar-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/dz_omar~realtor-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-dz_omar-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",
        "properties": {
          "searchBy": {
            "title": "🧭 Search by",
            "enum": [
              "links",
              "locations",
              "properties"
            ],
            "type": "string",
            "description": "Choose ONE way to tell the Actor what to scrape per run. Only the matching section below is used; the others are ignored. If you leave this empty (API calls), the mode is taken from what you filled in: links, then locations, then properties."
          },
          "startUrls": {
            "title": "🔗 Search or listing links",
            "type": "array",
            "description": "Realtor.com search results links (any combination of filters) or property links, copied from the address bar. A property link returns that property; a search link returns up to \"Max results\" properties. The filters below, when set, are applied on top of each search link. Other realtor.com pages (home, sell, mortgage, news, agents) hold no listings and are skipped.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "locations": {
            "title": "📍 Locations",
            "type": "array",
            "description": "Cities, ZIP codes, counties, neighborhoods or whole states: \"Austin, TX\", \"89101\", \"Clark County, NV\", \"Nevada\". A city typed without a state uses the best match and the log says which. One search per location.",
            "items": {
              "type": "string"
            }
          },
          "listingType": {
            "title": "🏷️ Listing type · locations only",
            "enum": [
              "for_sale",
              "for_sale_existing",
              "for_rent",
              "sold",
              "off_market"
            ],
            "type": "string",
            "description": "What to search for. \"For sale\" returns what realtor.com shows for a sale search, including builder \"to be built\" plans; pick \"existing listings only\" to leave the plans out. A pasted link carries its own listing type.",
            "default": "for_sale"
          },
          "properties": {
            "title": "🏠 Addresses, property IDs or listing links",
            "type": "array",
            "description": "One per line: a street address (\"3808 Warm Meadows St, Las Vegas\"), a Realtor.com property ID (\"1634334368\") or a property link. Each returns that property with its full record. Entries that match nothing are skipped and listed in the log.",
            "items": {
              "type": "string"
            }
          },
          "propertyTypes": {
            "title": "🏘️ Property types",
            "type": "array",
            "description": "Only these property types. Leave empty for all.",
            "items": {
              "type": "string",
              "enum": [
                "single_family",
                "condo",
                "townhome",
                "multi_family",
                "mobile",
                "farm",
                "land",
                "apartment",
                "condop",
                "coop"
              ],
              "enumTitles": [
                "Single-family home",
                "Condo",
                "Townhome",
                "Multi-family",
                "Mobile / manufactured",
                "Farm / ranch",
                "Land",
                "Apartment",
                "Condop",
                "Co-op"
              ]
            }
          },
          "minPrice": {
            "title": "💲 Min price",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest price in US dollars (the sold price on a sold search)."
          },
          "maxPrice": {
            "title": "💲 Max price",
            "minimum": 0,
            "type": "integer",
            "description": "Highest price in US dollars (the sold price on a sold search)."
          },
          "minBeds": {
            "title": "🛏️ Min bedrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "At least this many bedrooms (0 = studio)."
          },
          "maxBeds": {
            "title": "🛏️ Max bedrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "At most this many bedrooms."
          },
          "minBaths": {
            "title": "🛁 Min bathrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "At least this many bathrooms."
          },
          "maxBaths": {
            "title": "🛁 Max bathrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "At most this many bathrooms."
          },
          "minSqft": {
            "title": "📐 Min living area",
            "minimum": 0,
            "type": "integer",
            "description": "Interior area in square feet."
          },
          "maxSqft": {
            "title": "📐 Max living area",
            "minimum": 0,
            "type": "integer",
            "description": "Interior area in square feet."
          },
          "minLotSqft": {
            "title": "🌳 Min lot size",
            "minimum": 0,
            "type": "integer",
            "description": "Lot size in square feet (1 acre = 43,560)."
          },
          "maxLotSqft": {
            "title": "🌳 Max lot size",
            "minimum": 0,
            "type": "integer",
            "description": "Lot size in square feet."
          },
          "minYearBuilt": {
            "title": "🏗️ Built after",
            "minimum": 1700,
            "maximum": 2100,
            "type": "integer",
            "description": "Earliest year built."
          },
          "maxYearBuilt": {
            "title": "🏗️ Built before",
            "minimum": 1700,
            "maximum": 2100,
            "type": "integer",
            "description": "Latest year built."
          },
          "maxHoaFee": {
            "title": "🏢 Max HOA fee",
            "minimum": 0,
            "type": "integer",
            "description": "Highest monthly HOA fee in US dollars."
          },
          "noHoaFee": {
            "title": "🏢 No HOA fee only",
            "type": "boolean",
            "description": "Only properties with no HOA fee.",
            "default": false
          },
          "listedWithinDays": {
            "title": "🕒 Listed within (days)",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Only properties listed in the last N days."
          },
          "soldWithinDays": {
            "title": "🕒 Sold within (days) · sold searches only",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Only used with \"Recently sold\": sold in the last N days. Empty = the last 180 days."
          },
          "priceReducedWithinDays": {
            "title": "📉 Price reduced within (days)",
            "minimum": 1,
            "maximum": 3650,
            "type": "integer",
            "description": "Only properties whose price was reduced in the last N days."
          },
          "openHouseWithinDays": {
            "title": "🚪 Open house within (days)",
            "minimum": 1,
            "maximum": 365,
            "type": "integer",
            "description": "Only properties with an open house in the next N days."
          },
          "keywords": {
            "title": "🔑 Keywords",
            "type": "array",
            "description": "Words that must appear in the listing, such as \"pool\" or \"water front\". One per line.",
            "items": {
              "type": "string"
            }
          },
          "features": {
            "title": "✨ Features",
            "type": "array",
            "description": "Only properties with all of these features.",
            "items": {
              "type": "string",
              "enum": [
                "central_air",
                "central_heat",
                "forced_air",
                "washer_dryer",
                "community_gym",
                "laundry_room",
                "garage_1_or_more",
                "garage_2_or_more",
                "garage_3_or_more",
                "swimming_pool",
                "waterfront",
                "hill_or_mountain_view",
                "cul_de_sac",
                "ocean_view",
                "corner_lot",
                "lake_view",
                "golf_course_lot_or_frontage",
                "golf_course_view",
                "river_view",
                "city_view",
                "horse_facilities",
                "spa_or_hot_tub",
                "community_doorman",
                "pets_allowed",
                "community_outdoor_space",
                "elevator",
                "carport",
                "rv_or_boat_parking",
                "single_story",
                "two_or_more_stories",
                "basement",
                "dining_room",
                "hardwood_floors",
                "family_room",
                "fireplace",
                "furniture",
                "dishwasher",
                "den_or_office",
                "game_room",
                "disability_features",
                "community_swimming_pool",
                "community_boat_facilities",
                "community_spa_or_hot_tub",
                "tennis_court",
                "community_golf",
                "community_clubhouse",
                "community_security_features",
                "community_horse_facilities",
                "community_no_fee",
                "community_park",
                "recreation_facility",
                "senior_community",
                "energy_efficient"
              ],
              "enumTitles": [
                "Central air",
                "Central heat",
                "Forced air",
                "Washer dryer",
                "Community gym",
                "Laundry room",
                "Garage, 1+ cars",
                "Garage, 2+ cars",
                "Garage, 3+ cars",
                "Swimming pool",
                "Waterfront",
                "Hill or mountain view",
                "Cul de sac",
                "Ocean view",
                "Corner lot",
                "Lake view",
                "Golf course lot or frontage",
                "Golf course view",
                "River view",
                "City view",
                "Horse facilities",
                "Spa or hot tub",
                "Community doorman",
                "Pets allowed",
                "Community outdoor space",
                "Elevator",
                "Carport",
                "Rv or boat parking",
                "Single story",
                "Two or more stories",
                "Basement",
                "Dining room",
                "Hardwood floors",
                "Family room",
                "Fireplace",
                "Furniture",
                "Dishwasher",
                "Den or office",
                "Game room",
                "Disability features",
                "Community swimming pool",
                "Community boat facilities",
                "Community spa or hot tub",
                "Tennis court",
                "Community golf",
                "Community clubhouse",
                "Community security features",
                "Community horse facilities",
                "Community no fee",
                "Community park",
                "Recreation facility",
                "Senior community",
                "Energy efficient"
              ]
            }
          },
          "newConstruction": {
            "title": "🏗️ New construction",
            "enum": [
              "any",
              "only",
              "exclude"
            ],
            "type": "string",
            "description": "Include, show only, or hide new-construction homes.",
            "default": "any"
          },
          "foreclosure": {
            "title": "⚖️ Foreclosures",
            "enum": [
              "any",
              "only",
              "exclude"
            ],
            "type": "string",
            "description": "Include, show only, or hide foreclosures.",
            "default": "any"
          },
          "seniorCommunity": {
            "title": "👴 55+ communities",
            "enum": [
              "any",
              "only",
              "exclude"
            ],
            "type": "string",
            "description": "Include, show only, or hide 55+ communities.",
            "default": "any"
          },
          "pendingContingent": {
            "title": "⏳ Pending / contingent",
            "enum": [
              "include",
              "exclude",
              "pending",
              "contingent"
            ],
            "type": "string",
            "description": "Pending and contingent listings are included by default.",
            "default": "include"
          },
          "comingSoon": {
            "title": "🔜 Coming soon",
            "enum": [
              "any",
              "only"
            ],
            "type": "string",
            "description": "Include everything, or show only coming-soon listings.",
            "default": "any"
          },
          "hasVirtualTour": {
            "title": "🎥 With a virtual tour",
            "type": "boolean",
            "description": "Only properties with a virtual tour.",
            "default": false
          },
          "has3dTour": {
            "title": "🧊 With a 3D tour",
            "type": "boolean",
            "description": "Only properties with a 3D tour.",
            "default": false
          },
          "allowsCats": {
            "title": "🐱 Cats allowed · rentals",
            "type": "boolean",
            "description": "Only rentals that allow cats.",
            "default": false
          },
          "allowsDogs": {
            "title": "🐶 Dogs allowed · rentals",
            "type": "boolean",
            "description": "Only rentals that allow dogs.",
            "default": false
          },
          "radiusMiles": {
            "title": "📏 Search radius",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Also include properties within this many miles of the location. Empty = the place itself."
          },
          "polygon": {
            "title": "🗺️ Search inside a drawn area",
            "type": "object",
            "description": "A GeoJSON Polygon, for example {\"type\":\"Polygon\",\"coordinates\":[[[-115.2,36.1],[-115.1,36.1],[-115.1,36.2],[-115.2,36.2],[-115.2,36.1]]]} (longitude, latitude; the first and last point are the same). It replaces the place of a typed location or a pasted link."
          },
          "sortBy": {
            "title": "↕️ Sort results",
            "enum": [
              "relevance",
              "newest",
              "updated",
              "price_asc",
              "price_desc",
              "beds_desc",
              "lot_desc",
              "photos_desc",
              "sold_date_desc"
            ],
            "type": "string",
            "description": "Order of the results. Applies to every search, including pasted links.",
            "default": "relevance"
          },
          "maxResults": {
            "title": "📊 Max results per search",
            "minimum": 0,
            "type": "integer",
            "description": "Properties to return per search link or location. 0 = all of them (a very large search is read in parts).",
            "default": 10
          },
          "splitLargeSearches": {
            "title": "♾️ Go beyond 10,000 results",
            "type": "boolean",
            "description": "Realtor.com returns at most 10,000 properties for one search. With this on, a larger search is read in parts so every match can be reached (relevant when \"Max results\" is above 10,000 or 0).",
            "default": true
          },
          "detailLevel": {
            "title": "📦 Detail level",
            "enum": [
              "full",
              "summary"
            ],
            "type": "string",
            "description": "Full = the complete property record (history, taxes, schools, climate risk, market statistics, agents and more). Summary = only what the search results show: faster and smaller. Applies to searches.",
            "default": "full"
          },
          "includeHistoryPhotos": {
            "title": "🖼️ All photos in the sales history",
            "type": "boolean",
            "description": "Full detail only. By default each history event carries one photo; turn this on for every photo of every past listing (records get several times larger).",
            "default": false
          },
          "includeSchoolScores": {
            "title": "🎓 School test scores",
            "type": "boolean",
            "description": "Full detail only. Adds standardized-test scores for every school (about 30 KB more per property).",
            "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}