Magister API

Account and jobs

Poll a job

GEThttps://api.magistermarketing.com/v1/jobs/{job_id}

A job you started: its status and, once it finishes, its result. Poll it, or pass webhook_url when you start the job.

Cost
Free
Runs
At once
Key
Any key
Holds up to
Nothing

Parameters

NameTypeAbout
job_idrequiredstring · path

Request

curl https://api.magistermarketing.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $MAGISTER_API_KEY"

Response

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

A real call from a test organization, 2026-11-11. The finished AI visibility check, trimmed.