# Start a full marketing audit of a site: POST /v1/audits/site

The full marketing audit Magister runs for a new brand: an overall score, scores by area, findings and opportunities.

- Base URL: https://api.magistermarketing.com
- Auth: `Authorization: Bearer $MAGISTER_API_KEY` (a full key)
- Cost: about 100, measured per run (the full marketing audit)
- Runs as a job: answers 202 with a job_id; poll GET /v1/jobs/{job_id}, or pass webhook_url.

## Parameters

| Name | In | Type | Required | Notes |
| --- | --- | --- | --- | --- |
| webhook_url | body | string | no | Public https URL POSTed when the job finishes, signed in `Magister-Signature` with your organization's webhook secret (Settings -> Developers -> Webhooks); retried 5 times over a day.; at most 2000 characters |
| max_credits | body | number | no | Refuse the job (402 `limit_reached`, reason `max_credits_exceeded`) when the most it may hold is above this. A refused job costs nothing.; above 0, at most 100,000 |
| url | body | string | yes | Any public site, such as https://example.com.; at most 2000 characters |

## Request

```bash
curl -X POST https://api.magistermarketing.com/v1/audits/site \
  -H "Authorization: Bearer $MAGISTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://tally.so"}'
```

## Response (a real call, 2026-11-11, trimmed)

```json
{
  "job_id": "6a7defd2-d26b-4ab0-b0f6-a804e41a9856",
  "kind": "site_audit",
  "status": "succeeded",
  "created_at": "2026-11-11T04:08:51.896908+00:00",
  "finished_at": "2026-11-11T04:10:09.145871+00:00",
  "credits_charged": 103.74,
  "result": {
    "website_url": "https://tally.so",
    "status": "complete",
    "health": {
      "current": 64,
      "subscores": {
        "ai_search": {
          "current": 87
        },
        "google_search": {
          "current": 20
        },
        "website_and_content": {
          "current": 86
        }
      },
      "tabs": {
        "google_search": {
          "score_current": 20,
          "score_basis": "Keyword research: the site is on Google's first two pages for 4 of 10 keywords looked up.",
          "keywords": [
            {
              "demand": "1k-10k",
              "keyword": "free form builder",
              "position": null
            },
            {
              "demand": "1k-10k",
              "keyword": "free online form builder",
              "position": null
            },
            {
              "demand": "100-1k",
              "keyword": "no-code form builder",
              "position": null
            }
          ],
          "findings": [
            {
              "title": "No top-100 visibility for the listed searches",
              "detail": "Tally does not appear in the top 100 for any of the five listed searches, including “online form creator” and “online form maker,” each with 10k-100k monthly searches.",
              "severity": 5
            }
          ],
          "opportunities": [
            {
              "title": "Make a page for online form makers",
              "detail": "Create a page that directly answers searches like “online form creator” and “online form maker,” with examples of what people can build and a clear invitation to try Tally."
            }
          ]
        },
        "website_and_content": {
          "score_current": 86,
          "checklist": [
            {
              "note": "Found: Get started",
              "label": "Clear call to action",
              "status": "pass"
            },
            {
              "note": "Found: Organization, ContactPoint, WebSite, SoftwareApplication",
              "label": "Schema markup",
              "status": "pass"
            }
          ]
        }
      }
    }
  }
}
```

The whole API reference, for an agent: https://magistermarketing.com/docs/api.md