# Check a domain's AI visibility (no brand needed): POST /v1/ai-visibility/check

Asks AI engines the questions a buyer would, and scores how often the domain is named, cited and ranked. Returns every answer with its sources, the competitors named, and a report link to share.

- Base URL: https://api.magistermarketing.com
- Auth: `Authorization: Bearer $MAGISTER_API_KEY` (a full key)
- Cost: about 22 for the default check (3 questions on the 3 default engines), measured per run; each answer costs what its engine does (`GET /v1/ai-visibility/engines`). Perplexity, asked only by name, adds about 5. OpenAI, asked only by name, adds about 10. Google AI Mode, asked only by name, adds about 4. Grok, asked only by name, adds about 74. Gemini (API), asked only by name, adds about 4. DeepSeek, asked only by name, adds about 3. Mistral, asked only by name, adds about 9. Meta Muse, asked only by name, adds about 4. An answer without web search costs a fraction of one with it
- 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 |
| domain | body | string | yes | The site whose brand to check, such as example.com.; at most 253 characters |
| brand_name | body | string | no | Defaults to the site's own name.; 1 to 100 characters |
| competitors | body | array of string | no | at most 20 items, each at most 100 characters |
| prompts | body | array of string | no | Up to 10 questions buyers ask; every engine is asked the same ones. Omitted: unbranded buyer questions are suggested from the site, as many as the most answers asked of any engine (3 by default); a site your organization checked before is asked the questions that check suggested, so repeat checks compare, until they are 30 days old (`prompts_suggested_at` in the result says when they were first suggested). A page's address (`medium.com/@brand`) always gets its own.; at most 10 items, each at most 500 characters |
| engines | body | array of object | no | Which engines to ask, each by name (`"openai"`) or with its own settings (`{"name": "openai", "answers": 5, "web_search": false}`). Omitted: the default engines (`GET /v1/ai-visibility/engines` marks them, with what each is, whether it searches and what it costs). The others are asked only by name.; at most 11 items |
| answers_per_engine | body | integer | no | How many of the questions each engine answers. Defaults to 3, or to every question in `prompts` when you send your own.; 1 to 10 |
| web_search | body | boolean | no | Whether the engines search the web for their answers. Omitted: each engine's default (the ChatGPT and Gemini apps, Google AI Mode, Claude, OpenAI, Perplexity and Grok search; Gemini's API, DeepSeek, Mistral and Meta answer from what the model knows). `true`: with no `engines`, only the engines that can search are asked. `false`: every engine that can answers without search, which leaves out Perplexity (it is a search engine) and the apps (they are read as a buyer uses them). An answer without search has no sources and costs less. |

## Request

```bash
curl -X POST https://api.magistermarketing.com/v1/ai-visibility/check \
  -H "Authorization: Bearer $MAGISTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"tally.so","engines":["chatgpt","gemini","claude","perplexity","openai"]}'
```

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

