Skip to content
SiteRevenue
BUILT FOR HUMANS AND THEIR AGENTS

Audit any page.
From your terminal, your agent, or your stack.

REST and CLI for async jobs, poll, and MD/JSON/PDF. Start with a free grade, then get the $19 report if you want it. Poll for completion. No webhooks.

Agency plan only. Browser reports do not use a key.

Grade my page free See pricing Install the CLI Read the API

Async jobs · poll · MD / JSON / PDF

WHY THIS EXISTS

Your AI already writes the code. Now it can grade the page too.

Coding agents ship landing pages faster than any human review cycle. SiteRevenue gives them a way to check their own work — grade, leak score, ranked findings — before a human has to ask “did we improve anything?”

CI / CD gate

Run siterevenue audit in your pipeline and fail the build if a leak score regresses before it ships.

Self-checking agents

Any coding agent can call the API after generating a page and iterate until the grade clears a bar you set.

Poll, not webhooks

Submit a job, poll until succeeded, pull MD/JSON/PDF. Grade history lives on the workspace — no copy-pasting a PDF.

CHECKOUT NOT OPEN

Agent CLI

One line. Then audit forever. Script it into pre-deploy hooks, cron, or an agent's tool-calling loop.

  • JSON for machines, table output for humans
  • Exit codes designed for CI gating
  • Same Bearer keys as the REST API
terminal
$ curl -fsSL https://siterevenue.ai/install-cli | bash
# or from a clone: go build -o siterevenue ./cmd/siterevenue
$ export SITEREVENUE_API_KEY=sr_test_…
$ siterevenue audit submit --url https://acme.com/pricing --mode full --wait
{
"grade": "C-",
"leak_score": 64,
"status": "succeeded"
}

CLI talks only to POST /v1/agent/audits on siterevenue.ai · same Bearer key as curl · not an npm global package

POST /v1/agent/audits
curl -X POST https://siterevenue.ai/v1/agent/audits \
-H "Authorization: Bearer sr_test_…" \
-d '{"url":"https://acme.com/pricing","mode":"full"}'
{
"id": "job_…",
"status": "queued",
"mode": "full"
}
# Poll GET /v1/agent/audits/:id until succeeded
CHECKOUT NOT OPEN

REST API

Trigger audits programmatically, poll for status, and pull MD/JSON/PDF into your own dashboards or agents.

  • Bearer-token auth with hashed keys at rest
  • Full findings, leak score, and grade history per URL
  • Poll today; completion webhooks later
FOR AI CRAWLERS & ANSWER ENGINES

Machine-readable, by design.

This page is structured so retrieval systems can summarize what SiteRevenue offers agents: a CLI and a REST API for automated website conversion audits.

We publish llms.txt at the site root.

View /llms.txt
llms.txt
# SiteRevenue
- Product: website revenue audits
- Start with a free grade, then get the $19 report if you want it.
- Agent: POST /v1/agent/audits (Bearer)
- CLI: curl -fsSL https://siterevenue.ai/install-cli | bash

How the Agent API works

Three steps. Async by default. Poll until succeeded.

01

Submit job

POST a URL (+ optional outcome and competitors). Get a job ID back instantly.

POST /v1/agent/audits
02

Poll status

Poll the job endpoint until succeeded or failed — typically 30–120 seconds for full.

GET /v1/agent/audits/:id
03

Pull artifacts

Download MD, JSON, or PDF. Pipe into your workflow or client docs.

GET …/artifacts/md

API surface

Bearer token required on agent routes. Agency plan only. Full audits use the same engine as browser reports.

Method
Endpoint
Description
POST
/v1/agent/audits
Submit page audit (url)
GET
/v1/agent/audits
List jobs (newest first; limit/offset/url)
GET
/v1/agent/audits/:id
Job status + summary
GET
/v1/agent/audits/:id/result
Full result JSON when succeeded
GET
/v1/agent/audits/:id/artifacts/:kind
md | json | pdf (full only)
GET
/v1/agent/usage
Plan meters
POST
/v1/account/api-keys
Mint key (session cookie)
GET
/v1/account/api-keys
List key prefixes
DELETE
/v1/account/api-keys/:id
Revoke key

Built for automation pipelines

Async by default

Fire-and-forget jobs. Get an id immediately; poll until succeeded.

Agency plan

The API and CLI are for Agency workspaces.

MD / JSON / PDF

Stable artifacts you can store and hand to clients.

siterevenue CLI

curl -fsSL https://siterevenue.ai/install-cli | bash — then audit submit / status / get / reaudit / brief / usage against the same Agent API.

API keys in Account

Mint and revoke Bearer keys from /account/api-keys. Raw key shown once.

Secure by design

Bearer token auth; keys hashed at rest. Public pages only.

What agents build with it

From weekly multi-URL runs to full AI audit pipelines. Poll today; completion webhooks later.

Weekly multi-URL audit

Cron a list of landing pages every week (POST /v1/agent/audits per URL). Store grade + version_n; diff vs last week’s job.

Opt-in change email

Watch emails you when the public page changes, one notify per site per day. Watch is opt-in and off by default. It is not a grade-drop alert.

AI CRO agent

An LLM agent submits audit jobs, receives JSON, and generates prioritized action plans — hands-free.

Agency client onboarding

Auto-audit every new client URL at intake before the first call.

Post-deploy regression check

Hook into CI/CD. Poll until succeeded; fail the build if score drops sharply after a deploy.

Nightly portfolio sweep

Rotate through a URL set overnight.

Honest ops: job completion webhooks are later. Today: submit → poll GET /v1/agent/audits/:id until succeeded/failed (or CLI --wait). Watch emails you when the public page changes, one notify per site per day. Watch is opt-in and off by default. It is not a grade-drop alert.

Agency

For agencies and teams

  • Watch emails you when the public page changes, one notify per site per day. Watch is opt-in and off by default.
  • REST Agent API · poll
  • JSON / MD / PDF
Talk to us

Start with a free grade, then get the $19 report if you want it.

Agent API FAQ

Is the Agent API available now?

Not for purchase on this page. Agency workspaces mint a Bearer key and call POST /v1/agent/audits (or the siterevenue CLI). Today: Start with a free grade, then get the $19 report if you want it. No key required. Webhooks are still later.

What does Agency include?

REST Agent API (async jobs, poll, MD/JSON/PDF) and the siterevenue CLI. Poll for completion. No webhooks. Not required for the $19 report.

How do I use the CLI?

curl -fsSL https://siterevenue.ai/install-cli | bash then export SITEREVENUE_API_KEY=… and siterevenue audit submit --url https://example.com --mode full --wait. Same Bearer key as curl. From a clone: go build -o siterevenue ./cmd/siterevenue.

Can I use the product without the API?

Yes. Start with a free grade, then get the $19 report if you want it. No API key required.

Need an audit today?

No API key needed. Start with a free grade, then get the $19 report if you want it.