# Tinstop Website Intelligence API

> Machine-payable API for domain security and performance audits (DNS, SSL/TLS, HTTP security headers, SPF/DKIM/DMARC, PageSpeed). Access is gated with the x402 protocol using USDC on Base. No accounts or API keys.

## Core
- https://tinstop.com/docs: Human-readable, interactive API documentation (Swagger UI).
- https://tinstop.com/openapi.json: OpenAPI schema for all endpoints, parameters, and responses.
- https://tinstop.com/.well-known/x402: Machine-readable x402 payment and endpoint metadata.
- https://tinstop.com/v1/pricing: Pricing and per-endpoint plan details.
- https://tinstop.com/SKILL.md: Plain-text capability description for agents.

## Endpoints
- https://tinstop.com/v1/dmarc-check (POST, $0.02): DMARC policy, pct, alignment, and reporting targets.
- https://tinstop.com/v1/ssl-check (POST, $0.02): TLS cert validity, expiry, SANs, and hostname match.
- https://tinstop.com/v1/headers-check (POST, $0.02): Security headers grade including weak HSTS and X-Frame-Options.
- https://tinstop.com/v1/domain/subdomains (POST, $0.02): Enumerate likely subdomains with DNS resolution status.
- https://tinstop.com/v1/site/screenshot (POST, $0.02): Capture desktop or mobile screenshot metadata for a URL.
- https://tinstop.com/v1/email-security-check (POST, $0.05): SPF/DKIM/DMARC with +all, multi-record, and pct checks.
- https://tinstop.com/v1/domain/security (POST, $0.05): Focused security posture: SSL, redirects, headers, email auth, grade.
- https://tinstop.com/v1/site/change-diff (POST, $0.05): Structured page diff versus previous snapshot or a baseline.
- https://tinstop.com/v1/domain/audit (POST, $0.10): Full audit: DNS, SSL, headers, and email auth with weighted score.
- https://tinstop.com/v1/website/performance (POST, $0.10+): Live Google PageSpeed metrics; pagespeed_available flag if PSI is down.
- https://tinstop.com/v1/domain/overview (POST, $0.15): One-call domain dossier: RDAP, DNS, SSL, tech/hosting hints, risk flags.
- https://tinstop.com/v1/website/ai-audit-report (POST, $0.50+): AI expert report: multi-check bundle + DeepSeek summary, issues, action plan.
- https://tinstop.com/v1/website/ai-seo-readiness (POST, $0.75): AI SEO/UX readiness review from crawlability, metadata, and performance.
- https://tinstop.com/v1/website/ai-change-advisor (POST, $1.00): AI comparison of two scans or domains: regressions, improvements, actions.

## Payment
- Protocol: x402 v2 (EIP-3009 exact scheme)
- Network: Base mainnet (eip155:8453)
- Asset: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)

## Optional
- https://tinstop.com/llms-full.txt: Compact full reference for LLM ingestion.
- https://tinstop.com/contact: Support and contact (support@tinstop.com).