{ "openapi": "3.0.1", "info": { "title": "BusinessesForSale.com Scraper: Businesses & Franchises for Sale", "description": "Scrape BusinessesForSale.com data: businesses, franchises and M&A Vault deals for sale in the US, UK, Australia and worldwide, by sector, place and feature, with asking price, revenue, cash flow or net profit, location and tags. Export to JSON, CSV or Excel, or via API.", "version": "1.0", "x-build-id": "WtrGavhmchWRhOlF3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steadyscrape~businesses-for-sale-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steadyscrape-businesses-for-sale-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~businesses-for-sale-scraper/runs": { "post": { "operationId": "runs-sync-steadyscrape-businesses-for-sale-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~businesses-for-sale-scraper/run-sync": { "post": { "operationId": "run-sync-steadyscrape-businesses-for-sale-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": { "site": { "title": "Site", "enum": [ "us", "uk", "australia", "worldwide" ], "type": "string", "description": "Which BusinessesForSale.com site to search. All countries (www.businessesforsale.com) lists every country's businesses, Canada, the UAE, South Africa, Greece and the rest included, by sector and feature but not by place.", "default": "us" }, "sectors": { "title": "Sectors", "type": "array", "description": "BusinessesForSale.com's own sectors and sub-sectors (Restaurants, Cafes, Online › Apps, Services › Construction…). Each sector is a separate search. Leave empty for every sector. For a deeper sub-sector (Italian Restaurants), open it on the site and paste the link below.", "items": { "type": "string", "enum": [ "agriculture-businesses", "agricultural-supply-businesses", "farms", "miscellaneous-agriculture-businesses", "ranches", "vineyards-and-wineries", "energy-businesses", "energy-related-businesses", "oil-and-petrochemical-related-businesses", "renewable-energy-businesses", "engineering-businesses", "engineering-consultancies", "electrical-services-businesses", "engineering-manufacturing-businesses", "mechanical-services-businesses", "technical-service-businesses", "food-businesses", "breweries", "cafes", "catering-businesses", "food-and-drink-distributors", "food-and-drink-manufacturing-businesses", "food-and-drink-wholesalers", "mobile-catering-businesses", "restaurants", "food-retail-businesses", "franchise-resales", "food-resale-franchises", "leisure-resale-franchises", "miscellaneous-resale-franchises", "retail-resale-franchises", "service-resale-franchises", "leisure-businesses", "entertainment-and-fun-businesses", "hotels-and-motels", "pubs-bars-and-nightclubs", "recreation-businesses", "manufacturing-businesses", "clothing-and-footwear-manufacturers", "furniture-manufacturers", "machinery-and-metal-businesses", "mining-businesses", "other-manufacturing-businesses", "transportation-related-manufacturing-businesses", "online-businesses", "apps", "content-websites", "domain-name-businesses", "dropshipping-businesses", "internet-businesses", "real-estate", "commercial-property", "gas-petrol-service-stations", "industrial-warehouses-distribution-businesses", "investment-opportunities", "land", "light-industrial-businesses", "management-rights-opportunities", "misc-properties", "offices-and-business-centers", "parking-lot", "real-estate-development-opportunities", "residential-properties", "retail-shops-to-lease", "retail-warehouses", "self-storage-warehouses", "shopping-center-units", "retail-businesses", "clothing-businesses", "food-and-drink-businesses", "general-retail-businesses", "health-and-beauty-businesses", "home-and-garden-businesses", "tv-audio-video-and-photographic-businesses", "vehicle-related-businesses", "services-businesses", "advertising-and-marketing-businesses", "construction-businesses", "education-businesses", "financial-businesses", "general-services-businesses", "health-care-businesses", "hire-businesses", "house-and-garden-businesses", "maintenance-businesses", "pet-businesses", "postal-and-communication-businesses", "printing-and-typesetting-businesses", "professional-service-businesses", "transportation-businesses", "wedding-businesses", "technology-and-media-businesses", "information-technology-businesses", "media-businesses", "wholesale-and-distribution-businesses", "distribution-businesses", "refrigeration-and-cold-storage-businesses", "wholesale-businesses" ], "enumTitles": [ "Agriculture", "Agriculture › Agricultural Supplies", "Agriculture › Farms", "Agriculture › Misc. Agriculture", "Agriculture › Ranches", "Agriculture › Vineyards & Wineries", "Energy", "Energy › Energy Related", "Energy › Oil & Petrochemical Related", "Energy › Renewable Energy", "Engineering", "Engineering › Consultants", "Engineering › Electrical Services", "Engineering › Engineering Manufacturing", "Engineering › Mechanical Services", "Engineering › Other Technical Services", "Food", "Food › Breweries", "Food › Cafes", "Food › Catering Services", "Food › Food & Drink Distributors", "Food › Food & Drink Manufacturers", "Food › Food & Drink Wholesalers", "Food › Mobile Catering", "Food › Restaurants", "Food › Retailers", "Franchise Resales", "Franchise Resales › Food Franchise Resales", "Franchise Resales › Leisure Franchise Resales", "Franchise Resales › Misc. Franchise Resales", "Franchise Resales › Retail Franchise Resales", "Franchise Resales › Service Franchise Resales", "Leisure", "Leisure › Entertainment & Fun", "Leisure › Hotels & Motels", "Leisure › Pubs, Bars & Nightclubs", "Leisure › Recreation", "Manufacturing", "Manufacturing › Clothing & Footwear Manufacturers", "Manufacturing › Furniture & Wood", "Manufacturing › Machinery & Metal", "Manufacturing › Mining", "Manufacturing › Other", "Manufacturing › Transportation Related", "Online", "Online › Apps", "Online › Content Websites", "Online › Domain Names", "Online › Dropshipping", "Online › Internet", "Real Estate (US, worldwide)", "Commercial Property (UK, Australia)", "Real Estate › Gas/Petrol Service Stations", "Real Estate › Industrial Warehouse / Distribution", "Real Estate › Investment", "Real Estate › Land", "Real Estate › Light Industrial", "Real Estate › Management Rights", "Real Estate › Misc. Property", "Real Estate › Offices & Business Centers", "Real Estate › Parking Lots", "Real Estate › Real Estate Development", "Real Estate › Residential", "Real Estate › Retail Shops To Lease", "Real Estate › Retail Warehouse", "Real Estate › Self Storage", "Real Estate › Shopping Center Units", "Retail", "Retail › Clothing", "Retail › Food & Drink", "Retail › General", "Retail › Health & Beauty", "Retail › Home & Garden", "Retail › TV, Audio, Video & Photographic", "Retail › Vehicles", "Services", "Services › Advertising & Marketing", "Services › Construction", "Services › Education", "Services › Financial", "Services › General", "Services › Health Care", "Services › Hire", "Services › House & Garden", "Services › Maintenance", "Services › Pets", "Services › Postal & Communication", "Services › Printing & Typesetting Services", "Services › Professional", "Services › Transportation", "Services › Wedding", "Tech & Media", "Tech & Media › Information Technology", "Tech & Media › Media", "Wholesale & Distribution", "Wholesale & Distribution › Distribution", "Wholesale & Distribution › Refrigeration & Cold Storage", "Wholesale & Distribution › Wholesale" ] } }, "locations": { "title": "Places", "type": "array", "description": "States, counties, regions or cities as the site names them (Texas, Fort Worth, Williamson County, Texas, London, Queensland), one per line. Each place is a separate search, combined with each sector. A place the site has no page for gives a free row saying so. US, UK and Australian sites only. Up to 100.", "items": { "type": "string" } }, "features": { "title": "Features", "type": "array", "description": "Only listings the site tags with this feature: Owner Financed, Relocatable, Work From Home, Price Reduced, Distressed, Real Property, Freehold… Each feature is a separate search (a listing found by two is delivered once). Leave empty for all.", "items": { "type": "string", "enum": [ "new-lease", "existing-lease", "relocatable", "owner-managed", "employee-owned", "absentee-ownership", "work-from-home", "accommodation-included", "franchise", "new-franchise", "franchise-resale", "business-opportunity", "price-reduced", "mid-market", "distressed", "closed-asset-sale", "low-cost", "owner-financed", "hidden-gem", "quick-sale", "real-property", "lease", "turnaround-opportunity", "bankruptcy", "freehold", "leasehold", "administration", "liquidation", "in-receivership", "voluntary-arrangement", "pre-appointment", "pre-pack-administration" ], "enumTitles": [ "New Lease", "Existing Lease", "Relocatable", "Owner Managed", "Employee Owned (ESOP)", "Absentee Ownership", "Work From Home", "Accommodation Included", "Franchise", "New Franchise", "Franchise Resale", "Business Opportunity", "Price Reduced", "Mid Market", "Distressed", "Closed / Asset Sale", "Low Cost", "Owner Financed", "Hidden Gem", "Quick Sale", "Real Property (US, worldwide)", "Lease (US, worldwide)", "Turnaround Opportunity (US, worldwide)", "Bankruptcy (US, worldwide)", "Freehold (UK, Australia)", "Leasehold (UK, Australia)", "Administration (UK, Australia)", "Liquidation (UK, Australia)", "In Receivership (UK, Australia)", "Voluntary Arrangement (UK, Australia)", "Pre-Appointment (UK)", "Pre-Pack Administration (UK)" ] } }, "includeFranchiseAds": { "title": "Include franchise and business-opportunity ads", "type": "boolean", "description": "The site mixes franchisors' ads (Franchise, Opportunity: fee, total investment, liquid capital) into every results list. Untick to get only businesses for sale and M&A Vault listings; skipped ads are counted in the free search row and not charged.", "default": true }, "startUrls": { "title": "BusinessesForSale.com links", "type": "array", "description": "Results pages copied from the US, UK, Australian or worldwide site, one per line: any sector, place or feature page (https://us.businessesforsale.com/us/search/italian-restaurants-for-sale-in-chicago), from page 1 or a later page (…-for-sale-3). Listing pages, filtered searches with ? in the link and the other country sites are not read; each gives a free row saying why. The form above searches too when you give it a sector, place or feature. Up to 5,000.", "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max listings per search", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Stop each search (each sector × place × feature, and each link) after this many listings. The site shows 25 a page. The run's spending limit is respected too.", "default": 100 } } }, "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 } } } } } } } } } }