← SEO Score API  ·  Blog

How to Automate SEO Reporting for Clients (Developer Guide)

Published 2026-02-25

If you're an agency or freelancer managing SEO for clients, you know the drill: run audits, screenshot results, paste into a doc, email to client. Every. Single. Month.

Let's automate that.

The Automated Pipeline

Client URLs → SEO Score API → Generate Report → Email to Client

Total code: about 40 lines of Python.

Step 1: Audit Multiple Client Sites

import requests

API_KEY = "ssa_your_key_here"
CLIENTS = {
    "Acme Corp": ["https://acmecorp.com", "https://acmecorp.com/products"],
    "Widget Inc": ["https://widgetinc.com"],
}

def audit(url):
    r = requests.get(
        "https://seoscoreapi.com/audit",
        params={"url": url},
        headers={"X-API-Key": API_KEY}
    )
    return r.json()

for client, urls in CLIENTS.items():
    print(f"\n=== {client} ===")
    for url in urls:
        result = audit(url)
        print(f"  {url}: {result['score']}/100 ({result['grade']})")
        for p in result.get("priorities", [])[:3]:
            print(f"    [{p['severity']}] {p['issue']}")

Step 2: Use Shareable Report Links

Every domain automatically gets a shareable report page:

https://seoscoreapi.com/report/acmecorp.com

Send this link to your client — they get a beautiful, interactive report without you building anything.

Step 3: Set Up Monitoring

Don't wait for the monthly check-in. Set up automated monitoring so you get emailed when a client's score changes:

# Set up daily monitoring for each client site
for client, urls in CLIENTS.items():
    for url in urls:
        requests.post(
            "https://seoscoreapi.com/monitors",
            json={"url": url, "frequency": "daily"},
            headers={"X-API-Key": API_KEY}
        )

Now you'll get an email alert if any client's score drops by 5+ points. Proactive beats reactive.

Step 4: Embed Score Badges

Give clients an embeddable badge they can put on their site (which also links back to you):

<a href="https://seoscoreapi.com/report/acmecorp.com">
  <img src="https://seoscoreapi.com/badge/acmecorp.com"
       alt="SEO Score">
</a>

Cost

For a typical agency with 10 clients, each with 3-5 pages:

• Monthly audits: ~50 API calls/month
• Daily monitoring: ~1,500 calls/month (50 pages × 30 days)
• Plan needed: Pro ($39/mo) — 5,000 audits + 25 monitors
• Compared to: SEMrush Agency ($449/mo) or Ahrefs ($199/mo)

That's a 90% cost reduction for on-page SEO auditing.