{
  "openapi": "3.0.1",
  "info": {
    "title": "Realtor Rental Listings Scraper",
    "description": "Realtor.com scraper for rentals, homes for sale, pending and sold homes. Get rent, list price, beds, baths, sqft, lease terms, pet fees, agent phone and email, price and tax history, schools and flood risk. 100 listings in 14 seconds, 82 fields each. Search by city, neighborhood, ZIP code or URL.",
    "version": "1.0",
    "x-build-id": "umysi3X7mCGUbk4Qo"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~realtor-rental-scraper-ppe/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-realtor-rental-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/silentflow~realtor-rental-scraper-ppe/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-realtor-rental-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/silentflow~realtor-rental-scraper-ppe/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-realtor-rental-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",
        "properties": {
          "startUrls": {
            "title": "🔗 Realtor.com URLs",
            "type": "array",
            "description": "Paste Realtor.com pages. Search pages keep their filters and their kind of listing: <code>realtor.com/apartments/Austin_TX/beds-2/price-1000-2500</code> (rentals), <code>realtor.com/realestateandhomes-search/Austin_TX</code> (for sale), <code>.../78704/show-recently-sold</code> (sold). Listing pages (<code>/rentals/details/...</code>, <code>/realestateandhomes-detail/...</code>) give that listing.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "location": {
            "title": "📍 Location",
            "type": "string",
            "description": "City and state (<code>New York, NY</code>, <code>Austin, TX</code>), a neighborhood (<code>Brooklyn Heights, Brooklyn, NY</code>) or a ZIP code (<code>78704</code>). Leave empty if you only use URLs.",
            "default": ""
          },
          "listingStatus": {
            "title": "🏷️ Listings",
            "enum": [
              "for_rent",
              "for_sale",
              "pending",
              "sold"
            ],
            "type": "string",
            "description": "Which listings the location gives: homes for rent, homes for sale (pending ones included), only pending homes, or recently sold homes with their sale price and date. URLs keep their own kind of listing.",
            "default": "for_rent"
          },
          "keywords": {
            "title": "🔑 Keywords",
            "type": "array",
            "description": "Only keep listings whose description or features match these words or phrases, e.g. <code>pool</code>, <code>washer dryer</code> or <code>furnished</code>. Every keyword must match, so each one you add narrows the results. Applies to the location and to search URLs, not to individual listing links. Leave empty to get every listing.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "🔢 Maximum listings",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum number of listings to save. Listing links pasted one by one are read first, then each search until this number is reached.",
            "default": 100
          },
          "sort": {
            "title": "Sort results",
            "enum": [
              "newest",
              "price_asc",
              "price_desc"
            ],
            "type": "string",
            "description": "Newest first gives the latest listings, or the latest sales for sold homes.",
            "default": "newest"
          },
          "propertyType": {
            "title": "Property type",
            "enum": [
              "",
              "apartment",
              "house",
              "townhome",
              "condo",
              "coop",
              "multi-family",
              "mobile",
              "land",
              "farm"
            ],
            "type": "string",
            "description": "Filter by property type. Leave empty for all types.",
            "default": ""
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest rent or asking price in dollars, the sale price for sold homes."
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "integer",
            "description": "Highest rent or asking price in dollars, the sale price for sold homes. Example: <code>2500</code> for rentals up to 2,500 dollars a month."
          },
          "minBed": {
            "title": "Minimum bedrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest number of bedrooms."
          },
          "maxBed": {
            "title": "Maximum bedrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Highest number of bedrooms."
          },
          "minBath": {
            "title": "Minimum bathrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest number of bathrooms."
          },
          "maxBath": {
            "title": "Maximum bathrooms",
            "minimum": 0,
            "type": "integer",
            "description": "Highest number of bathrooms."
          },
          "minSqft": {
            "title": "Minimum living area (sqft)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest living area in square feet."
          },
          "maxSqft": {
            "title": "Maximum living area (sqft)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest living area in square feet."
          },
          "amenities": {
            "title": "Amenities",
            "type": "array",
            "description": "Only keep listings that have all of these. Cats and dogs allowed apply to rentals.",
            "items": {
              "type": "string",
              "enum": [
                "swimming-pool",
                "community-swimming-pool",
                "spa-or-hot-tub",
                "garage-1-or-more",
                "garage-2-or-more",
                "garage-3-or-more",
                "washer-dryer",
                "laundry-room",
                "dishwasher",
                "central-air",
                "fireplace",
                "hardwood-floors",
                "community-gym",
                "community-elevator",
                "community-doorman",
                "community-no-fee",
                "furnished",
                "cats",
                "dogs",
                "waterfront",
                "fenced-yard",
                "basement",
                "horse-facilities"
              ],
              "enumTitles": [
                "Swimming pool",
                "Community pool",
                "Spa or hot tub",
                "Garage, 1+ car",
                "Garage, 2+ cars",
                "Garage, 3+ cars",
                "In-unit washer and dryer",
                "Laundry room",
                "Dishwasher",
                "Central air",
                "Fireplace",
                "Hardwood floors",
                "Gym",
                "Elevator",
                "Doorman",
                "No broker fee",
                "Furnished",
                "Cats allowed",
                "Dogs allowed",
                "Waterfront",
                "Fenced yard",
                "Basement",
                "Horse facilities"
              ]
            }
          },
          "radius": {
            "title": "Radius (miles)",
            "minimum": 0,
            "maximum": 50,
            "type": "integer",
            "description": "Also search this many miles around the location or ZIP code, up to 50."
          },
          "daysOnMarket": {
            "title": "Listed within (days)",
            "minimum": 1,
            "type": "integer",
            "description": "Only keep listings that went live in the last N days, e.g. <code>7</code> for a weekly watch of new rentals or new homes for sale."
          },
          "moveInBy": {
            "title": "Move in by (rentals)",
            "type": "string",
            "description": "Only keep rentals available by this date. Pick a date, or a delay from today such as <code>30 days</code> for scheduled runs."
          },
          "soldWithin": {
            "title": "Sold within (sold homes)",
            "enum": [
              "1",
              "3",
              "6",
              "12",
              "24",
              "36"
            ],
            "type": "string",
            "description": "How far back sold homes go. Leave empty for every sale, newest first."
          },
          "minLotSqft": {
            "title": "Minimum lot size (sqft)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest lot area in square feet. One acre is 43,560 sqft."
          },
          "maxLotSqft": {
            "title": "Maximum lot size (sqft)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest lot area in square feet."
          },
          "minYearBuilt": {
            "title": "Built in or after",
            "minimum": 1600,
            "maximum": 2100,
            "type": "integer",
            "description": "Earliest year built, e.g. <code>2015</code> for recent construction."
          },
          "maxYearBuilt": {
            "title": "Built in or before",
            "minimum": 1600,
            "maximum": 2100,
            "type": "integer",
            "description": "Latest year built."
          },
          "includeDetails": {
            "title": "Full listing details",
            "type": "boolean",
            "description": "Read each listing's full page: lease terms, move-in costs, pet fees, utilities, number of units, price and tax history, nearby schools, flood and fire risk, value estimate and contact info. Turn off for a faster, lighter run.",
            "default": 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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}