QSR Operator List Building via Search API

import requests

def find_qsr_locations(brand: str, metros: list) -> list:
    """Find QSR franchise locations across metros."""
    locations = []

    for metro in metros:
        resp = requests.post(
            "https://api.scavio.dev/api/v1/search",
            headers={"x-api-key": "YOUR_KEY"},
            json={
                "query": f"{brand} {metro}",
                "num_results": 20
            }
        )
        data = resp.json()
        local_results = data.get("local_results", [])

        for r in local_results:
            locations.append({
                "brand": brand,
                "metro": metro,
                "name": r.get("title", ""),
                "address": r.get("address", ""),
                "phone": r.get("phone", ""),
                "website": r.get("website", ""),
                "rating": r.get("rating", ""),
                "reviews": r.get("reviews_count", 0)
            })

    return locations

# Find Subway locations across Texas metros
metros = ["Austin TX", "Dallas TX", "Houston TX", "San Antonio TX"]
subway_locations = find_qsr_locations("Subway restaurant", metros)
print(f"Found {len(subway_locations)} Subway locations")

# Filter for multi-unit operators (same phone across locations)
from collections import Counter
phone_counts = Counter(l["phone"] for l in subway_locations if l["phone"])
multi_unit = {phone: count for phone, count in phone_counts.items() if count > 1}
print(f"Multi-unit operators: {len(multi_unit)}")

// Find operators who run multiple locations (higher-value prospects)
async function findMultiUnitOperators(brand, locations) {
  const allLocations = [];

  for (const loc of locations) {
    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: brand + " " + loc,
        num_results: 20
      })
    });

    const data = await resp.json();
    for (const r of (data.local_results || [])) {
      allLocations.push({
        name: r.title,
        phone: r.phone,
        website: r.website,
        address: r.address,
        metro: loc
      });
    }
  }

  // Group by phone number to find multi-unit operators
  const byPhone = {};
  for (const loc of allLocations) {
    if (!loc.phone) continue;
    if (!byPhone[loc.phone]) byPhone[loc.phone] = [];
    byPhone[loc.phone].push(loc);
  }

  return Object.entries(byPhone)
    .filter(([_, locs]) => locs.length > 1)
    .map(([phone, locs]) => ({
      phone,
      locationCount: locs.length,
      metros: [...new Set(locs.map(l => l.metro))],
      website: locs[0].website
    }))
    .sort((a, b) => b.locationCount - a.locationCount);
}