# BizQuest Data Extractor (`kawsar/bizquest-data-extractor`) Actor BizQuest scraper that pulls listing titles, asking prices, locations, and cash flow from search results, so you can track the business-for-sale market without clicking through pages manually. - **URL**: https://apify.com/kawsar/bizquest-data-extractor.md - **Developed by:** [Kawsar](https://apify.com/kawsar) (community) - **Categories:** Automation, Developer tools, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.99 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## BizQuest Data Extractor Scrapes businesses-for-sale listings from BizQuest.com. Pick a category, a state, or paste any search URL and it pages through every result automatically. Each record comes back as clean JSON with the listing title, asking price, cash flow, location, description, financing flag, and image URL. ### What you get Every result includes: | Field | Type | Notes | |---|---|---| | `listingId` | string | Unique BizQuest listing ID | | `listingTitle` | string | Business name or title | | `listingUrl` | string | Direct URL to the listing detail page | | `askingPrice` | string | Price as displayed (e.g. `$310,000`) | | `askingPriceValue` | integer | Parsed price as a number (null if not disclosed) | | `cashFlow` | string | Cash flow text from the listing card | | `location` | string | Full location string | | `city` | string | City name | | `stateCode` | string | Two-letter state code | | `listingDescription` | string | Short teaser description | | `financingAvailable` | boolean | Whether seller financing is offered | | `imageUrl` | string | First listing image URL. Direct CDN URL by default (see note below); publicly accessible KV URL when Fetch images is enabled. | | `scrapedAt` | string | ISO 8601 timestamp | ### How to use #### Option 1: Category + state (easiest) Pick a category from the dropdown and a state. The actor builds the URL and pages through all results. Examples: - Category: **Restaurants**, State: **Texas** → scrapes Texas restaurants for sale - Category: **Health & Medical**, State: **California** → California medical businesses - Category: **Franchise** (no state) → all franchise listings nationwide #### Option 2: Paste a search URL Open BizQuest.com, apply any filters you want (price range, listing type, keyword), then copy the URL and paste it into **Search URLs**. The actor pages through every result from that search. Example URLs that work: ```` https://www.bizquest.com/businesses-for-sale/ https://www.bizquest.com/restaurants-for-sale-in-texas-tx/ https://www.bizquest.com/businesses-for-sale/?q=bHQ9MzAsNDAsODA= https://www.bizquest.com/food-and-beverage-businesses-for-sale-in-california-ca/ ```` #### Option 3: Keywords Fill in the Keywords field (e.g. `laundromat`, `auto body shop`) to search across all categories. Combine with Category or State for narrower results. ### Input fields | Field | Type | Default | Description | |---|---|---|---| | Search URLs | array | — | One or more BizQuest search URLs. Overrides all other filters. | | Category | select | All categories | Industry or business type dropdown (59 options). | | State | select | All states | US state dropdown (50 states + DC). | | Keywords | string | — | Free-text search terms. | | Min asking price | integer | — | Filter out listings below this price (USD). | | Max asking price | integer | — | Filter out listings above this price (USD). | | Fetch images | boolean | false | Download each listing image and store it in the Key-Value Store so the URL opens directly in any browser. Slower and uses more compute units. | | Max items | integer | 50 | How many listings to collect, up to 1,000. | | Request timeout | integer | 30 | Per-request timeout in seconds (5–120). | ### Available categories The Category dropdown includes 59 options covering all major industries: **Auto & Automotive** — Auto Body & Repair, Auto Dealers, Car Washes, Gas Stations **Food & Beverage** — Restaurants, Bars & Taverns, Catering, Grocery, Liquor Stores, Vending **Health & Medical** — Dental Practices, Gyms & Fitness, Medical Practices, Medical Clinics, Pharmacies **Retail Stores** — Convenience Stores, Franchise, Pet Stores **Internet Related** — E-Commerce & E-Tailers, Established Websites **Professional Service** — Consulting, Legal & Accounting, Real Estate Brokers **Personal Product & Service** — Coin Laundry, Dry-Cleaning **Manufacturing** — Full manufacturing sector **Transportation** — Shipping, Taxi & Limousine **Hair & Beauty** — Beauty Salons & Barber Shops **Educational** — Day Care, Schools **Financial** — Insurance Agents, Brokerage **Entertainment & Leisure** — Hotels & Motels **Technology** — Software & Internet Developers **Wholesale & Distribution** ...and more ### Sample output ```json { "listingId": "2479621", "listingTitle": "Dry Cleaner Business", "listingUrl": "https://www.bizquest.com/business-for-sale/dry-cleaner-business/BW2479621/", "askingPrice": "$310,000", "askingPriceValue": 310000, "cashFlow": "Cash Flow: Sign In to View", "location": "Chicago , IL", "city": "Chicago", "stateCode": "IL", "listingDescription": "Selling a well-established Dry Cleaning business", "financingAvailable": false, "imageUrl": "https://images.bizquest.com/shared/listings/247/2479621/823aab19-86a7-4b52-b0a6-1aeb65a4f7c7-W336.webp", "scrapedAt": "2026-05-14T10:23:45.123456+00:00" } ```` ### Common uses - **Market research** — track asking prices for a business type in a specific region over time - **Lead generation** — build a list of businesses for sale for brokers, investors, or buyers - **Competitive analysis** — compare pricing and availability across industries - **Business valuation** — benchmark a specific business against similar listings - **CRM enrichment** — feed listing data directly into a spreadsheet or CRM - **Investment screening** — filter by price range to find listings within a budget ### Things to know **Listings per page**: BizQuest shows 30–56 listings per page depending on the search. The actor handles pagination automatically. **Cash flow visibility**: Many listings hide cash flow behind a BizQuest account login. The scraper captures whatever text appears on the listing card — you may see `Cash Flow: Sign In to View` in that field. **Price filter**: Min/Max asking price filtering is applied after fetching each page. Listings without a parseable price are always included. **Combining filters**: Category + State build a direct BizQuest URL (e.g. `restaurants-for-sale-in-texas-tx`). For price ranges or advanced listing-type filters, apply them on BizQuest.com first, then paste the resulting URL into Search URLs. **Image URLs**: BizQuest's image CDN (Akamai) blocks direct browser requests, so the raw `imageUrl` value returns "Access Denied" if you open it in a browser tab. Enable **Fetch images** to have the actor download each image at scrape time and save it to the Apify Key-Value Store. The `imageUrl` field will then contain a public KV link that opens in any browser. Leave it off if you only need the image URL for programmatic access via a bypass service. **Pagination limit**: BizQuest has up to 200 pages per search. Use Max items to keep runs predictable. **Duplicate prevention**: The actor tracks listing IDs across pages and skips any it has already collected. # Actor input Schema ## `searchUrls` (type: `array`): One or more BizQuest search URLs to scrape. Paste any URL from BizQuest.com — the actor pages through all results. When provided, Category, State, and Keywords are ignored. ## `category` (type: `string`): Filter by industry or business category. Select a category to scrape all matching listings. Combine with State to narrow the search further. ## `state` (type: `string`): Filter listings by US state. Works on its own or combined with Category. ## `keywords` (type: `string`): Search keyword(s) to filter listings (e.g. 'laundromat', 'auto shop', 'franchise coffee'). Used when no Search URLs are provided. ## `minPrice` (type: `integer`): Minimum asking price filter in US dollars (e.g. 50000 for $50,000). ## `maxPrice` (type: `integer`): Maximum asking price filter in US dollars (e.g. 500000 for $500,000). ## `fetchImages` (type: `boolean`): Download each listing's first image and save it to the Key-Value Store so the URL works without any special headers. Increases run time and compute units. Off by default. ## `maxItems` (type: `integer`): Maximum number of listings to collect per run. ## `requestTimeoutSecs` (type: `integer`): Per-request timeout in seconds. ## Actor input object example ```json { "searchUrls": [ "https://www.bizquest.com/businesses-for-sale/", "https://www.bizquest.com/restaurants-for-sale-in-texas-tx/" ], "keywords": "restaurant", "minPrice": 50000, "maxPrice": 500000, "fetchImages": false, "maxItems": 50, "requestTimeoutSecs": 30 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchUrls": [ "https://www.bizquest.com/businesses-for-sale/" ], "keywords": "" }; // Run the Actor and wait for it to finish const run = await client.actor("kawsar/bizquest-data-extractor").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchUrls": ["https://www.bizquest.com/businesses-for-sale/"], "keywords": "", } # Run the Actor and wait for it to finish run = client.actor("kawsar/bizquest-data-extractor").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchUrls": [ "https://www.bizquest.com/businesses-for-sale/" ], "keywords": "" }' | apify call kawsar/bizquest-data-extractor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kawsar/bizquest-data-extractor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "BizQuest Data Extractor", "description": "BizQuest scraper that pulls listing titles, asking prices, locations, and cash flow from search results, so you can track the business-for-sale market without clicking through pages manually.", "version": "0.0", "x-build-id": "vCLLSR7zwsg6CHgNv" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kawsar~bizquest-data-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kawsar-bizquest-data-extractor", "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/kawsar~bizquest-data-extractor/runs": { "post": { "operationId": "runs-sync-kawsar-bizquest-data-extractor", "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/kawsar~bizquest-data-extractor/run-sync": { "post": { "operationId": "run-sync-kawsar-bizquest-data-extractor", "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": { "searchUrls": { "title": "Search URLs", "type": "array", "description": "One or more BizQuest search URLs to scrape. Paste any URL from BizQuest.com — the actor pages through all results. When provided, Category, State, and Keywords are ignored.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "", "auto-and-automotive-businesses-for-sale", "auto-body-and-repair-businesses-for-sale", "auto-dealers-for-sale", "car-washes-for-sale", "gas-stations-for-sale", "building-and-construction-services-businesses-for-sale", "business-services-businesses-for-sale", "commercial-cleaning-and-janitorial-businesses-for-sale", "staffing-businesses-for-sale", "clothing-and-fashion-businesses-for-sale", "communication-and-media-businesses-for-sale", "educational-businesses-for-sale", "day-care-and-child-care-centers-for-sale", "schools-for-sale", "entertainment-and-leisure-businesses-for-sale", "hotels-and-motels-for-sale", "financial-businesses-for-sale", "insurance-agents-businesses-for-sale", "food-and-beverage-businesses-for-sale", "restaurants-for-sale", "bars-and-taverns-for-sale", "catering-services-businesses-for-sale", "grocery-and-supermarkets-businesses-for-sale", "liquor-stores-for-sale", "vending-machines-and-routes-businesses-for-sale", "hair-and-beauty-businesses-for-sale", "beauty-salons-and-barber-shops-businesses-for-sale", "health-and-medical-businesses-for-sale", "dental-practices-businesses-for-sale", "health-clubs-gyms-and-fitness-centers-for-sale", "medical-practices-businesses-for-sale", "medical-clinics-for-sale", "pharmacies-for-sale", "home-and-garden-businesses-for-sale", "landscaping-services-businesses-for-sale", "internet-related-businesses-for-sale", "e-commerce-and-e-tailers-businesses-for-sale", "established-websites-for-sale", "manufacturing-businesses-for-sale", "moving-storage-and-delivery-businesses-for-sale", "moving-and-trucking-companies-for-sale", "self-storage-businesses-for-sale", "personal-businesses-for-sale", "coin-laundry-and-laundromat-businesses-for-sale", "dry-cleaning-and-laundry-businesses-for-sale", "professional-services-businesses-for-sale", "consulting-businesses-for-sale", "real-estate-listings", "retail-stores-for-sale", "convenience-stores-for-sale", "franchise-businesses-for-sale", "pet-stores-and-supplies-businesses-for-sale", "technology-businesses-for-sale", "software-and-internet-developers-businesses-for-sale", "transportation-businesses-for-sale", "shipping-and-transportation-businesses-for-sale", "taxi-and-limousine-businesses-for-sale", "wholesale-and-distribution-businesses-for-sale" ], "type": "string", "description": "Filter by industry or business category. Select a category to scrape all matching listings. Combine with State to narrow the search further." }, "state": { "title": "State", "enum": [ "", "alabama-al", "alaska-ak", "arizona-az", "arkansas-ar", "california-ca", "colorado-co", "connecticut-ct", "delaware-de", "florida-fl", "georgia-ga", "hawaii-hi", "idaho-id", "illinois-il", "indiana-in", "iowa-ia", "kansas-ks", "kentucky-ky", "louisiana-la", "maine-me", "maryland-md", "massachusetts-ma", "michigan-mi", "minnesota-mn", "mississippi-ms", "missouri-mo", "montana-mt", "nebraska-ne", "nevada-nv", "new-hampshire-nh", "new-jersey-nj", "new-mexico-nm", "new-york-ny", "north-carolina-nc", "north-dakota-nd", "ohio-oh", "oklahoma-ok", "oregon-or", "pennsylvania-pa", "rhode-island-ri", "south-carolina-sc", "south-dakota-sd", "tennessee-tn", "texas-tx", "utah-ut", "vermont-vt", "virginia-va", "washington-wa", "washington-dc-dc", "west-virginia-wv", "wisconsin-wi", "wyoming-wy" ], "type": "string", "description": "Filter listings by US state. Works on its own or combined with Category." }, "keywords": { "title": "Keywords", "type": "string", "description": "Search keyword(s) to filter listings (e.g. 'laundromat', 'auto shop', 'franchise coffee'). Used when no Search URLs are provided." }, "minPrice": { "title": "Min asking price ($)", "minimum": 0, "type": "integer", "description": "Minimum asking price filter in US dollars (e.g. 50000 for $50,000)." }, "maxPrice": { "title": "Max asking price ($)", "minimum": 0, "type": "integer", "description": "Maximum asking price filter in US dollars (e.g. 500000 for $500,000)." }, "fetchImages": { "title": "Fetch and store images", "type": "boolean", "description": "Download each listing's first image and save it to the Key-Value Store so the URL works without any special headers. Increases run time and compute units. Off by default.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of listings to collect per run.", "default": 50 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Per-request timeout in seconds.", "default": 30 } } }, "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 } } } } } } } } } } ```