Metadata-Version: 2.4
Name: seoscoreapi
Version: 1.2.0
Summary: Python client for SEO Score API — audit any URL for SEO issues with one function call
Author-email: SEO Score API <info@seoscoreapi.com>
License: MIT
Project-URL: Homepage, https://seoscoreapi.com
Project-URL: Documentation, https://seoscoreapi.com/docs
Project-URL: Repository, https://github.com/avansledright/seoscoreapi.com
Keywords: seo,audit,api,seo-score,website-audit,seo-checker
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.20

# seoscoreapi

Python client for [SEO Score API](https://seoscoreapi.com) — audit any URL for SEO issues with one function call.

## Install

```bash
pip install seoscoreapi
```

## Quick Start

```python
from seoscoreapi import audit, signup

# Get a free API key (5 audits/day)
key = signup("you@example.com")

# Run an audit
result = audit("https://example.com", api_key=key)
print(f"Score: {result['score']}/100 ({result['grade']})")
```

## Functions

| Function | Description |
|---|---|
| `signup(email)` | Get a free API key |
| `audit(url, api_key)` | Run SEO audit on a URL |
| `batch_audit(urls, api_key)` | Audit multiple URLs (paid) |
| `usage(api_key)` | Check usage and limits |
| `add_monitor(url, api_key)` | Set up score monitoring (paid) |
| `list_monitors(api_key)` | List active monitors |
| `report_url(domain)` | Get shareable report URL |

## Full Documentation

[seoscoreapi.com/docs](https://seoscoreapi.com/docs)
