Magister API · REST

Where a brand stands in AI answers, from your own code.

The checks Magister runs for its customers, over plain HTTPS and JSON: AI visibility for any domain, AEO audits, brand profiles and site maps. Pay for what you call with prepaid API credits, apart from any plan.

Get an API keyRead the docs

Open to every organization: create an account, then make a key in Settings → Developers. 300 free credits to start.

What you can call

One key, the checks behind Magister.

Each endpoint runs the same code as Magister's own agent and MCP tools, so what you get over the API is what Magister's customers get.

AI visibility for any domain

POST /v1/ai-visibility/check

Ask 11 AI engines the questions a buyer would: ChatGPT, Gemini and Google AI Mode as a buyer sees them, Claude, Perplexity, OpenAI and Grok searching the web, and Gemini (API), DeepSeek, Mistral and Meta Muse from what the model knows. Choose the engines, how many answers each gives, and whether they search. For every answer: whether the domain is mentioned, cited and named beside its competitors, the score and its parts, sentiment and the sites cited. No brand to set up: a domain in, a scored result out.

AEO audit of a page

POST /v1/audits/aeo

How ready a URL is to be quoted in AI answers: structure, schema, crawlability and the fixes that matter. Free for a URL.

A brand profile from a domain

POST /v1/brand/extract

Positioning, ideal customer, voice, messaging pillars and visual identity, read from the site itself: ready to brief a writer or enrich a CRM record.

Keyword opportunities

POST /v1/keywords/research

From a domain, a seed keyword or both: each keyword with an opportunity score, what the searcher wants, its topic and what to do about it, with demand, difficulty and where the site ranks as bands.

The full marketing audit

POST /v1/audits/site

Magister's audit of a URL: a health score, each channel's score and findings (AI visibility, SEO, website, social, paid ads) and the opportunities to act on first.

Page speed for real visitors

POST /v1/web/page-speed

A site's page-experience score on phones and desktops from Chrome's real-user report, a rating for each Core Web Vital and the fixes that matter first. Free.

Search competitors

POST /v1/competitors/discover

Who shares a site's Google search ground: how much of it each rival shares, whether it ranks higher, and how big its search reach is.

Your brands' AI visibility

GET /v1/projects/{project_id}/ai-visibility/sets

Read the AI visibility your Magister brands track: scores, mention and citation rates, share of voice and what changed. Free.

Turn a lead into a brand

POST /v1/projects

When a prospect signs, make their site a brand in Magister from the audit and check you already ran: the audit becomes its marketing plan and the check its first AI visibility history, with no second audit and no API credits. A brand your plan doesn't include answers with its price instead.

A site's pages

POST /v1/web/map

Every page a site lists in its sitemaps, or only those whose address has a word you pass: the inventory for a content audit or a crawl of your own.

Reports and webhooks

GET /v1/jobs/{job_id}/report

Slow work runs as a job. Poll it, or pass a webhook_url and get a signed callback. Every finished job has an HTML report and a share link that works for 30 days.

First call

A balance, a check, a result.

Send the key as a Bearer token. Up to 60 requests a minute and 5 running jobs per organization; every response says what it cost and what is left.

curl
export MAGISTER_API_KEY=mm_live_...

# Your API credit balance (free)
curl https://api.magistermarketing.com/v1/credits \
  -H "Authorization: Bearer $MAGISTER_API_KEY"

# Start an AI visibility check: a job, answered 202 with its job_id
curl https://api.magistermarketing.com/v1/ai-visibility/check \
  -H "Authorization: Bearer $MAGISTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com", "max_credits": 75}'

# Poll it until "status" is no longer "running"
curl https://api.magistermarketing.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $MAGISTER_API_KEY"

Node and Python versions, errors and webhook signatures are in the API docs. Prefer chat? The same checks run from Claude or ChatGPT through MCP.

For agencies

Know where a prospect stands before the call.

A domain in, a report out: run the check from your CRM or your own tools, for every lead, without anyone opening a dashboard.

  1. 1Your CRM gets a new lead with a website.
  2. 2Your code calls /v1/ai-visibility/check with the domain and two competitors, with a webhook_url.
  3. 3The webhook lands with the result and a share link to the report.
  4. 4The rep opens the call with where the prospect stands in AI answers, and what to fix first.

Want to see a result first? Run the free AI visibility check in your browser, no key needed.

Pricing

$0.02 a credit, prepaid.

Buy from $10 to $2,000 by card, with 10% more credits from $100 and 20% more from $500. Credits last 12 months, auto-recharge is optional, and a call that fails is not billed.

3 questions on the 3 default engines

about 22 credits

The same with Grok added

about 96 credits

The same on every engine

about 135 credits

3 questions on Claude alone

about 14 credits

AEO audit of a URL

free

Brand profile

about 2 credits

A site's pages

about 1 credit