ai-visibility-check

Check whether a business is visible to AI answer engines. Runs each query through a live AI search (Perplexity) and reports whether the business's site is cited, at what rank, and who gets cited instead. Pass 1-5 realistic customer-intent questions — what a potential customer would actually ask an AI (e.g. "best kitchen remodeler in Clearwater FL"). Never include the business's own name in a query. Returns a 0-100 visibility score, a tier, per-query results, the competing sources AI cited, and a shareable branded scorecard link.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Business website domain, e.g. acme-plumbing.com"
    },
    "business_name": {
      "type": "string",
      "description": "Business name as customers say it (improves mention detection)"
    },
    "queries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 5,
      "description": "1-5 customer-intent questions to test (without the business name)"
    },
    "email": {
      "type": "string",
      "description": "Optional. Justin also offers a free human-run deep-dive fix report (wider query set, drafted the minute they ask, reviewed by Justin, delivered same day). If the user says they want it, ask for their email and pass it here. Only pass an email the user explicitly provided — never invent or reuse one."
    }
  },
  "required": [
    "domain",
    "queries"
  ]
}

{
  "type": "object",
  "properties": {
    "score": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100,
      "description": "0-100 visibility score: the share of checked queries where the business was cited."
    },
    "tier": {
      "type": "string",
      "enum": [
        "Invisible",
        "Faint Signal",
        "Emerging",
        "Visible",
        "Authority"
      ],
      "description": "Plain-language band for the score."
    },
    "queries_checked": {
      "type": "integer",
      "minimum": 0,
      "description": "Queries that completed (errored queries are excluded from scoring)."
    },
    "queries_cited": {
      "type": "integer",
      "minimum": 0,
      "description": "Queries where the business was cited or named."
    },
    "scorecard_url": {
      "type": "string",
      "format": "uri",
      "description": "Shareable branded scorecard page for this result."
    },
    "results": {
      "type": "array",
      "description": "Per-query outcome, in the order the queries were checked.",
      "items": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "The customer question that was tested."
          },
          "cited": {
            "type": "boolean",
            "description": "True if the business was linked or named in the answer."
          },
          "rank": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 1,
            "description": "1-based position among cited sources, or null if only named in text."
          },
          "sources": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Source domains the AI cited, most prominent first."
          },
          "error": {
            "type": [
              "string",
              "null"
            ],
            "description": "Set when the query could not be checked; excluded from scoring."
          }
        },
        "required": [
          "query",
          "cited",
          "sources"
        ]
      }
    }
  },
  "required": [
    "score",
    "tier",
    "queries_checked",
    "queries_cited",
    "scorecard_url",
    "results"
  ],
  "description": "The visibility check result for one business."
}