Usage Stats Endpoint¶

import requests
from datetime import datetime, timedelta

url = "https://api.reputeapi.com/v1/usage"
headers = {"X-API-Key": "your-api-key"}

# Get last 7 days of usage
end_date = datetime.now()
start_date = end_date - timedelta(days=7)

params = {
    "start_date": start_date.isoformat(),
    "end_date": end_date.isoformat(),
    "granularity": "day"
}

response = requests.get(url, headers=headers, params=params)
usage = response.json()

print(f"Total requests: {usage['summary']['total_requests']}")
print(f"Quota remaining: {usage['quota']['remaining']}")

#!/usr/bin/env python3
import requests
import sys

def check_usage(api_key):
    url = "https://api.reputeapi.com/v1/usage"
    headers = {"X-API-Key": api_key}

    response = requests.get(url, headers=headers)
    usage = response.json()

    quota = usage["quota"]
    rate = usage["rate_limits"]

    print(f"\n📊 API Usage Report")
    print(f"{'='*50}")
    print(f"Tier: {usage['account']['tier'].upper()}")
    print(f"\nMonthly Quota:")
    print(f"  Used:      {quota['used']:,} / {quota['monthly_limit']:,}")
    print(f"  Remaining: {quota['remaining']:,}")
    print(f"  Progress:  {quota['percentage_used']:.1f}%")
    print(f"  Resets:    {quota['reset_date'][:10]}")
    print(f"\nRate Limits:")
    print(f"  Limit:     {rate['requests_per_minute']}/minute")
    print(f"  Current:   {rate['current_minute_usage']}/minute")
    print(f"\nSuccess Rate: {usage['summary']['success_rate']:.2f}%")
    print(f"Avg Response: {usage['summary']['average_response_time_ms']}ms")

    # Warning if quota is running low
    if quota['percentage_used'] > 80:
        print(f"\n⚠️  WARNING: You've used {quota['percentage_used']:.1f}% of your quota!")

    print(f"{'='*50}\n")

if __name__ == "__main__":
    if len(sys.argv) < 2:
        print("Usage: python check_usage.py <api-key>")
        sys.exit(1)

    check_usage(sys.argv[1])

import requests
import smtplib
from datetime import datetime

def monitor_usage(api_key, alert_threshold=80):
    """Monitor API usage and send alert if threshold exceeded"""
    url = "https://api.reputeapi.com/v1/usage"
    headers = {"X-API-Key": api_key}

    response = requests.get(url, headers=headers)
    usage = response.json()

    percentage_used = usage["quota"]["percentage_used"]

    if percentage_used > alert_threshold:
        send_alert(
            f"API Quota Alert: {percentage_used:.1f}% used",
            usage
        )
        return True

    return False

def send_alert(subject, usage_data):
    """Send email alert about quota usage"""
    # Implementation depends on your email setup
    pass

# Check usage every hour
import schedule
import time

def job():
    usage = get_usage()
    if usage["quota"]["percentage_used"] > 75:
        send_notification("API quota running low")

schedule.every().hour.do(job)

while True:
    schedule.run_pending()
    time.sleep(60)

def should_validate_domain(domain):
    usage = get_usage()
    remaining = usage["quota"]["remaining"]

    if remaining < 100:
        # Switch to cached results only
        return False

    if remaining < 1000:
        # Reduce validation frequency
        return should_validate_less_frequently(domain)

    return True

import sqlite3
from datetime import datetime

def log_usage():
    usage = get_usage()

    conn = sqlite3.connect('usage_history.db')
    cursor = conn.cursor()

    cursor.execute('''
        INSERT INTO usage_logs (timestamp, requests_used, quota_remaining)
        VALUES (?, ?, ?)
    ''', (
        datetime.now().isoformat(),
        usage["quota"]["used"],
        usage["quota"]["remaining"]
    ))

    conn.commit()
    conn.close()