{ "openapi": "3.0.1", "info": { "title": "BizBuySell Scraper | $1 / 1k | Fast & Reliable", "description": "Scrape BizBuySell into structured business-for-sale listings. Get asking price, cash flow, revenue, location, category, descriptions and contact details. Ideal for deal sourcing, valuation comps, market sizing, and tracking new listings.", "version": "1.1", "x-build-id": "36tXNRfim8pe0jdvm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~bizbuysell-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-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/fatihtahta~bizbuysell-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-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/fatihtahta~bizbuysell-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-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": "πŸ”— Enter Search Page URLs you want to get the results from", "type": "array", "description": "Paste one or more BizBuySell URLs to scrape directly. You can mix search result pages, category pages, and individual listing pages in the same run. Use this when you already have specific pages to collect.", "items": { "type": "string" } }, "useQueryBuilder": { "title": "Enable the query builder", "type": "boolean", "description": "Turn this on to build BizBuySell search URLs from state, area, keywords, and filters. Leave it off if you only want to scrape the Start URLs above.", "default": false }, "state": { "title": "πŸ‡ΊπŸ‡Έ Filter by state (optional, e.g., California)", "type": "string", "description": "US state name or slug to focus the search. Provide this when using the query builder. Example: \"california\" or \"new-york\"." }, "area": { "title": "⛳️ Filter by area or city (optional, e.g., New York City Metro Area)", "type": "string", "description": "City or metro area within the selected state. Use this only when you also provide a state. Example: \"los-angeles\" or \"new-york-city\"." }, "minCashflow": { "title": "πŸ’΅ Minimum cash flow (e.g., 100000)", "minimum": 0, "type": "integer", "description": "Only include listings with annual cash flow at or above this amount. Leave empty to skip this filter." }, "maxCashflow": { "title": "πŸ’΅ Maximum cash flow (e.g., 500000)", "minimum": 0, "type": "integer", "description": "Only include listings with annual cash flow at or below this amount. Leave empty to skip this filter." }, "minGrossIncome": { "title": "πŸ“ˆ Minimum gross income (e.g., 250000)", "minimum": 0, "type": "integer", "description": "Only include listings with gross income/revenue at or above this amount. Leave empty to skip this filter." }, "maxGrossIncome": { "title": "πŸ“ˆ Maximum gross income (e.g., 2000000)", "minimum": 0, "type": "integer", "description": "Only include listings with gross income/revenue at or below this amount. Leave empty to skip this filter." }, "minAskingPrice": { "title": "🏷️ Minimum asking price (e.g., 250000)", "minimum": 0, "type": "integer", "description": "Only include listings with an asking price at or above this amount. Leave empty to skip this filter." }, "maxAskingPrice": { "title": "🏷️ Maximum asking price (e.g., 2000000)", "minimum": 0, "type": "integer", "description": "Only include listings with an asking price at or below this amount. Leave empty to skip this filter." }, "establishmentDate": { "title": "πŸ—“οΈ Established after (e.g., 2010)", "minimum": 0, "type": "integer", "description": "Only include listings for businesses established after this year (e.g., 2010). Leave empty to skip this filter." }, "industryIds": { "title": "🏭 Industries (e.g., Restaurants & Food)", "uniqueItems": true, "type": "array", "description": "Select one or more BizBuySell industry categories to narrow the search. Leave empty to include all industries.", "items": { "type": "string", "enum": [ "88", "136", "141", "81", "89", "27", "22", "118", "31", "57", "92", "115", "188", "17", "1", "20", "30", "206", "78" ], "enumTitles": [ "🌾 Agriculture", "πŸš— Automotive & Boat", "πŸ’… Beauty & Personal Care", "πŸ—οΈ Building & Construction", "πŸ“‘ Communication & Media", "πŸŽ“ Education & Children", "🎯 Entertainment & Recreation", "πŸ’Ό Financial Services", "πŸ₯ Health Care & Fitness", "🏭 Manufacturing", "🧩 Non-Classifiable Establishments", "πŸ’» Online & Technology", "🐾 Pet Services", "🍽️ Restaurants & Food", "πŸ›οΈ Retail", "πŸ› οΈ Service Businesses", "🚚 Transportation & Storage", "✈️ Travel", "πŸ“¦ Wholesale & Distributors" ] } }, "queries": { "title": "πŸ” Search keywords (e.g., \"car wash\")", "type": "array", "description": "Enter one or more keywords to search on BizBuySell (business type, industry, or location). Use this with the query builder to discover listings without supplying URLs.", "items": { "type": "string" } }, "limit": { "title": "πŸ“¦ Maximum listings to save per query (e.g., 500)", "minimum": 10, "type": "integer", "description": "Stop after this many listings have been saved for each query or URL set. Use a smaller number for quick samples or a larger number for deeper coverage.", "default": 50000 }, "proxyConfiguration": { "title": "πŸ›‘οΈ Proxy configuration (recommended for stability)", "type": "object", "description": "Optional proxy settings to improve reliability on larger runs or during busy periods. The default works for most users; change this only if you run at scale or see inconsistent results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }