{
  "openapi": "3.0.1",
  "info": {
    "title": "BizBuySell $1.5💰 URL Search | Keyword Filtering | Rich Output",
    "description": "From $1.5/1K. Extract business-for-sale and franchise listings from bizbuysell.com with financials, full descriptions, photos, and broker contact details. Search by filters or paste BizBuySell URLs directly. Returns 30+ structured fields per listing, ready for CRMs, deal pipelines, or spreadsheets.",
    "version": "1.3",
    "x-build-id": "mp0fQTHIYzfDiYydn"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/abotapi~bizbuysell-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-abotapi-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/abotapi~bizbuysell-scraper/runs": {
      "post": {
        "operationId": "runs-sync-abotapi-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/abotapi~bizbuysell-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-abotapi-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",
        "required": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Search mode",
            "enum": [
              "search",
              "url"
            ],
            "type": "string",
            "description": "Pick how the scraper finds listings: 'search' uses the filter fields below; 'url' fetches the BizBuySell search/category URLs you paste.",
            "default": "search"
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Free-text keyword, e.g. 'coffee shop', 'HVAC', 'laundromat'. Leave blank to browse all listings."
          },
          "category": {
            "title": "Category",
            "type": "string",
            "description": "BizBuySell industry category slug, e.g. 'restaurants-and-food', 'retail', 'service-businesses', 'manufacturing', 'automotive-and-boat'. Leave blank for all categories."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "US state or region, e.g. 'Florida', 'California', 'Texas'. Used as the BizBuySell location path. For one specific city/metro, paste that city's BizBuySell URL in URL mode instead. Leave blank for nationwide."
          },
          "listingType": {
            "title": "Listing type",
            "enum": [
              "all",
              "established",
              "asset-sale"
            ],
            "type": "string",
            "description": "Established businesses, asset sales, or both.",
            "default": "all"
          },
          "minAskingPrice": {
            "title": "Min asking price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return listings with an asking price at or above this amount."
          },
          "maxAskingPrice": {
            "title": "Max asking price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return listings with an asking price at or below this amount."
          },
          "minCashFlow": {
            "title": "Min cash flow / SDE (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return listings whose cash flow (seller's discretionary earnings) is at or above this amount. Cash flow is on the listing detail page, so enable 'Fetch full listing details' for this filter to apply."
          },
          "minGrossRevenue": {
            "title": "Min gross revenue (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only return listings whose annual gross revenue is at or above this amount. Gross revenue is on the listing detail page, so enable 'Fetch full listing details' for this filter to apply."
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "default",
              "price-asc",
              "price-desc",
              "newest",
              "cashflow-desc"
            ],
            "type": "string",
            "description": "Order the search results.",
            "default": "default"
          },
          "urls": {
            "title": "BizBuySell URLs",
            "type": "array",
            "description": "Paste one or more BizBuySell search, category or listing URLs. Filter-mode fields are ignored. Pagination starts at the page in the URL and walks forward.",
            "items": {
              "type": "string"
            }
          },
          "fetchDetails": {
            "title": "Fetch full listing details",
            "type": "boolean",
            "description": "Open each listing page to pull financials (cash flow, gross revenue, EBITDA, inventory, FF&E, real estate), full description, photos, and the listing broker's name / phone / brokerage. Adds one request per listing. Turn off for a fast, lean run with just the search-card fields.",
            "default": false
          },
          "maxPages": {
            "title": "Max search pages",
            "minimum": 1,
            "type": "integer",
            "description": "How many result pages to walk per search / per URL.",
            "default": 1
          },
          "maxListings": {
            "title": "Max listings",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many listings total. 0 = no limit.",
            "default": 0
          },
          "proxy": {
            "title": "Proxy",
            "type": "object",
            "description": "BizBuySell needs US residential proxy. The default below works on Apify Starter plans and above. Free-tier accounts without residential access will get zero results.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}