# Bizbuysell Business Details (`hello.datawizards/bizbuysell-business-details`) Actor

The Bizbuysell Business Details Apify Actor extracts detailed business listings from BizBuySell in JSON, perfect for investment analysis, market research, and opportunity tracking. Supports location queries, residential proxies, and scalable scraping. Built by DataWizards.

- **URL**: https://apify.com/hello.datawizards/bizbuysell-business-details.md
- **Developed by:** [datawizards](https://apify.com/hello.datawizards) (community)
- **Categories:** Automation, Other, Lead generation
- **Features:** Limited permissions
- **Stats:** 41 total users, 0 monthly users, 100.0% runs succeeded, 3 bookmarks
- **User rating**: No ratings yet

## Pricing

$5.00 / 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.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### 📦 Bizbuysell Business Details · Apify Actor

Extract **detailed business listing data** from BizBuySell in structured JSON format, ideal for market research, investment analysis, or business opportunity tracking.\
Built and maintained by [DataWizards](https://linkedin.com/in/data-wizards-aa8080342).

***

### 📌 What Is `Bizbuysell Business Details`?

The `Bizbuysell Business Details` Apify Actor allows you to **scrape comprehensive business listing data** from BizBuySell by querying locations or specific business categories. It captures key details like business name, price, cash flow, location, description, and contact information, perfect for investors, entrepreneurs, and analysts seeking actionable insights.

No manual browsing or login is required, and the actor leverages Apify’s proxy system for reliable, scalable data extraction.

***

### 🧠 Key Features

- ✅ **Rich Business Data** – Extracts business name, price, cash flow, EBITDA, location, description, and more.
- ✅ **Query-Based Scraping** – Search by location (e.g., "texas") or specific business categories.
- ✅ **Customizable Limits** – Control the number of listings with the `itemLimit` parameter.
- ✅ **Proxy Support** – Uses Apify Proxy (including **RESIDENTIAL IPs**) for robust scraping.
- ✅ **Structured JSON Output** – Clean, easy-to-use data for analytics or integration.
- ✅ **Fast & Scalable** – Optimized for efficient performance and large-scale data collection.

***

### 🛠️ Input Schema

To use the actor, provide the following input in JSON format:

```json
{
  "itemLimit": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "queries": [
    "texas"
  ]
}
```

#### Input Parameters

- **`queries`**: Array of search terms (e.g., `"texas"`) to filter business listings by location or category.
- **`itemLimit`**: Maximum number of listings to scrape (e.g., `10` for 10 listings).
- **`proxyConfiguration`**:
  - **`useApifyProxy`**: Set to `true` to enable Apify Proxy (required for reliable scraping).
  - **`apifyProxyGroups`**: Optionally use `"RESIDENTIAL"` for high-quality, low-block results.

***

### 📤 Output Example

The actor returns structured JSON data, including detailed business listing information:

```json
[
  {
    "query": "texas",
    "page": 1,
    "location": "Corpus Christi, TX",
    "header": "Collectible Toy Vending - A Passive Income Machine! $4.5K+ Per Month",
    "price": 30000.0,
    "description": "BUSINESS AT A GLANCE MONTHLY CASH FLOW: $4,500+ - HIGH PROFIT MARGINS - LOCATIONS: Prime spots with high foot traffic - SUPPORT & TRAINING: Provided for a smooth transition ABOUT THE BUSINESS Want a...",
    "type": 5,
    "images": [
      "https://images.bizbuysell.com/shared/listings/232/2328044/69f6e51a-debd-4476-bada-8774e9052f92-W336.jpg"
    ],
    "listNumber": 2328044,
    "urlStub": "https://www.bizbuysell.com/business-opportunity/collectible-toy-vending-a-passive-income-machine-4-5k-per-month/2328044/",
    "cashFlow": 54000.0,
    "ebitda": 54000.0,
    "listingTypeId": 40,
    "hotProperty": true,
    "recentlyUpdated": true,
    "recentlyAdded": false,
    "realEstateIncludedInAskingPrice": false,
    "contactFullName": "Ben Pirrie",
    "contactPhoneNumber": "(218) 947 6242"
  }
]
```

***

### 🚀 Use Cases

- 💰 **Investment Analysis** – Evaluate business opportunities based on price, cash flow, and EBITDA.
- 🕵️ **Market Research** – Analyze business trends in specific regions or industries.
- 📈 **Competitor Monitoring** – Track listings for competitive insights or market positioning.
- 🤖 **Data Aggregation** – Feed business data into investment platforms or analytics dashboards.
- 🏢 **Entrepreneurial Planning** – Identify passive income opportunities or businesses for sale.

***

### ✅ Best Practices

- **Use Residential Proxies**: Enable `RESIDENTIAL` proxy groups for large-scale scraping to minimize blocks.
- **Refine Queries**: Use specific location-based queries (e.g., `"texas"`) to target relevant listings.
- **Set Reasonable Limits**: Use `itemLimit` to control the number of listings scraped and avoid overloading BizBuySell’s servers.
- **Validate Queries**: Ensure query terms are valid and relevant to prevent empty results.
- **Batch Requests**: For large-scale scraping, break queries into smaller batches to maintain performance.
- **Monitor Outputs**: Regularly check JSON outputs for consistency and completeness.

***

### 🛠️ Advanced Configuration

- **Targeted Queries**: Use precise location or category terms (e.g., `"texas restaurants"`) for more focused results.
- **Scaling Up**: Increase `itemLimit` for broader data collection, but monitor proxy usage to avoid rate-limiting.
- **Custom Fields**: Contact DataWizards for additional fields (e.g., business type, financial metrics) or custom output formats.

***

### 🤝 Support

Need help with setup, custom fields, or integration?

**DataWizards is ready to assist!**

📩 **Email**: <hello.datawizard@gmail.com>\
✉️ **Subject**: `Bizbuysell Business Details – Support Request`\
🔗 **Connect**: [linkedin.com/in/data-wizards-aa8080342](https://linkedin.com/in/data-wizards-aa8080342)

***

### 🧰 Need Something More?

Looking for custom scraping logic, API integrations, or tailored data formats? DataWizards specializes in scalable, smart data solutions to meet your needs.

**Contact us for personalized support.**\
💡 *DataWizards = Fast, reliable, and scalable data extraction.*

***

### 💬 Feedback & Bugs

Found a bug or have a feature request?

📧 **Email**: <hello.datawizard@gmail.com>\
🛠️ **Subject**: `Bug Report – Bizbuysell Business Details`\
Or open an issue directly on [Apify](https://apify.com).

***

#### 🏁 Start scraping smarter with `Bizbuysell Business Details` — your go-to tool for unlocking valuable business insights from BizBuySell.

# Actor input Schema

## `queries` (type: `array`):

A list of location queries you want to scrape data from.

## `min` (type: `integer`):

Minimum Price

## `max` (type: `integer`):

Maximum Price

## `listingtype` (type: `array`):

Select the types of listing. leave blank for all the listing

## `categories` (type: `array`):

Select the types of categories. leave blank for all the categories

## `item_limit` (type: `integer`):

Specifies the maximum number of items to process.

## `proxyConfiguration` (type: `object`):

Specifies proxy servers that will be used by the scraper in order to hide its origin.

## Actor input object example

```json
{
  "queries": [
    "texas"
  ],
  "min": 0,
  "max": 0,
  "item_limit": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "texas"
    ],
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("hello.datawizards/bizbuysell-business-details").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "queries": ["texas"],
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("hello.datawizards/bizbuysell-business-details").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "texas"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call hello.datawizards/bizbuysell-business-details --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hello.datawizards/bizbuysell-business-details"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/J5JWxCr6sfZRqguhE/builds/z6XhPUsd9mwLxe4ec/openapi.json
