{
  "openapi": "3.0.1",
  "info": {
    "title": "Furnished Finder Scraper: Rentals + Rent Change Monitor",
    "description": "Furnished Finder API alternative: export monthly furnished rentals (travel nurse and corporate housing) for any US city, then schedule it to get new listings and rent changes with the previous price. Rent, beds, baths, availability, amenities, host, link and a 0-100 lead score.",
    "version": "1.0",
    "x-build-id": "y5MHOK5IsU8iaRGS6"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/benthepythondev~furnished-finder-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-benthepythondev-furnished-finder-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/benthepythondev~furnished-finder-scraper/runs": {
      "post": {
        "operationId": "runs-sync-benthepythondev-furnished-finder-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/benthepythondev~furnished-finder-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-benthepythondev-furnished-finder-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": "Locations",
            "type": "array",
            "description": "One or more cities as 'Austin, TX', a city slug like us--tx--austin, or a furnishedfinder.com/housing/ link. Each is searched to its end or to maxResults. Used instead of the single location field below.",
            "default": [
              "Austin, TX"
            ],
            "items": {
              "type": "string"
            }
          },
          "listingUrls": {
            "title": "Listing links",
            "type": "array",
            "description": "Furnished Finder /property/ links or ids like 1010674_1, read with their full details. Can be combined with locations.",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "City slug or housing URL",
            "type": "string",
            "description": "A single city slug or unfiltered /housing/ URL. Used only when Locations and Listing links are empty.",
            "default": "us--tx--austin"
          },
          "minPrice": {
            "title": "Minimum monthly rent (USD)",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Filter advertised source listings by this inclusive bound."
          },
          "maxPrice": {
            "title": "Maximum monthly rent (USD)",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Filter advertised source listings by this inclusive bound."
          },
          "minBedrooms": {
            "title": "Minimum bedrooms",
            "minimum": 0,
            "maximum": 30,
            "type": "integer",
            "description": "Filter advertised source listings by this inclusive bound."
          },
          "minBathrooms": {
            "title": "Minimum bathrooms",
            "minimum": 0,
            "maximum": 30,
            "type": "number",
            "description": "Filter advertised source listings by this inclusive bound."
          },
          "propertyType": {
            "title": "Rental type",
            "enum": [
              "entire_unit",
              "room"
            ],
            "type": "string",
            "description": "Leave unset for rooms and entire units."
          },
          "petsAllowed": {
            "title": "Require pets allowed",
            "type": "boolean",
            "description": "False leaves this amenity unrestricted.",
            "default": false
          },
          "utilitiesIncluded": {
            "title": "Require utilities included",
            "type": "boolean",
            "description": "False leaves this amenity unrestricted.",
            "default": false
          },
          "moveInDate": {
            "title": "Move-in date",
            "type": "string",
            "description": "Optional YYYY-MM-DD. Move-out must be later than move-in. Advertised availability is not a booking."
          },
          "moveOutDate": {
            "title": "Move-out date",
            "type": "string",
            "description": "Optional YYYY-MM-DD. Move-out must be later than move-in. Advertised availability is not a booking."
          },
          "maxResults": {
            "title": "Maximum listings to scan",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Maximum listings saved per run across all locations (with onlyChanges: listings scanned). A city such as Austin has about 2,000.",
            "default": 10
          },
          "includeDetails": {
            "title": "Include full listing details",
            "type": "boolean",
            "description": "Adds description, square feet, host profile (name, username, tenure, verifications, bio), reviews, house rules, fees, booked periods, nearby hospitals and all photos. One extra request per listing; off returns the search card only.",
            "default": true
          },
          "onlyChanges": {
            "title": "Return only new or changed listings",
            "type": "boolean",
            "description": "Persist a baseline in your own account; export new observations and tracked changes.",
            "default": false
          },
          "monitorId": {
            "title": "Monitor ID (optional)",
            "maxLength": 80,
            "type": "string",
            "description": "Reuse for one search. Leave blank to derive it from the search. Avoid concurrent runs."
          },
          "emitInitial": {
            "title": "Export initial baseline",
            "type": "boolean",
            "description": "Disable to seed a new monitor without exporting its baseline rows.",
            "default": true
          },
          "resetMonitor": {
            "title": "Reset this monitor",
            "type": "boolean",
            "description": "Requires onlyChanges. Replaces only this baseline after a successful run; disable for later scheduled runs.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}