radveo

{'type': 'object', 'properties': {'website': {'type': 'string', 'description': 'The business website URL, e.g. https://joesplumbing.com. Optional if business_name is given; improves accuracy.'}, 'location': {'type': 'string', 'description': 'City or region, e.g. "Seattle, WA". Optional but improves accuracy.'}, 'business_name': {'type': 'string', 'description': 'The business name, e.g. "Joe\'s Plumbing". Provide this OR a website.'}}}

{'type': 'object', 'required': ['ok', 'verdict', 'reportUrl', 'note'], 'properties': {'ok': {'type': 'boolean', 'description': 'False when the check could not be completed (bad input, rate limit, or the audit engine timed out).'}, 'note': {'type': 'string', 'description': 'Honesty framing: an indicative, measured read of how AI assistants tend to answer, never a guarantee of placement.'}, 'verdict': {'enum': ['named', 'absent', 'unknown', 'not_checked'], 'type': 'string', 'description': "Whether AI engines named this business when asked customer-style recommendation questions. 'named' = at least one query named it; 'absent' = confidently not named; 'unknown' = the engines could not give a confident read; 'not_checked' = the live AI-answer probe did not run for this call (the on-page audit still did)."}, 'business': {'type': ['string', 'null'], 'description': 'The business name or website that was checked.'}, 'seoGrade': {'type': ['string', 'null'], 'description': 'Letter grade (A-D) for the readiness score, when measured.'}, 'seoScore': {'type': ['number', 'null'], 'description': '0-100 on-page AI-visibility readiness score, when measured.'}, 'topFixes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The top fixes to improve the odds of being named (max 3 here; full list in the report).'}, 'reportUrl': {'type': 'string', 'description': 'Free, shareable, public report URL for this check.'}, 'enginesChecked': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The AI engine panel the probes consult: an indicative read of how AI assistants tend to answer, not a live probe of every public engine.'}, 'queriesChecked': {'type': 'array', 'items': {'type': 'string'}, 'description': "The customer-style questions asked to the AI engines (empty when the probe didn't run)."}, 'competitorsNamed': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Businesses surfaced instead of this one (deduped). Same list the public shareable report shows.'}, 'aiVisibilityScore': {'type': ['number', 'null'], 'description': "0-100: the share of customer-style AI queries that named the business. Null when the probe didn't produce a measured score."}, 'competitorsSource': {'enum': ['ai', 'places', None], 'type': ['string', 'null'], 'description': "'ai' = an AI engine named them; 'places' = real local leaders from Google's local results (shown when the engines named none). Null when no competitors surfaced."}}}

{'type': 'object', 'properties': {}}

{'type': 'object', 'required': ['ok', 'steps', 'note', 'freeCheckUrl'], 'properties': {'ok': {'type': 'boolean'}, 'note': {'type': 'string', 'description': 'Honesty framing: these steps improve odds, they never guarantee placement.'}, 'steps': {'type': 'array', 'items': {'type': 'string'}, 'description': 'The AEO steps, in order. Empty only when the server is rate-limiting.'}, 'freeCheckUrl': {'type': 'string', 'description': 'Where to run the free AI-visibility check.'}}}