{ "openapi": "3.0.1", "info": { "title": "FurnishedFinder $1💰 Listings, Amenities & Reviews", "description": "From $1/1K. Scrape furnishedfinder.com listings by city or URL. Extract structured data including price, beds, baths, occupancy, amenities, photos, location, square footage, ratings, reviews, utilities, house rules, and fees. Fast and reliable via the site's data API.", "version": "1.0", "x-build-id": "0LMQrjAoprbqfDVki" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~furnishedfinder-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-furnishedfinder-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/abotapi~furnishedfinder-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-furnishedfinder-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/abotapi~furnishedfinder-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-furnishedfinder-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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "search = enter cities and filters. url = paste Furnished Finder search or property URLs.", "default": "search" }, "locations": { "title": "Cities", "type": "array", "description": "Cities to scrape. Accepts free text ('Houston, TX', 'Houston'), 'City, State', or a Furnished Finder slug ('us--tx--houston'). One search box is built around each city.", "default": [ "Houston, TX" ], "items": { "type": "string" } }, "propertyTypeClass": { "title": "Property type", "enum": [ "any", "entire_unit", "room" ], "type": "string", "description": "Entire unit (whole place) or Room (private/shared room). Leave as Any for both.", "default": "any" }, "minPrice": { "title": "Min monthly price (USD)", "minimum": 0, "type": "integer", "description": "Minimum monthly rent. Leave empty for no minimum." }, "maxPrice": { "title": "Max monthly price (USD)", "minimum": 0, "type": "integer", "description": "Maximum monthly rent. Leave empty for no maximum." }, "minBedrooms": { "title": "Min bedrooms", "minimum": 0, "type": "integer", "description": "Minimum bedroom count. Leave empty for any." }, "minBathrooms": { "title": "Min bathrooms", "minimum": 0, "type": "integer", "description": "Minimum bathroom count. Leave empty for any." }, "urls": { "title": "URLs", "type": "array", "description": "Paste Furnished Finder search URLs (/housing/us--tx--houston) or property URLs (/property/999116_1). Multi-URL supported.", "items": { "type": "string" } }, "fetchDetails": { "title": "Fetch full property details", "type": "boolean", "description": "ON: each listing gets description, square footage, rating, review count, utilities, house rules, fees, full amenity list and bed/bath breakdown (one extra request per listing). OFF: faster, listing-card fields only.", "default": true }, "fetchReviews": { "title": "Include guest reviews", "type": "boolean", "description": "ON: add a reviews array per listing (reviewer, star rating, date, text, landlord reply). Only applies when 'Fetch full property details' is ON, and only listings that have reviews cost an extra request. Turn OFF to keep details but skip reviews.", "default": true }, "maxPages": { "title": "Max pages per city", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many result pages (50 listings each) to walk per city/search URL.", "default": 1 }, "maxListings": { "title": "Max listings (0 = unlimited)", "minimum": 0, "type": "integer", "description": "Overall cap across all cities/URLs. 0 means no cap (bounded by max pages).", "default": 0 }, "proxy": { "title": "Proxy", "type": "object", "description": "Residential US is required. Free plans do not include residential proxy.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }