{
  "openapi": "3.0.1",
  "info": {
    "title": "Realtor.com Scraper: Every Listing, Sold Prices & Agents",
    "description": "Scrape every Realtor.com listing of a city, ZIP or county (for sale, for rent, sold), past the 10,000-result wall and the repeating pages, with agent email and phone. Home details, tax history, schools, new-listing and price-change monitoring.",
    "version": "0.1",
    "x-build-id": "dPgqmiUffblbiAbzp"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/alexmorain~realtor-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-alexmorain-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/alexmorain~realtor-scraper/runs": {
      "post": {
        "operationId": "runs-sync-alexmorain-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/alexmorain~realtor-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-alexmorain-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": {
          "locations": {
            "title": "Places",
            "type": "array",
            "description": "City, ZIP code, county or neighborhood, written as on Realtor.com: <code>Austin, TX</code>, <code>78701</code>, <code>Travis County, TX</code>, <code>Hyde Park, Austin, TX</code>. One search per place.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Realtor.com search URLs",
            "type": "array",
            "description": "Or paste search pages from your browser, e.g. <code>https://www.realtor.com/realestateandhomes-search/Austin_TX/beds-3/price-300000-500000</code>, <code>/apartments/Houston_TX</code>, <code>/show-recently-sold</code>. The place, listing type and filters in the URL are kept; filters below fill the ones the URL does not set.",
            "items": {
              "type": "string"
            }
          },
          "listingType": {
            "title": "Listing type",
            "enum": [
              "forSale",
              "forRent",
              "sold"
            ],
            "type": "string",
            "description": "Applies to the places above. A pasted URL keeps its own type.",
            "default": "forSale"
          },
          "minPrice": {
            "title": "Min price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Monthly rent for rentals."
          },
          "maxPrice": {
            "title": "Max price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Monthly rent for rentals."
          },
          "minBeds": {
            "title": "Min bedrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "0 = studios included."
          },
          "maxBeds": {
            "title": "Max bedrooms",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Use 0 for studios only."
          },
          "minBaths": {
            "title": "Min bathrooms",
            "minimum": 0,
            "maximum": 10,
            "type": "integer",
            "description": "Full and half bathrooms counted as Realtor.com counts them."
          },
          "minSqft": {
            "title": "Min living area (sq ft)",
            "minimum": 0,
            "type": "integer",
            "description": "Interior living area."
          },
          "maxSqft": {
            "title": "Max living area (sq ft)",
            "minimum": 0,
            "type": "integer",
            "description": "Interior living area."
          },
          "minLotSqft": {
            "title": "Min lot size (sq ft)",
            "minimum": 0,
            "type": "integer",
            "description": "1 acre = 43,560 sq ft."
          },
          "maxLotSqft": {
            "title": "Max lot size (sq ft)",
            "minimum": 0,
            "type": "integer",
            "description": "1 acre = 43,560 sq ft."
          },
          "minYearBuilt": {
            "title": "Built in or after",
            "minimum": 0,
            "maximum": 2100,
            "type": "integer",
            "description": "Year built, e.g. 2000."
          },
          "maxYearBuilt": {
            "title": "Built in or before",
            "minimum": 0,
            "maximum": 2100,
            "type": "integer",
            "description": "Year built, e.g. 2020."
          },
          "homeTypes": {
            "title": "Home types",
            "type": "array",
            "description": "Leave empty for all types.",
            "items": {
              "type": "string",
              "enum": [
                "house",
                "condo",
                "townhouse",
                "multiFamily",
                "lot",
                "manufactured",
                "farm"
              ],
              "enumTitles": [
                "House",
                "Condo",
                "Townhouse",
                "Multi-family",
                "Lot / land",
                "Manufactured / mobile",
                "Farm / ranch"
              ]
            }
          },
          "daysOnRealtor": {
            "title": "Listed or sold within",
            "enum": [
              "1",
              "7",
              "14",
              "30",
              "90",
              "6m",
              "12m",
              "24m",
              "36m"
            ],
            "type": "string",
            "description": "Only listings that appeared on Realtor.com (or, for sold homes, sold) within this window. Leave empty for no limit."
          },
          "newConstructionOnly": {
            "title": "New construction only",
            "type": "boolean",
            "description": "Only newly built homes.",
            "default": false
          },
          "hidePending": {
            "title": "Hide pending (under contract)",
            "type": "boolean",
            "description": "For sale only. Realtor.com includes homes under contract in its for-sale results by default (907 of 6,392 in Austin on 17/11/2026).",
            "default": false
          },
          "fullCoverage": {
            "title": "Full coverage",
            "type": "boolean",
            "description": "Get every listing of the area. One Realtor.com search stops at 10,000 results and its default order repeats listings from page to page; the actor splits big areas by price (sold homes by sale date) and reads each part sorted by date. The SEARCHES record shows the count Realtor announced next to the count returned.",
            "default": true
          },
          "includeDetails": {
            "title": "Include home page details",
            "type": "boolean",
            "description": "Also read each home page: price and sale history, tax history and assessed values, value estimates, nearby schools, flood score, open houses, pet policy, HOA fee. Charged as a detailed listing instead of a listing.",
            "default": false
          },
          "maxItems": {
            "title": "Max listings",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many listings in the whole run. 0 = no limit. With a small limit, the newest listings come first."
          },
          "monitorMode": {
            "title": "Monitor mode",
            "enum": [
              "off",
              "newOnly",
              "newAndPriceChanges"
            ],
            "type": "string",
            "description": "For scheduled runs: return only listings not returned by an earlier run with the same searches (and, if chosen, listings whose price changed, with <code>previousPrice</code> and <code>priceChange</code>). Listings skipped this way are not charged.",
            "default": "off"
          },
          "monitorName": {
            "title": "Monitor name (optional)",
            "type": "string",
            "description": "Keeps the monitor memory under this name, so you can change searches or filters without starting over. Different names = separate memories."
          },
          "webhookUrl": {
            "title": "Webhook URL (optional)",
            "type": "string",
            "description": "Receives a JSON summary (status, listings, price changes, run id, dataset id) when the run ends. Slack, Discord, Zapier and Make URLs work. Never logged."
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify datacenter proxy by default, which Realtor.com's data endpoint accepts; the actor switches to US residential IPs by itself if datacenter IPs are refused. Leave as is.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}