Rank tracking API for Google and Bing.

import os
from datetime import datetime, timezone
from urllib.parse import urlparse
import requests

target = "example.com"
parameters = {
    "query": "example product",
    "gl": "us",
    "hl": "en-US",
    "location": "Austin,Texas,United States",
    "device": "mobile",
}
response = requests.post(
    "https://api.prismcrawl.com/v1/google/search",
    headers={"x-api-key": os.environ["PRISMCRAWL_API_KEY"]},
    json=parameters,
    timeout=30,
)
response.raise_for_status()
payload = response.json()
if not payload.get("success"):
    raise RuntimeError("Search did not succeed")
content = payload["data"]["content"]
matches = []
for result in content.get("results", []):
    host = (urlparse(result["url"]).hostname or "").lower()
    if result["type"] == "organic" and (
        host == target or host.endswith("." + target)
    ):
        matches.append(result)

best = min(matches, key=lambda item: item["rank"], default=None)
print({
    "observed_at": datetime.now(timezone.utc).isoformat(),
    "request_id": payload["request_id"],
    "engine": "google",
    "parameters": parameters,
    "status": "found" if best else "not_found_on_checked_page",
    "rank": best["rank"] if best else None,
    "position": best.get("position") if best else None,
    "url": best["url"] if best else None,
    "serp_features": content.get("serp_features", []),
})