Local SEO Map Rank Tracker with API

import requests, os
from datetime import datetime

H = {"x-api-key": os.environ["SCAVIO_API_KEY"]}

def check_local_rank(business_name, query, location=None):
    """Check business position in Google Local Pack."""
    search_query = f"{query} {location}" if location else query
    r = requests.post("https://api.scavio.dev/api/v1/search",
        headers=H,
        json={"platform": "google", "query": search_query},
        timeout=10
    ).json()

    local_pack = r.get("localPack", [])
    for i, result in enumerate(local_pack):
        if business_name.lower() in result.get("title", "").lower():
            return {
                "query": search_query,
                "position": i + 1,
                "total_results": len(local_pack),
                "found": True,
                "rating": result.get("rating"),
                "reviews": result.get("reviews"),
            }
    return {
        "query": search_query,
        "position": None,
        "found": False,
    }

rank = check_local_rank("Blue Bottle Coffee", "coffee shop", "San Francisco")
if rank["found"]:
    print(f"Position {rank['position']} for '{rank['query']}'")
else:
    print(f"Not in Local Pack for '{rank['query']}")

def track_all_locations(business, keywords, locations):
    """Track map rankings across all keyword-location combos."""
    results = []
    for keyword in keywords:
        for location in locations:
            rank = check_local_rank(business, keyword, location)
            rank["keyword"] = keyword
            rank["location"] = location
            rank["date"] = datetime.now().strftime("%Y-%m-%d")
            results.append(rank)
    return results

keywords = ["coffee shop", "best coffee", "coffee near me"]
locations = ["San Francisco", "Oakland", "Berkeley"]
rankings = track_all_locations("Blue Bottle Coffee", keywords, locations)

found = [r for r in rankings if r["found"]]
print(f"Found in {len(found)}/{len(rankings)} queries")
for r in found:
    print(f"  {r['keyword']} + {r['location']}: position {r['position']}")

def detect_ranking_changes(current, previous):
    """Compare current rankings to previous day."""
    alerts = []
    prev_map = {
        (r["keyword"], r["location"]): r["position"]
        for r in previous if r["found"]
    }
    for r in current:
        key = (r["keyword"], r["location"])
        prev_pos = prev_map.get(key)
        if r["found"] and prev_pos:
            if r["position"] > prev_pos:
                alerts.append({
                    "type": "drop",
                    "keyword": r["keyword"],
                    "location": r["location"],
                    "from": prev_pos,
                    "to": r["position"],
                })
        elif not r["found"] and prev_pos:
            alerts.append({
                "type": "lost",
                "keyword": r["keyword"],
                "location": r["location"],
                "previous_position": prev_pos,
            })
    return alerts