Audits

Start a full marketing audit of a site

POSThttps://api.magistermarketing.com/v1/audits/site

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

Cost: ~100 credits
Runs: As a job: 202, then poll
Key: Full key
Holds up to: 240 credits

Parameters

Name	Type	About
webhook_url	string · body	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	number · body	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
urlrequired	string · body	Any public site, such as https://example.com. at most 2000 characters

This one runs as a job: the call answers 202 with a job_id; poll GET /v1/jobs/{job_id} until its status is no longer running, or pass a webhook_url. Jobs and webhooks

Request

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

succeededin 77 s· 103.74 credits

{
  "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"
            }
          ]
        }
      }
    }
  }
}

A real call from a test organization, 2026-11-11. Trimmed to the scores; the API returns every finding.