{
"openapi": "3.0.1",
"info": {
"title": "For Sale By Owner (FSBO) Scraper",
"description": "Scrape For Sale By Owner (FSBO) homes on ForSaleByOwner.com by city, county, state or ZIP: price, beds, baths, sq ft, address, photos, days listed, sold date, and whether the seller takes cash or owner financing. Active, under-contract and sold. Export to JSON, CSV or Excel, or via API.",
"version": "1.0",
"x-build-id": "viwi9bPCNgrxYYjTX"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/steadyscrape~fsbo-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-steadyscrape-fsbo-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/steadyscrape~fsbo-scraper/runs": {
"post": {
"operationId": "runs-sync-steadyscrape-fsbo-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/steadyscrape~fsbo-scraper/run-sync": {
"post": {
"operationId": "run-sync-steadyscrape-fsbo-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": [
"locations"
],
"properties": {
"locations": {
"title": "Locations",
"type": "array",
"description": "One place or link per line: a city as Houston, TX, a county as Harris County, TX, a state (Texas or TX), a 5-digit ZIP code (77049), a ForSaleByOwner.com search link (https://www.forsalebyowner.com/search/list/houston-texas, whose filters are kept), or a single listing link (https://www.forsalebyowner.com/listing/…/<id>).",
"items": {
"type": "string"
}
},
"maxListingsPerLocation": {
"title": "Maximum listings per location",
"minimum": 0,
"type": "integer",
"description": "Stop each location after this many listings. 0 means every listing the site has for it.",
"default": 1000
},
"listingStatuses": {
"title": "Listing status",
"minItems": 1,
"type": "array",
"description": "Which listings to scrape: active (for sale), under contract, and sold (with the date sold). Pick one or more.",
"items": {
"type": "string",
"enum": [
"for_sale",
"under_contract",
"sold"
],
"enumTitles": [
"For sale",
"Under contract",
"Sold"
]
},
"default": [
"for_sale"
]
},
"includeNewConstruction": {
"title": "Include new construction",
"type": "boolean",
"description": "ForSaleByOwner.com mixes builders' new homes into its results (e.g. 163 of Houston's 198 \"for sale\" rows). Off by default, so you get homes sold by their owners only; on, builder rows come with the builder's name, plan and listing link.",
"default": false
},
"propertyTypes": {
"title": "Property types",
"type": "array",
"description": "Leave empty for every type.",
"items": {
"type": "string",
"enum": [
"house",
"condo",
"townhouse",
"multi",
"land"
],
"enumTitles": [
"House",
"Condo",
"Townhouse",
"Multi-family",
"Land"
]
},
"default": []
},
"minPrice": {
"title": "Minimum price (US$)",
"minimum": 0,
"type": "integer",
"description": "Leave empty for any price."
},
"maxPrice": {
"title": "Maximum price (US$)",
"minimum": 0,
"type": "integer",
"description": "Leave empty for any price."
},
"minBedrooms": {
"title": "Minimum bedrooms",
"minimum": 0,
"maximum": 9,
"type": "integer",
"description": "0 to 9. Leave empty for any."
},
"minBathrooms": {
"title": "Minimum bathrooms",
"minimum": 0,
"maximum": 9,
"type": "integer",
"description": "0 to 9. Leave empty for any."
},
"minYearBuilt": {
"title": "Built in or after",
"minimum": 0,
"type": "integer",
"description": "A year, e.g. 1990. Leave empty for any."
},
"maxYearBuilt": {
"title": "Built in or before",
"minimum": 0,
"type": "integer",
"description": "A year. Leave empty for any."
},
"minLivingArea": {
"title": "Minimum living area (sq ft)",
"minimum": 0,
"type": "integer",
"description": "Leave empty for any size."
},
"maxLivingArea": {
"title": "Maximum living area (sq ft)",
"minimum": 0,
"type": "integer",
"description": "Leave empty for any size."
},
"onlyOwnerFinancing": {
"title": "Only sellers offering owner financing",
"type": "boolean",
"description": "Keep only listings whose seller says they accept owner financing (16 of Houston's 35 owner listings on 2026-10-30). Applied to the listings read; one left out is not charged.",
"default": false
},
"onlyNewOrChanged": {
"title": "Only new listings and changes",
"type": "boolean",
"description": "For scheduled runs: deliver only listings no earlier run of the same locations and filters delivered, and listings whose price or status changed (with the earlier price and status). Include \"Under contract\" and \"Sold\" in the statuses to see a listing go under contract or sell. The memory lives in your account's key-value store steadyscrape-fsbo-state.",
"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
}
}
}
}
}
}
}
}
}
}