{ "openapi": "3.0.1", "info": { "title": "BusinessesForSale Scraper", "description": "Extract business listings, asking prices, revenues, cash flows, established years, employees count, and seller contact URLs from BusinessesForSale.com. Download clean tables of brokerage resales automatically for private equity research and corporate audits.", "version": "0.1", "x-build-id": "NLm3pOoY4O4oXmzLN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~businessesforsale-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-businessesforsale-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/getascraper~businessesforsale-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-businessesforsale-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/getascraper~businessesforsale-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-businessesforsale-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": [ "proxyConfiguration" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "BusinessesForSale search, category, or direct listing URLs. Overrides all filter fields when provided.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchKeywords": { "title": "Search Keywords", "type": "array", "description": "Keywords to search for (e.g. 'car wash', 'coffee shop'). Each keyword generates a separate search URL.", "default": [], "items": { "type": "string" } }, "country": { "title": "Target Country Site", "enum": [ "global", "us", "uk", "ca", "au", "nz" ], "type": "string", "description": "Target country domain to browse. Each country has its own localized listings.", "default": "global" }, "industry": { "title": "Industry / Sector", "enum": [ "all", "restaurants-food", "retail", "manufacturing", "wholesale-distribution", "service-businesses", "automotive", "construction", "healthcare-medical", "beauty-personal-care", "online-internet", "education-training", "agriculture-farming", "transportation", "real-estate-property", "hotels-motels", "bars-nightclubs", "franchises", "import-export", "leisure-entertainment" ], "type": "string", "description": "Filter to a specific business category. Combines with locationText when both are set.", "default": "all" }, "locationText": { "title": "Location", "type": "string", "description": "City, state, or region to filter by (e.g. 'California', 'London', 'New York'). Converted to a URL slug." }, "maxItems": { "title": "Max Items", "minimum": 1, "type": "integer", "description": "Maximum total listings to scrape across all search URLs.", "default": 100 }, "minPrice": { "title": "Min Asking Price", "minimum": 0, "type": "integer", "description": "Only return listings with asking prices at or above this value (e.g. 50000)." }, "maxPrice": { "title": "Max Asking Price", "minimum": 0, "type": "integer", "description": "Only return listings with asking prices at or below this value (e.g. 1000000)." }, "minRevenue": { "title": "Min Annual Revenue", "minimum": 0, "type": "integer", "description": "Only return listings with annual revenue at or above this value. Requires deepScrape." }, "maxRevenue": { "title": "Max Annual Revenue", "minimum": 0, "type": "integer", "description": "Only return listings with annual revenue at or below this value. Requires deepScrape." }, "minCashFlow": { "title": "Min Cash Flow / Profit", "minimum": 0, "type": "integer", "description": "Only return listings with annual cash flow at or above this value. Requires deepScrape." }, "maxCashFlow": { "title": "Max Cash Flow / Profit", "minimum": 0, "type": "integer", "description": "Only return listings with annual cash flow at or below this value. Requires deepScrape." }, "sortOrder": { "title": "Sort Order", "enum": [ "newest", "featured", "price-desc", "price-asc", "revenue-desc", "revenue-asc", "profit-desc", "profit-asc" ], "type": "string", "description": "Control the order in which BusinessesForSale returns search results.", "default": "newest" }, "deepScrape": { "title": "Deep Scrape (Listing Details)", "type": "boolean", "description": "Fetch individual listing pages to extract revenue, cash flow, employees, lease terms, broker info, and relocatable flags.", "default": false }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Residential proxies recommended to bypass Cloudflare protection.", "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 } } }, "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 } } } } } } } } } }