{ "openapi": "3.0.1", "info": { "title": "BizBuySell Businesses for Sale Scraper", "description": "Scrape businesses for sale from BizBuySell. Filter by state, industry, asking price, cash flow and revenue, and get listings with financials, location, broker and detail URL.", "version": "0.1", "x-build-id": "0g6PxBV6qozCkmYaJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datacach~bizbuysell-businesses-for-sale-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datacach-bizbuysell-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/datacach~bizbuysell-businesses-for-sale-scraper/runs": { "post": { "operationId": "runs-sync-datacach-bizbuysell-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/datacach~bizbuysell-businesses-for-sale-scraper/run-sync": { "post": { "operationId": "run-sync-datacach-bizbuysell-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": { "keyword": { "title": "Keyword", "type": "string", "description": "Free-text search across listing titles and descriptions. For example pizza, car wash or franchise. Leave empty to search all listings." }, "states": { "title": "States", "type": "array", "description": "US states to search, for example California and Texas. Leave empty to search the whole country. Selecting fewer states makes the run faster and cheaper.", "items": { "type": "string", "enum": [ "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY" ], "enumTitles": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "District of Columbia", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming" ] }, "default": [] }, "industries": { "title": "Industries", "type": "array", "description": "Top-level BizBuySell industries, for example Restaurants & Food or Retail. Leave empty to include every industry. Subcategories are included automatically when you pick a parent industry.", "items": { "type": "string", "enum": [ "Agriculture", "Automotive & Boat", "Beauty & Personal Care", "Building & Construction", "CLASSIFIEDS", "Communication & Media", "Education & Children", "Entertainment & Recreation", "Financial Services", "Health Care & Fitness", "Manufacturing", "Non-Classifiable Establishments", "Online & Technology", "Pet Services", "Real Estate", "Restaurants & Food", "Retail", "Service Businesses", "Transportation & Storage", "Travel", "Wholesale & Distributors" ], "enumTitles": [ "Agriculture", "Automotive & Boat", "Beauty & Personal Care", "Building & Construction", "CLASSIFIEDS", "Communication & Media", "Education & Children", "Entertainment & Recreation", "Financial Services", "Health Care & Fitness", "Manufacturing", "Non-Classifiable Establishments", "Online & Technology", "Pet Services", "Real Estate", "Restaurants & Food", "Retail", "Service Businesses", "Transportation & Storage", "Travel", "Wholesale & Distributors" ] }, "default": [] }, "listingTypes": { "title": "Listing types", "type": "array", "description": "Which kinds of listing to include. Established businesses are running operations; asset sales are equipment or inventory only; real estate is property; start-ups are pre-revenue. Leave empty to include all four.", "items": { "type": "string", "enum": [ "established", "assetSale", "realEstate", "startup" ], "enumTitles": [ "Established businesses", "Asset sales", "Real estate", "Start-ups" ] }, "default": [] }, "askingPriceMin": { "title": "Minimum asking price", "minimum": 0, "type": "integer", "description": "Lowest asking price to include, in US dollars. Set to 0 for no lower bound. Listings that do not publish a price are still included unless you turn on the price filter below.", "default": 0 }, "askingPriceMax": { "title": "Maximum asking price", "minimum": 0, "type": "integer", "description": "Highest asking price to include, in US dollars. Set to 0 for no upper bound.", "default": 0 }, "cashFlowMin": { "title": "Minimum cash flow", "minimum": 0, "type": "integer", "description": "Lowest annual cash flow (seller discretionary earnings) to include, in US dollars. Set to 0 for no lower bound.", "default": 0 }, "cashFlowMax": { "title": "Maximum cash flow", "minimum": 0, "type": "integer", "description": "Highest annual cash flow to include, in US dollars. Set to 0 for no upper bound.", "default": 0 }, "grossRevenueMin": { "title": "Minimum gross revenue", "minimum": 0, "type": "integer", "description": "Lowest annual gross revenue to include, in US dollars. Set to 0 for no lower bound.", "default": 0 }, "grossRevenueMax": { "title": "Maximum gross revenue", "minimum": 0, "type": "integer", "description": "Highest annual gross revenue to include, in US dollars. Set to 0 for no upper bound.", "default": 0 }, "establishedAfterYear": { "title": "Established after year", "minimum": 1800, "maximum": 2100, "type": "integer", "description": "Only businesses founded in or after this year, for example 2010. Leave empty to include businesses of any age." }, "daysListedAgo": { "title": "Date added", "enum": [ "0", "3", "7", "30" ], "type": "string", "description": "How recently the listing was published on BizBuySell. Use this to poll for new listings on a schedule without re-collecting old ones.", "default": "0" }, "realEstateListing": { "title": "Real estate listings", "enum": [ "all", "forSale", "forLease" ], "type": "string", "description": "Whether to include property listed for sale, for lease, or both. \"Show all\" includes every listing regardless of property arrangement.", "default": "all" }, "hideListingsWithoutPrice": { "title": "Listings with a published price only", "type": "boolean", "description": "When on, listings whose asking price is not disclosed are excluded. When off (the default), they are included with an empty price field — BizBuySell withholds the price on a large share of listings.", "default": false }, "hideHomeBased": { "title": "Businesses with a commercial location only", "type": "boolean", "description": "When on, businesses run from the owner's home are excluded. When off (the default), home-based businesses are included.", "default": false }, "includeRelocatable": { "title": "Include relocatable businesses", "type": "boolean", "description": "When on, businesses that can be moved to another location are added to the results even if they sit outside the states you selected. When off (the default), only businesses tied to their listed location appear.", "default": false }, "mustHaveSellerFinancing": { "title": "Seller financing offered", "type": "boolean", "description": "When on, only listings where the seller finances part of the purchase price are returned. When off (the default), financing is not considered.", "default": false }, "mustHaveRealEstate": { "title": "Real estate included in the price", "type": "boolean", "description": "When on, only listings whose asking price includes the property are returned. When off (the default), leased-premises businesses are included too.", "default": false }, "mustAllowAbsenteeOwner": { "title": "Absentee ownership possible", "type": "boolean", "description": "When on, only businesses that can run without the owner on site are returned — useful for passive-income buyers. When off (the default), all are included.", "default": false }, "sortBy": { "title": "Sort results by", "enum": [ "featured", "priceAsc", "priceDesc", "cashFlowAsc", "cashFlowDesc" ], "type": "string", "description": "Order in which BizBuySell returns the listings. This matters when you set a result limit: with \"Price: high to low\" and a limit of 100, you get the 100 most expensive businesses rather than an arbitrary 100.", "default": "featured" }, "maxResults": { "title": "Maximum results", "minimum": 0, "type": "integer", "description": "Stop after this many businesses. Set to 0 to collect everything that matches your filters. You are charged per result, so start small to preview the data and raise the limit once the output looks right. Free plan is capped at 25 results, including when this is set to 0.", "default": 100 }, "excludeUrls": { "title": "Exclude already collected", "type": "array", "description": "Businesses you already have. Anything listed here is never saved again, no matter where it appears in the results — so you only pay for what is new. Paste the url values from a previous run's dataset (the listingNumber works too).

This does not make the run faster: the Actor still has to crawl past those listings to find the new ones. It only changes what gets saved and billed. Ignored on the free plan.", "default": [], "items": { "type": "string" } }, "concurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many requests run at the same time. Higher values finish sooner but are more likely to trip BizBuySell's bot protection, which forces retries and can end up slower overall. Leave at the default unless a run is timing out.", "default": 4 } } }, "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 } } } } } } } } } }