{ "openapi": "3.0.1", "info": { "title": "BizBuySell Scraper", "description": "Scrape BizBuySell business-for-sale listings via search URLs or structured filters, with optional full listing details.", "version": "1.0", "x-build-id": "1bJpPzWYtsoXFQ9Qy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/rigelbytes~bizbuysell-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-rigelbytes-bizbuysell-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/rigelbytes~bizbuysell-scraper/runs": { "post": { "operationId": "runs-sync-rigelbytes-bizbuysell-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/rigelbytes~bizbuysell-scraper/run-sync": { "post": { "operationId": "run-sync-rigelbytes-bizbuysell-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": { "startUrls": { "title": "Start URLs", "type": "array", "description": "BizBuySell search result URLs (with filters already applied) and/or individual listing URLs. Example: https://www.bizbuysell.com/california/travel-businesses-for-sale/?q=bHQ9MzAsNDAsODA%3D — the encoded q= hash is preserved.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "location": { "title": "Location", "type": "string", "description": "Location to search (state, county, or city), e.g. \"California\", \"Texas County, MO\", \"Austin, TX\". Used when not providing startUrls." }, "industries": { "title": "Industries", "type": "array", "description": "One or more industries / sub-industries to filter. Parent categories (e.g. Travel) or children (e.g. Travel > Hotels).", "items": { "type": "string", "enum": [ "Agriculture", "Agriculture > Greenhouses", "Agriculture > Tree Farms & Orchards", "Agriculture > Vineyards & Wineries", "Agriculture > Other Agriculture", "Automotive & Boat", "Automotive & Boat > Auto Repair & Service Shops", "Automotive & Boat > Car Dealerships", "Automotive & Boat > Car Washes", "Automotive & Boat > Equipment Rental & Dealers", "Automotive & Boat > Gas Stations", "Automotive & Boat > Junk & Salvage Yards", "Automotive & Boat > Marine/Boat Service & Dealers", "Automotive & Boat > Tire Stores", "Automotive & Boat > Towing Companies", "Automotive & Boat > Truck Stops", "Automotive & Boat > Other Automotive & Boat", "Beauty & Personal Care", "Beauty & Personal Care > Hair Salons & Barber Shops", "Beauty & Personal Care > Massage", "Beauty & Personal Care > Nail Salons", "Beauty & Personal Care > Spas", "Beauty & Personal Care > Tanning Salons", "Beauty & Personal Care > Tattoo & Body Piercing", "Beauty & Personal Care > Other Beauty & Personal Care", "Building & Construction", "Building & Construction > Building Material & Hardware Stores", "Building & Construction > Carpet & Flooring", "Building & Construction > Concrete", "Building & Construction > Electrical & Mechanical", "Building & Construction > Heavy Construction", "Building & Construction > HVAC Businesses", "Building & Construction > Insulation Businesses", "Building & Construction > Painting & Finishing Contractors", "Building & Construction > Plumbing", "Building & Construction > Roofing", "Building & Construction > Other Building & Construction", "Communication & Media", "Communication & Media > Magazines & Newspapers", "Communication & Media > Production Companies", "Communication & Media > Other Communication & Media", "Education & Children", "Education & Children > Day Care & Child Care Centers", "Education & Children > Preschools", "Education & Children > Schools", "Education & Children > Tutoring & Test Prep", "Education & Children > Other Education & Children", "Entertainment & Recreation", "Entertainment & Recreation > Art Galleries", "Entertainment & Recreation > Banquet Halls", "Entertainment & Recreation > Bowling Alleys", "Entertainment & Recreation > Casinos", "Entertainment & Recreation > Golf Courses & Services", "Entertainment & Recreation > Marinas & Fishing", "Entertainment & Recreation > Nightclubs & Theaters", "Entertainment & Recreation > Other Entertainment & Recreation", "Financial Services", "Financial Services > Accounting & Tax Practices", "Financial Services > Banking & Loans", "Financial Services > Check Cashing", "Financial Services > Insurance Agencies", "Financial Services > Other Financial Services", "Health Care & Fitness", "Health Care & Fitness > Assisted Living & Nursing Homes", "Health Care & Fitness > Chiropractic Practices", "Health Care & Fitness > Dance, Pilates & Yoga", "Health Care & Fitness > Dental Practices", "Health Care & Fitness > Gyms & Fitness Centers", "Health Care & Fitness > Home Health Care", "Health Care & Fitness > Medical Practices", "Health Care & Fitness > Medical Transportation", "Health Care & Fitness > Optometry Practice", "Health Care & Fitness > Physical Therapy Practices", "Health Care & Fitness > Other Health Care & Fitness", "Manufacturing", "Manufacturing > Auto, Boat & Aircraft", "Manufacturing > Chemical & Related products", "Manufacturing > Clothing & Fabric", "Manufacturing > Electronic & Electrical Equipment", "Manufacturing > Energy & Petroleum", "Manufacturing > Food & Related products", "Manufacturing > Furniture & Fixtures", "Manufacturing > Glass, Stone & Concrete", "Manufacturing > Industrial & Commercial Machinery", "Manufacturing > Lumber & Wood Products", "Manufacturing > Machine Shops & Tools", "Manufacturing > Medical Devices & Products", "Manufacturing > Metal Products", "Manufacturing > Mining", "Manufacturing > Packaging", "Manufacturing > Paper & Printing", "Manufacturing > Rubber & Plastic Products", "Manufacturing > Signs", "Manufacturing > Other Manufacturing", "Non-Classifiable Establishments", "Non-Classifiable Establishments > All Non-Classifiable Establishments", "Online & Technology", "Online & Technology > Cell Phone & Computer Repair & Services", "Online & Technology > Graphic & Web Design", "Online & Technology > IT & Software Services", "Online & Technology > Software & App Companies", "Online & Technology > Websites & Ecommerce", "Online & Technology > Other Online & Technology", "Pet Services", "Pet Services > Dog Daycare & Boarding", "Pet Services > Pet Grooming", "Pet Services > Pet Stores & Supplies", "Pet Services > Veterinary Practices", "Pet Services > Other Pet Services", "Restaurants & Food", "Restaurants & Food > American Restaurants", "Restaurants & Food > Bakeries", "Restaurants & Food > Bars, Pubs & Taverns", "Restaurants & Food > Boba Tea & Dessert Shop", "Restaurants & Food > Breweries", "Restaurants & Food > Chinese Restaurants", "Restaurants & Food > Coffee Shops & Cafes", "Restaurants & Food > Delis & Sandwich Shops", "Restaurants & Food > Diners", "Restaurants & Food > Distilleries", "Restaurants & Food > Donut Shops", "Restaurants & Food > Food Trucks", "Restaurants & Food > Ice Cream & Frozen Yogurt Shops", "Restaurants & Food > Indian Restaurants", "Restaurants & Food > Italian Restaurants", "Restaurants & Food > Juice Bars", "Restaurants & Food > Korean Restaurants", "Restaurants & Food > Mediterranean Restaurants", "Restaurants & Food > Mexican Restaurants", "Restaurants & Food > Miscellaneous Restaurant & Bars", "Restaurants & Food > Pizza Restaurants", "Restaurants & Food > Quick Service Restaurants", "Restaurants & Food > Sushi & Japanese Restaurants", "Restaurants & Food > Thai Restaurants", "Restaurants & Food > Vietnamese Restaurants", "Restaurants & Food > Other Restaurants & Food", "Retail", "Retail > Beauty Supply Stores", "Retail > Bike Shops", "Retail > Clothing & Accessory Stores", "Retail > Convenience Stores", "Retail > Dollar Stores", "Retail > Flower Shops", "Retail > Furniture & Furnishings Stores", "Retail > Grocery Stores & Supermarkets", "Retail > Health Food & Nutrition", "Retail > Jewelry Stores", "Retail > Liquor Stores", "Retail > Nursery & Garden Centers", "Retail > Pawn Shops", "Retail > Pharmacies", "Retail > Smoke Shops", "Retail > Sporting Goods Store", "Retail > Vending Machines", "Retail > Other Retail", "Service Businesses", "Service Businesses > Architecture & Engineering Firms", "Service Businesses > Catering Companies", "Service Businesses > Cleaning Businesses", "Service Businesses > Commercial Laundry", "Service Businesses > Dry Cleaners", "Service Businesses > Funeral Homes", "Service Businesses > Landscaping & Yard Services", "Service Businesses > Laundromats & Coin Laundry", "Service Businesses > Legal Services & Law Firms", "Service Businesses > Locksmith", "Service Businesses > Marketing & Advertising", "Service Businesses > Medical Billing", "Service Businesses > Mobile Home Parks", "Service Businesses > Pest Control", "Service Businesses > Property Management", "Service Businesses > Restoration & Remediation", "Service Businesses > Routes", "Service Businesses > Security", "Service Businesses > Staffing Agencies", "Service Businesses > Swimming Pool Businesses", "Service Businesses > Waste Management & Recycling", "Service Businesses > Other Service Businesses", "Transportation & Storage", "Transportation & Storage > Limo & Passenger Transportation", "Transportation & Storage > Moving & Shipping", "Transportation & Storage > Storage Facilities & Warehouses", "Transportation & Storage > Trucking Companies", "Transportation & Storage > Other Transportation & Storage", "Travel", "Travel > Bed & Breakfasts", "Travel > Campgrounds & RV Parks", "Travel > Hotels", "Travel > Motels", "Travel > Travel Agencies", "Travel > Other Travel", "Wholesale & Distributors", "Wholesale & Distributors > Durable Goods", "Wholesale & Distributors > Nondurable Goods", "Wholesale & Distributors > Other Wholesalers & Distributors" ] } }, "grossRevenueMin": { "title": "Gross Revenue Min", "minimum": 0, "type": "integer", "description": "Minimum gross revenue (USD)" }, "grossRevenueMax": { "title": "Gross Revenue Max", "minimum": 0, "type": "integer", "description": "Maximum gross revenue (USD)" }, "cashFlowMin": { "title": "Cash Flow / EBITDA Min", "minimum": 0, "type": "integer", "description": "Minimum cash flow / EBITDA (USD)" }, "cashFlowMax": { "title": "Cash Flow / EBITDA Max", "minimum": 0, "type": "integer", "description": "Maximum cash flow / EBITDA (USD)" }, "askingPriceMin": { "title": "Asking Price Min", "minimum": 0, "type": "integer", "description": "Minimum asking price (USD)" }, "askingPriceMax": { "title": "Asking Price Max", "minimum": 0, "type": "integer", "description": "Maximum asking price (USD)" }, "realEstateMin": { "title": "Real Estate Value Min", "minimum": 0, "type": "integer", "description": "Minimum real estate value (USD)" }, "realEstateMax": { "title": "Real Estate Value Max", "minimum": 0, "type": "integer", "description": "Maximum real estate value (USD)" }, "daysListedAgo": { "title": "Date Added (Days Listed Ago)", "minimum": 0, "type": "integer", "description": "Only include listings added within this many days (e.g. 7, 30, 90)" }, "establishedAfterYear": { "title": "Established After Year", "minimum": 1800, "maximum": 2100, "type": "integer", "description": "Only include businesses established after this year (e.g. 2010)" }, "keyword": { "title": "Keyword", "type": "string", "description": "Keyword phrase to match in listings (e.g. \"franchise\", \"laundromat\", \"car wash\")" }, "listingIds": { "title": "Listing IDs", "type": "array", "description": "Specific BizBuySell listing IDs (list numbers) to fetch", "items": { "type": "string" } }, "hideListingsWithoutPrice": { "title": "Hide Listings Without Price", "type": "boolean", "description": "Exclude listings that do not show an asking price", "default": false }, "hideHomeBasedBusinesses": { "title": "Hide Home-Based Businesses", "type": "boolean", "description": "Exclude home-based business listings", "default": false }, "includeRelocatableListings": { "title": "Include Relocatable Listings", "type": "boolean", "description": "Include listings marked as relocatable", "default": false }, "mustHaveSellerFinancing": { "title": "Must Have Seller Financing", "type": "boolean", "description": "Only listings that offer seller financing", "default": false }, "mustHaveRealEstateIncluded": { "title": "Must Have Real Estate Included", "type": "boolean", "description": "Only listings where real estate is included in the asking price", "default": false }, "mustAllowAbsenteeOwner": { "title": "Must Allow Absentee Owner", "type": "boolean", "description": "Only listings that allow an absentee owner", "default": false }, "scrapeListingDetails": { "title": "Scrape Listing Details", "type": "boolean", "description": "When enabled, visit each listing page for full details (description, financials, employees, lease, broker phone, etc.). Charges the listing-details event in addition to dataset-item.", "default": false }, "maxItems": { "title": "Max Items", "minimum": 0, "type": "integer", "description": "Maximum number of listings to scrape (0 = unlimited)", "default": 0 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for anti-bot protection. BizBuySell requires Apify Residential proxies with country US.", "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 } } } } } } } } } }