{ "openapi": "3.0.1", "info": { "title": "BizBuySell Scraper — Business Listings & Financials", "description": "Scrape BizBuySell business-for-sale listings: asking price, cash flow, revenue, location, industry, and broker contact. Camoufox + residential proxies clear Akamai. MCP-ready.", "version": "1.0", "x-build-id": "63IefjVWaHsP5WSqh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~bizbuysell-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-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/khadinakbar~bizbuysell-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-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/khadinakbar~bizbuysell-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-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": "BizBuySell URLs", "type": "array", "description": "Paste any BizBuySell search, category, state, or single-listing URLs. Example: 'https://www.bizbuysell.com/california/restaurants-and-food-businesses-for-sale/' or a listing like 'https://www.bizbuysell.com/business-opportunity//2348441/'. Search/category URLs are paginated automatically; listing URLs are scraped directly. NOT for franchise-directory URLs — this actor targets businesses for sale.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "searchKeyword": { "title": "Industry / keyword", "type": "string", "description": "Convenience filter that builds a BizBuySell category URL when you don't paste a startUrl. Must match a real BizBuySell industry category, e.g. 'restaurants and food', 'automotive and boat', 'health care and fitness', 'beauty and personal care', 'manufacturing'. Defaults to empty (all industries). NOT a free-text search — an unknown category yields no results; for anything else paste a category URL into BizBuySell URLs instead." }, "searchLocation": { "title": "Location (US state or metro)", "type": "string", "description": "Convenience filter that builds a BizBuySell location URL when you don't paste a startUrl. Use a US state or metro, e.g. 'california', 'texas', 'new-york'. Combined with the keyword when both are set. Defaults to empty (nationwide). NOT a ZIP code or full address." }, "maxItems": { "title": "Max listings", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of listings to scrape and bill across the whole run. One charge fires per delivered listing. Default 100, minimum 1. Each search page returns up to 50 listings. Keep this low on first runs to preview cost.", "default": 100 }, "dedupeGlobally": { "title": "De-duplicate across pages", "type": "boolean", "description": "When true (default), the same listing id is never returned twice across paginated results or overlapping start URLs. Set false only if you want raw per-page output including duplicates.", "default": true }, "maxPagesPerSearch": { "title": "Max pages per search URL", "minimum": 1, "maximum": 200, "type": "integer", "description": "Safety cap on how many result pages to paginate through per search/category URL (BizBuySell shows up to ~200 pages). Default 20. The run still stops at 'Max listings' first. Lower it to bound cost on broad searches.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Your own Apify proxy, used (and billed to your account) for the Apify half of the IP rotation. Defaults to Apify Residential (US), which is required to clear BizBuySell's Akamai protection — datacenter proxies are blocked, do not switch to them. The Actor also rotates through its own bundled residential pool alongside your proxy for higher reliability.", "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 } } } } } } } } } }