{ "openapi": "3.0.1", "info": { "title": "Businesses For Sale Scraper — Price, Revenue & Broker Leads", "description": "Extract business-for-sale listings from BusinessesForSale.com across the US, UK, Australia and worldwide. Get asking price, revenue, cash flow, sector, location and broker details as clean, sortable data. Filter by price, turnover or profit and export to Excel, CSV, JSON or API.", "version": "0.1", "x-build-id": "LFh6rTCoWSpYe8lNR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/haketa~businessesforsale-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-haketa-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/haketa~businessesforsale-scraper/runs": { "post": { "operationId": "runs-sync-haketa-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/haketa~businessesforsale-scraper/run-sync": { "post": { "operationId": "run-sync-haketa-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", "properties": { "country": { "title": "Edition (country)", "enum": [ "us", "uk", "australia", "international" ], "type": "string", "description": "Which regional edition of BusinessesForSale.com to search. Each edition covers a different market and currency.", "default": "us" }, "searchTerms": { "title": "Search keywords (optional)", "type": "array", "description": "Find businesses by keyword, for example \"coffee shop\", \"car wash\" or \"dental practice\". Add as many as you like — each keyword is searched separately. Leave empty to browse all businesses (or a category below).", "items": { "type": "string" } }, "category": { "title": "Category slug (optional)", "type": "string", "description": "Browse a specific category instead of everything. Use a slug exactly as it appears in the site URL, e.g. `restaurants-for-sale`, `bars-for-sale`, `hotels-for-sale`, `farms-for-sale`, `price-reduced-businesses-for-sale` or `relocatable-businesses-for-sale`. Leave empty for all businesses." }, "searchUrls": { "title": "Search URLs (optional, advanced)", "type": "array", "description": "Paste one or more full BusinessesForSale.com search-result URLs to scrape them directly. Great for regions, sub-categories or filter combinations that aren't covered by the fields above. Pagination is handled automatically.", "items": { "type": "string" } }, "sort": { "title": "Sort order", "enum": [ "", "ModifiedDesc", "PriceAsc", "PriceDesc", "TurnoverDesc", "ProfitDesc" ], "type": "string", "description": "How to order the results before collecting them.", "default": "" }, "minAskingPrice": { "title": "Min asking price", "minimum": 0, "type": "integer", "description": "Only businesses with an asking price at or above this amount (in the edition's currency)." }, "maxAskingPrice": { "title": "Max asking price", "minimum": 0, "type": "integer", "description": "Only businesses with an asking price at or below this amount." }, "minRevenue": { "title": "Min revenue / turnover", "minimum": 0, "type": "integer", "description": "Only businesses with annual revenue (turnover) at or above this amount." }, "maxRevenue": { "title": "Max revenue / turnover", "minimum": 0, "type": "integer", "description": "Only businesses with annual revenue at or below this amount." }, "minCashFlow": { "title": "Min cash flow / net profit", "minimum": 0, "type": "integer", "description": "Only businesses with cash flow (net profit) at or above this amount." }, "maxCashFlow": { "title": "Max cash flow / net profit", "minimum": 0, "type": "integer", "description": "Only businesses with cash flow at or below this amount." }, "disclosedFinancialsOnly": { "title": "Only listings with disclosed figures", "type": "boolean", "description": "Skip listings that hide their asking price and turnover (\"On request\"). Useful when you only want deals with real numbers.", "default": false }, "includeDetails": { "title": "Fetch full details for each listing", "type": "boolean", "description": "Open every listing page to add the full description, exact revenue & cash flow, broker name, what's included in the price, real-estate terms, reason for selling and photo gallery. Richer data, but slower and a bit more expensive.", "default": false }, "includeFranchises": { "title": "Include franchise opportunities", "type": "boolean", "description": "Also include franchise / business-opportunity results that appear alongside the businesses for sale.", "default": false }, "maxItems": { "title": "Max results", "minimum": 0, "type": "integer", "description": "Stop after collecting this many businesses in total. Set 0 for no limit.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxies are strongly recommended for reliable results. The Actor automatically matches the proxy country to the edition you choose.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }