# SEO Scanner Quickstart

SEO Scanner provides account-based API access for:

- single-page technical SEO analysis
- WHOIS / RDAP lookup
- sitemap discovery
- domain snapshot lookup
- public report badge and OG image
- browser vitals collection

Base URL:

```text
https://seoscanner.it/api/v1
```

Before calling these endpoints, sign in to your SEOScanner account and enable API access from **Settings → API access**.

## Analyze a page

```bash
curl -X POST https://seoscanner.it/api/v1/analyze \
  -H "Cookie: ss_session=<your-session-cookie>" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'
```

## Lookup WHOIS / RDAP

```bash
curl -X POST https://seoscanner.it/api/v1/whois \
  -H "Cookie: ss_session=<your-session-cookie>" \
  -H "Content-Type: application/json" \
  -d '{"domain":"example.com"}'
```

## Discover a sitemap

```bash
curl -X POST https://seoscanner.it/api/v1/sitemap \
  -H "Cookie: ss_session=<your-session-cookie>" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'
```

## Other endpoints

- `GET /api/site/:domain`
- `GET /api/badge/:slug`
- `GET /api/og/:slug`
- `POST /api/vitals`

## Notes

- Account required
- API access must be enabled in account settings
- Rate limited to 30 requests per minute per IP
- Public API does not include PageSpeed
- Product UI includes richer exports and reporting