```json
{
  "job_id": "cc838f9f-4f8c-4c1a-9cb1-e9835e78cbe5",
  "kind": "ai_visibility_check",
  "status": "succeeded",
  "created_at": "2026-11-11T21:40:21.622813+00:00",
  "finished_at": "2026-11-11T21:41:26.877514+00:00",
  "credits_charged": 24.75,
  "result": {
    "domain": "tally.so",
    "brand_name": "Tally Forms",
    "score": 48,
    "mention_rate": 67,
    "citation_rate": 40,
    "average_position": 2.2,
    "answers": 15,
    "failed_answers": 0,
    "engines": [
      "chatgpt",
      "gemini",
      "claude",
      "perplexity",
      "openai"
    ],
    "by_engine": {
      "chatgpt": {
        "model": null,
        "score": 52,
        "answers": 3,
        "grounding": "live_search",
        "sentiment": {
          "neutral": 1,
          "negative": 0,
          "positive": 2
        },
        "web_search": true,
        "mention_rate": 100,
        "citation_rate": 67,
        "average_position": 2.7
      },
      "claude": {
        "model": "claude-haiku-5-5",
        "score": 54,
        "answers": 3,
        "grounding": "live_search",
        "sentiment": {
          "neutral": 0,
          "negative": 0,
          "positive": 2
        },
        "web_search": true,
        "mention_rate": 67,
        "citation_rate": 33,
        "average_position": 2
      }
    },
    "results": [
      {
        "cited": true,
        "model": null,
        "score": 71,
        "answer": "For a small business, I'd prioritize form builders that offer **free submissions, professional-looking forms, customer lead collection, conditional logic, and integrations** without forcing you to upgrade immediately.\n\nI've compared the strongest options available in November 2026. These are my top recommendations.\n\n# Best free form builders for small businesses\n\n\n\n\n\n(Best overall)\n\n**1\\.…",
        "engine": "chatgpt",
        "prompt": "Best free form builders for small businesses",
        "status": "ready",
        "branded": false,
        "seconds": 31.7,
        "named_as": null,
        "position": 1,
        "citations": [
          {
            "url": "https://tally.so/",
            "title": "Visit Tally",
            "domain": "tally.so",
            "snippet": null,
            "own_site": true
          },
          {
            "url": "https://forms.google.com/",
            "title": "Visit Google Forms",
            "domain": "google.com",
            "snippet": null,
            "own_site": false
          },
          {
            "url": "https://fillout.com/",
            "title": "Visit Fillout",
            "domain": "fillout.com",
            "snippet": null,
            "own_site": false
          }
        ],
        "mentioned": true,
        "sentiment": "positive",
        "web_search": true,
        "prompt_type": "pricing",
        "score_parts": {
          "depth": {
            "max": 15,
            "score": 15
          },
          "framing": {
            "max": 15,
            "score": 15
          },
          "accuracy": {
            "max": 5,
            "score": 5
          },
          "citation": {
            "max": 10,
            "score": 10
          },
          "visibility": {
            "max": 25,
            "score": 6
          },
          "competitive": {
            "max": 10,
            "score": 7
          },
          "recommendation": {
            "max": 20,
            "score": 13
          }
        },
        "brands_named": [
          "Fillout",
          "Stripe",
          "HubSpot Forms",
          "HubSpot",
          "Zoho Forms"
        ],
        "judge_reason": "Tally is the top-ranked, strongly praised choice, with specific features and a generous-free-plan recommendation alongside several other form builders.",
        "competitors_found": [],
        "competitors_named": [
          "Fillout",
          "HubSpot Forms",
          "Zoho Forms"
        ]
      },
      {
        "cited": true,
        "model": "claude-haiku-5-5",
        "score": 97,
        "answer": "Here are the strongest free options for small businesses in 2026. Most of the comparison sites that ranked these are run by form vendors, so check current limits on each pricing page before committing.\n\n1. **Tally (best overall for most small businesses).** One review says Tally is the best free form builder for small businesses because it has no form or response limits and includes payments,…",
        "engine": "claude",
        "prompt": "Best free form builders for small businesses",
        "status": "ready",
        "branded": false,
        "seconds": 19.3,
        "named_as": null,
        "position": 1,
        "citations": [
          {
            "url": "https://paperform.co/form-builders/best-form-builders-for-small-businesses/",
            "title": "Best Form Builders for Small Businesses in 2026",
            "domain": "paperform.co",
            "snippet": null,
            "own_site": false
          },
          {
            "url": "https://tally.so/help/best-free-online-form-builders",
            "title": "8 Best Free Form Builders in 2026 (Free Plans, Not Trials)",
            "domain": "tally.so",
            "snippet": null,
            "own_site": true
          },
          {
            "url": "https://fabric.so/comparison/best-free-form-builder",
            "title": "Best free form builder",
            "domain": "fabric.so",
            "snippet": null,
            "own_site": false
          }
        ],
        "mentioned": true,
        "sentiment": "positive",
        "web_search": true,
        "prompt_type": "pricing",
        "score_parts": {
          "depth": {
            "max": 15,
            "score": 15
          },
          "framing": {
            "max": 15,
            "score": 15
          },
          "accuracy": {
            "max": 5,
            "score": 5
          },
          "citation": {
            "max": 10,
            "score": 10
          },
          "visibility": {
            "max": 25,
            "score": 25
          },
          "competitive": {
            "max": 10,
            "score": 7
          },
          "recommendation": {
            "max": 20,
            "score": 20
          }
        },
        "brands_named": [
          "G2",
          "HubSpot Forms",
          "Wufoo",
          "Cognito Forms",
          "Stripe"
        ],
        "judge_reason": "Tally gets detailed, strongly positive coverage as the best overall option and the explicit final pick, alongside relevant form-builder alternatives.",
        "competitors_found": [],
        "competitors_named": [
          "HubSpot Forms",
          "Wufoo",
          "Cognito Forms",
          "Fillout",
          "forms.app"
        ]
      }
    ],
    "questions": [
      {
        "type": "pricing",
        "score": 85,
        "prompt": "Best free form builders for small businesses",
        "answers": 5,
        "branded": false,
        "cited_in": 5,
        "brands_named": [
          "Fillout",
          "Stripe",
          "HubSpot Forms",
          "Zoho Forms",
          "Google Workspace"
        ],
        "mentioned_in": 5,
        "best_position": 1,
        "searched_answers": 5,
        "competitors_named": [
          "Fillout",
          "HubSpot Forms",
          "Zoho Forms",
          "Cognito Forms",
          "Wufoo"
        ]
      }
    ],
    "competitors": [
      {
        "name": "Fillout",
        "mentions": 7,
        "answer_share": 47
      },
      {
        "name": "Microsoft Forms",
        "mentions": 3,
        "answer_share": 20
      },
      {
        "name": "Zoho Forms",
        "mentions": 3,
        "answer_share": 20
      }
    ],
    "citation_opportunities": [
      {
        "domain": "hubspot.com",
        "answers": 3,
        "examples": [
          {
            "url": "https://blog.hubspot.com/marketing/form-builder-tools?region=united-states",
            "title": "HubSpot's form builder guide"
          }
        ]
      }
    ]
  }
}
```

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