{
  "openapi": "3.0.1",
  "info": {
    "title": "Businesses For Sale Scraper",
    "description": "[💰 $0.85 / 1K] Extract business-for-sale listings from BusinessesForSale.com — title, asking price, revenue, cash flow, EBITDA, location, photos, broker contacts, and full descriptions. Search by keyword, country, industry, and price range, or paste BusinessesForSale.com URLs directly.",
    "version": "1.0",
    "x-build-id": "7aGg7XFyujuDsDR1G"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~businesses-for-sale-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-businesses-for-sale-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/solidcode~businesses-for-sale-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-businesses-for-sale-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/solidcode~businesses-for-sale-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-businesses-for-sale-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": "BusinessesForSale.com URLs",
            "type": "array",
            "description": "Paste search-results pages (e.g. https://www.businessesforsale.com/us/search/businesses-for-sale) or individual listing URLs. Filters in the URL are honored as-is — the Filters section below is ignored when URLs are provided.",
            "items": {
              "type": "string"
            }
          },
          "searchKeywords": {
            "title": "Search Keywords",
            "type": "array",
            "description": "Free-text search terms (e.g. 'coffee shop', 'dental practice', 'car wash'). Each term runs its own search and respects the filters below.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "enum": [
              "global",
              "us",
              "uk",
              "ca",
              "au",
              "nz"
            ],
            "type": "string",
            "description": "Country to search in. Drives the URL prefix on BusinessesForSale.com. Pick 'Global' to search across all countries (including Ireland and South Africa, which don't have dedicated country pages).",
            "default": "us"
          },
          "locationText": {
            "title": "State, Region, or City",
            "type": "string",
            "description": "Optional location refinement, e.g. 'California', 'Texas', 'London', 'Sydney'. Combined with the keyword search."
          },
          "industry": {
            "title": "Industry",
            "enum": [
              "all",
              "restaurants-food",
              "retail",
              "manufacturing",
              "wholesale-distribution",
              "service-businesses",
              "automotive",
              "construction",
              "healthcare-medical",
              "beauty-personal-care",
              "online-internet",
              "education-training",
              "agriculture-farming",
              "transportation",
              "real-estate-property",
              "hotels-motels",
              "bars-nightclubs",
              "franchises",
              "import-export",
              "leisure-entertainment"
            ],
            "type": "string",
            "description": "Top-level business sector. Pick 'All industries' to search every category. For more specific niches (e.g. 'bagel shops', 'dental practices', 'auto repair'), use the 'Specific Industry Slug' field below to override this with any of 400+ sub-categories from BusinessesForSale.com.",
            "default": "all"
          },
          "industrySlug": {
            "title": "Specific Industry Slug (advanced)",
            "type": "string",
            "description": "Optional: paste a specific category slug from BusinessesForSale.com to target a niche category not in the dropdown above. For example: 'bagel-shops', 'dental-practices', 'cafes', 'food-trucks', 'amazon-stores'. The full list of 400+ slugs is at https://www.businessesforsale.com/allcategories. When set, this overrides the Industry dropdown."
          },
          "minAskingPrice": {
            "title": "Min Asking Price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings asking at least this much (in USD). Leave blank for no minimum."
          },
          "maxAskingPrice": {
            "title": "Max Asking Price (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings asking at most this much (in USD). Leave blank for no maximum."
          },
          "minCashFlow": {
            "title": "Min Annual Cash Flow / SDE (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings with annual cash flow (seller's discretionary earnings) of at least this much. Leave blank for no minimum."
          },
          "maxCashFlow": {
            "title": "Max Annual Cash Flow / SDE (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings with annual cash flow at or below this much. Leave blank for no maximum."
          },
          "minRevenue": {
            "title": "Min Annual Revenue (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings with annual revenue (turnover) of at least this much. Leave blank for no minimum."
          },
          "maxRevenue": {
            "title": "Max Annual Revenue (USD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only include listings with annual revenue at or below this much. Leave blank for no maximum."
          },
          "sortOrder": {
            "title": "Sort Order",
            "enum": [
              "newest",
              "featured",
              "price-desc",
              "price-asc",
              "revenue-desc",
              "revenue-asc",
              "profit-desc",
              "profit-asc"
            ],
            "type": "string",
            "description": "Order of results from BusinessesForSale.com. 'Newest' surfaces freshly listed businesses first; 'Profit (highest first)' surfaces the largest cash-flow deals.",
            "default": "newest"
          },
          "includeListingDetails": {
            "title": "Include Full Listing Details",
            "type": "boolean",
            "description": "Fetch each listing's detail page for the full description, financials, broker info, and photos. When off, only the search-card data is returned (faster and cheaper).",
            "default": true
          },
          "maxResults": {
            "title": "Max Results",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap on total listings collected across all URLs and keywords. Default 100 — increase for bigger runs, or set to 0 for no cap (an internal upper limit of 100,000 plus a 1,500-page safety ceiling still applies to prevent runaway runs). The actor stops requesting new pages once this number is reached but keeps the full final page; the page size auto-adjusts so a small cap (e.g. 5, 25) doesn't pull a full 100-row page. Result count may overshoot by at most one page (≤ chosen page size).",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}