Franchise Multi-Unit Operator Discovery via API

import requests
from collections import defaultdict

def discover_operators(brand: str, regions: list) -> list:
    """Find multi-unit franchise operators."""
    all_locations = []

    for region in regions:
        resp = requests.post(
            "https://api.scavio.dev/api/v1/search",
            headers={"x-api-key": "YOUR_KEY"},
            json={
                "query": f"{brand} near {region}",
                "num_results": 20
            }
        )
        data = resp.json()
        for r in data.get("local_results", []):
            all_locations.append({
                "name": r.get("title", ""),
                "phone": r.get("phone", ""),
                "website": r.get("website", ""),
                "address": r.get("address", ""),
                "region": region,
                "rating": r.get("rating", ""),
                "reviews": r.get("reviews_count", 0)
            })

    # Group by phone to find multi-unit operators
    by_phone = defaultdict(list)
    for loc in all_locations:
        if loc["phone"]:
            by_phone[loc["phone"]].append(loc)

    operators = []
    for phone, locations in by_phone.items():
        if len(locations) >= 2:
            operators.append({
                "phone": phone,
                "location_count": len(locations),
                "regions": list(set(l["region"] for l in locations)),
                "website": locations[0]["website"],
                "avg_rating": sum(
                    float(l["rating"]) for l in locations if l["rating"]
                ) / len(locations)
            })

    return sorted(operators, key=lambda x: x["location_count"], reverse=True)

# Find multi-unit Chick-fil-A operators
operators = discover_operators("Chick-fil-A", [
    "Atlanta GA", "Charlotte NC", "Nashville TN", "Dallas TX"
])

for op in operators[:10]:
    print(f"Phone: {op['phone']} | Locations: {op['location_count']}")
    print(f"  Regions: {', '.join(op['regions'])}")

// After finding operators, check their web presence
async function enrichOperator(operator) {
  // Search for the operator's website/business info
  const resp = await fetch("https://api.scavio.dev/api/v1/search", {
    method: "POST",
    headers: {
      "x-api-key": process.env.SCAVIO_KEY,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      query: operator.website || operator.phone,
      num_results: 5
    })
  });

  const data = await resp.json();
  const results = data.organic_results || [];

  return {
    ...operator,
    hasWebsite: Boolean(operator.website),
    webMentions: results.length,
    possibleOwnerName: results[0]?.title?.split("|")[0]?.trim() || null
  };
}