{"schema_version":"2026-06-13","provider":"OSPEA","observation_schema":{"required_fields":["provider/platform","exact_prompt","model_version","timestamp","full_answer_text","citation_urls","normalized_citation_domains","source_class","brand_mentioned","brand_cited","mention_position","competitors_mentioned","competitors_cited","prompt_cluster","run_type","cost_cents","latency_ms","scan_status"],"run_types":["api-grounded","browser/manual","first-party-feed"],"scan_status_values":["ok","error","timeout"]},"model_defaults":{"selection_policy":"Use the default model for recurring visibility scans unless the workspace owner explicitly requests a premium or experimental model.","providers":[{"provider":"openai","platform":"chatgpt","default_model":"gpt-5.4-mini","premium_model":"gpt-5.5","required_configuration":"OPENAI_API_KEY"},{"provider":"anthropic","platform":"claude","default_model":"claude-sonnet-4-6","premium_model":"claude-opus-4-8","required_configuration":"ANTHROPIC_API_KEY"},{"provider":"google","platform":"gemini","default_model":"gemini-3.5-flash","required_configuration":"GEMINI_USE_VERTEX with GCP project/location credentials, or GEMINI_API_KEY fallback"},{"provider":"perplexity","platform":"perplexity","default_model":"sonar-pro","required_configuration":"PERPLEXITY_API_KEY"},{"provider":"deepseek","platform":"deepseek","default_model":"deepseek-v4-flash","premium_model":"deepseek-v4-pro","required_configuration":"DEEPSEEK_API_KEY"}]},"source_classes":["own-domain","competitor-owned","review","video","social-forum","directory","marketplace","earned-media","docs","unknown","none"],"capabilities":[{"id":"ai_visibility_share_of_voice","status":"available","method":"GET","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/share-of-voice","input_schema":{"days":"integer 1..365","start_date":"YYYY-MM-DD optional","end_date":"YYYY-MM-DD optional","platforms":"repeatable string query parameter optional","prompt_clusters":"repeatable string query parameter optional"},"output":"Weekly entity share-of-voice by platform, prompt cluster, source class, citation class, success count, failure count, mentions, citations, and visibility score.","safe_for_agents":true,"mutates_state":false},{"id":"weekly_aio_report","status":"available","method":"GET","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/weekly-aio-report","input_schema":{"days":"integer 1..365","start_date":"YYYY-MM-DD optional","end_date":"YYYY-MM-DD optional"},"output":"Unified weekly AIO report joining OSPEA AI scans, Google Search Console, and Bing AI Performance imports.","safe_for_agents":true,"mutates_state":false},{"id":"weekly_aio_report_export","status":"available","method":"GET","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/weekly-aio-report/export","input_schema":{"format":"csv or json","days":"integer 1..365","start_date":"YYYY-MM-DD optional","end_date":"YYYY-MM-DD optional"},"output":"Downloadable weekly AIO report export.","safe_for_agents":true,"mutates_state":false},{"id":"prompt_library","status":"available","method":"GET/POST/PATCH/DELETE","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/library","output":"SavedPrompt rows used by repeatable OSPEA AI visibility scans.","safe_for_agents":"read endpoints are safe; writes require user authorization","mutates_state":"POST/PATCH/DELETE"},{"id":"competitor_tracking","status":"available","method":"GET/POST/PATCH/DELETE","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/competitors","output":"Tracked competitor entities used in AI visibility scans and share-of-voice reporting.","safe_for_agents":"read endpoints are safe; writes require user authorization","mutates_state":"POST/PATCH/DELETE"},{"id":"manual_visibility_scan","status":"available","method":"POST","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/scan","output":"Queues a workspace visibility scan using enabled providers. Claude web-search scans are opt-in because they consume higher provider budget.","safe_for_agents":false,"mutates_state":true,"guardrails":["respect scan cadence","confirm workspace owner approval","check scan/status before retrying"]},{"id":"visibility_scan_status","status":"available","method":"GET","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/scan/status","output":"Refresh-safe scan progress with expected snapshot total, latest update, and progress percentage.","safe_for_agents":true,"mutates_state":false},{"id":"bing_ai_performance_import","status":"available","method":"POST","endpoint":"https://api.ospea.io/api/v1/workspaces/{workspace_id}/monitoring/first-party/bing-ai-performance/import","output":"Imports exported Bing Webmaster Tools AI Performance rows as first-party citation data for weekly AIO reporting.","safe_for_agents":false,"mutates_state":true,"guardrails":["validate row dates","preserve source filename","do not fabricate first-party metrics"]},{"id":"geo_audit","status":"available","method":"GET","endpoint":"https://api.ospea.io/api/v1/aio/geo-audit","input_schema":{"url":"website URL to audit, e.g. https://example.com"},"output":"Public agent-readiness and GEO audit checks for a website.","safe_for_agents":true,"mutates_state":false}],"capability_boundaries":{"available_now":["workspace-scoped AI visibility share-of-voice reports","weekly AIO report and CSV/JSON export","SavedPrompt library and competitor tracking","manual visibility scans when provider credentials and budget are configured","Bing Webmaster Tools AI Performance export import","durable landing page creation, rendering, publishing, and view tracking"],"not_available_until_durable_storage":[{"surface":"editorial backlink marketplace","endpoints":["/backlinks/editorial/*"],"reason":"publisher, placement, attribution, and consent storage is not enabled"},{"surface":"managed link exchange workflows","endpoints":["/backlinks/exchange/sites","/backlinks/exchange/matches","/backlinks/exchange/initiate"],"reason":"exchange site, match, consent, and rate-limit storage is not enabled"},{"surface":"landing page form submissions","endpoints":["/landing-pages/{page_id}/submissions","/landing-pages/{page_id}/submit"],"reason":"durable lead submission storage is not enabled"},{"surface":"batch SERP scraping","endpoints":["/api/v1/serp/scrape/batch"],"reason":"durable job persistence and progress tracking are not enabled"},{"surface":"legacy onboarding website scan jobs","endpoints":["/workspaces/{workspace_id}/onboarding/scan","/workspaces/{workspace_id}/onboarding/scan/{job_id}"],"reason":"durable scan job storage and progress tracking are not enabled"}]}}