{ "openapi": "3.0.1", "info": { "title": "BizBuySell Businesses-for-Sale & Financials Scraper", "description": "Search BizBuySell business-for-sale listings by keyword, state, city, county, industry, price, cash flow, revenue and listing type. Get financials, broker contacts, images, detail status and incremental monitoring fields.", "version": "1.0", "x-build-id": "wEIFBh05Vywiqqs7t" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nimbryxo-studio~bizbuysell-businesses-for-sale-and-financials/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nimbryxo-studio-bizbuysell-businesses-for-sale-and-financials", "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/nimbryxo-studio~bizbuysell-businesses-for-sale-and-financials/runs": { "post": { "operationId": "runs-sync-nimbryxo-studio-bizbuysell-businesses-for-sale-and-financials", "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/nimbryxo-studio~bizbuysell-businesses-for-sale-and-financials/run-sync": { "post": { "operationId": "run-sync-nimbryxo-studio-bizbuysell-businesses-for-sale-and-financials", "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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byUrls", "byListingIds" ], "type": "string", "description": "What to scrape. Search runs a filtered marketplace query; byUrls accepts BizBuySell search or listing URLs; byListingIds looks up exact listing IDs.", "default": "search" }, "searchQuery": { "title": "Keyword", "type": "string", "description": "Free-text keyword, e.g. laundromat, restaurant, HVAC, car wash. Leave blank to browse all listings. (mode=search)" }, "state": { "title": "State", "enum": [ "ALL", "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" ], "type": "string", "description": "US state filter. Choose All states to search nationwide. (mode=search)", "default": "ALL" }, "city": { "title": "City", "type": "string", "description": "Optional city filter, e.g. Austin or Los Angeles. Resolved against BizBuySell locations. (mode=search)", "default": "" }, "county": { "title": "County", "type": "string", "description": "Optional county filter, e.g. Los Angeles County. Resolved against BizBuySell locations. (mode=search)", "default": "" }, "category": { "title": "Industry / category", "enum": [ "ALL", "88", "134", "132", "133", "135", "136", "23", "3", "108", "119", "8", "137", "12", "226", "138", "139", "140", "141", "24", "142", "143", "144", "145", "232", "146", "81", "5", "217", "147", "90", "83", "123", "231", "222", "148", "224", "149", "93", "103", "97", "102", "95", "96", "98", "106", "105", "107", "104", "99", "101", "89", "150", "151", "152", "27", "109", "153", "154", "228", "155", "22", "40", "156", "157", "158", "159", "160", "161", "162", "118", "28", "29", "211", "116", "183", "31", "113", "218", "179", "180", "112", "181", "182", "221", "234", "223", "191", "57", "77", "59", "58", "60", "70", "62", "63", "74", "64", "66", "184", "185", "61", "91", "121", "69", "73", "186", "68", "92", "213", "115", "25", "131", "56", "55", "52", "209", "188", "189", "45", "16", "227", "210", "17", "214", "163", "4", "229", "164", "165", "166", "167", "168", "219", "169", "128", "171", "172", "173", "174", "235", "238", "175", "215", "176", "237", "177", "178", "236", "14", "1", "216", "192", "2", "6", "193", "7", "10", "18", "194", "195", "11", "111", "196", "114", "197", "233", "19", "13", "20", "198", "126", "110", "122", "26", "127", "33", "199", "34", "124", "220", "200", "201", "202", "203", "230", "129", "125", "120", "225", "117", "41", "30", "44", "204", "47", "205", "43", "206", "207", "130", "32", "208", "48", "187", "78", "79", "80", "212" ], "type": "string", "description": "BizBuySell industry category. Choose All categories to search every industry. (mode=search)", "default": "ALL" }, "listingType": { "title": "Listing type", "enum": [ "all", "established", "assetSale", "realEstate", "startup" ], "type": "string", "description": "Established businesses, business assets, business real estate, or startup listings. (mode=search)", "default": "all" }, "minAskingPrice": { "title": "Minimum asking price (USD)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Only listings at or above this asking price. Leave blank for no minimum." }, "maxAskingPrice": { "title": "Maximum asking price (USD)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Only listings at or below this asking price. Leave blank for no maximum." }, "minCashFlow": { "title": "Minimum cash flow / SDE (USD)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Only listings at or above this annual cash flow (SDE). Leave blank for no minimum." }, "maxCashFlow": { "title": "Maximum cash flow / SDE (USD)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Only listings at or below this annual cash flow (SDE). Leave blank for no maximum." }, "minGrossRevenue": { "title": "Minimum gross revenue (USD)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Only listings at or above this annual gross revenue. Leave blank for no minimum." }, "maxGrossRevenue": { "title": "Maximum gross revenue (USD)", "minimum": 0, "maximum": 10000000000, "type": "integer", "description": "Only listings at or below this annual gross revenue. Leave blank for no maximum." }, "establishedAfterYear": { "title": "Established after year", "minimum": 1800, "maximum": 2100, "type": "integer", "description": "Only businesses established after this year, e.g. 2015. Leave blank for any year." }, "listedWithinDays": { "title": "Listed within days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only listings added or refreshed within this many days. 0 means any age.", "default": 0 }, "sortBy": { "title": "Sort by", "enum": [ "default", "priceAsc", "priceDesc", "cashFlowDesc", "newest" ], "type": "string", "description": "Result ordering. Relevance is the marketplace default.", "default": "default" }, "sellerFinancing": { "title": "Seller financing only", "type": "boolean", "description": "Only listings that offer seller financing.", "default": false }, "homeBased": { "title": "Home-based only", "type": "boolean", "description": "Only home-based businesses.", "default": false }, "realEstateIncluded": { "title": "Real estate included only", "type": "boolean", "description": "Only listings where real estate is included in the asking price.", "default": false }, "absenteeOwner": { "title": "Absentee-owner only", "type": "boolean", "description": "Only listings that allow an absentee owner.", "default": false }, "priceReduced": { "title": "Price reduced only", "type": "boolean", "description": "Only listings with a reduced asking price.", "default": false }, "franchiseResale": { "title": "Franchise resales only", "type": "boolean", "description": "Only franchise resale listings.", "default": false }, "strictFilters": { "title": "Strict gross-revenue filtering", "type": "boolean", "description": "When a gross-revenue filter is set, trust BizBuySell's source-side filter when detail revenue is unavailable; when enrichDetails successfully reads a detail page, drop records whose detail revenue is still unknown. Default false.", "default": false }, "enrichDetails": { "title": "Fetch full detail pages", "type": "boolean", "description": "Adds full description, gross revenue, employees, established year, inventory, FF&E, rent, facilities, financing and broker phone. Adds one request per listing and is slower.", "default": false }, "mirrorImages": { "title": "Mirror images to Apify storage", "type": "boolean", "description": "Store listing photos in this run's key-value store and return public Apify URLs. On by default so images open from any client; turn off to keep the source URLs.", "default": true }, "startUrls": { "title": "BizBuySell URLs", "type": "array", "description": "BizBuySell search, category, state, city, county or listing URLs. (mode=byUrls)", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "BizBuySell search or listing URL." } } }, "default": [] }, "listingIds": { "title": "Listing IDs", "type": "array", "description": "Numeric BizBuySell listing IDs, e.g. 2501583. (mode=byListingIds)", "items": { "type": "string" }, "default": [] }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Hard cap on the number of listings to save.", "default": 50 }, "stateKey": { "title": "Monitoring state key", "type": "string", "description": "Optional. Set the same key on scheduled runs to remember previously seen listings in a named key-value store. Leave empty for stateless scraping." }, "onlyNew": { "title": "Only new listings", "type": "boolean", "description": "With stateKey, emit only listing IDs that were never seen in a previous run. New/changed records are emitted by default when stateKey is set.", "default": false }, "emitUnchanged": { "title": "Also emit unchanged listings", "type": "boolean", "description": "With stateKey, also emit listings whose tracked fields did not change. Leave off to receive only new or changed listings.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration (optional)", "type": "object", "description": "Optional override for advanced users. Leave empty to let the actor connect directly and choose its own fallback route; search works without any proxy setup." } } }, "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 } } } } } } } } } }