ai-visibility-check

{'type': 'object', 'required': ['domain', 'queries'], 'properties': {'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.'}, 'domain': {'type': 'string', 'description': 'Business website domain, e.g. acme-plumbing.com'}, 'queries': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 5, 'minItems': 1, 'description': '1-5 customer-intent questions to test (without the business name)'}, 'business_name': {'type': 'string', 'description': 'Business name as customers say it (improves mention detection)'}}}

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