{"components":{"schemas":{"Envelope":{"additionalProperties":true,"description":"Generic object envelope. Endpoint-specific fields are documented in MechaReg contracts.","type":"object"},"Error":{"properties":{"error":{"type":"string"},"message":{"type":"string"}},"type":"object"}}},"info":{"contact":{"email":"ai@mechareg.com","url":"https://mechareg.com/ai"},"description":"Public read API and machine contracts for MechaReg integrations.","title":"MechaReg Open API","version":"v1"},"openapi":"3.1.0","paths":{"/ai.json":{"get":{"operationId":"getAIManifest","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Canonical manifest"}},"summary":"Get canonical AI manifest"}},"/api/v1/analytics/companies/{slug}/aiseo":{"get":{"operationId":"getCompanyAISEO","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"AISEO metrics"}},"summary":"Get AISEO visibility metrics for company"}},"/api/v1/analytics/companies/{slug}/anomalies":{"get":{"operationId":"getCompanyAnomalies","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Anomaly metrics"}},"summary":"Get detected crawl anomalies for company"}},"/api/v1/analytics/companies/{slug}/dashboard":{"get":{"operationId":"getCompanyAnalyticsDashboard","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Dashboard payload"}},"summary":"Get combined analytics dashboard payload"}},"/api/v1/analytics/companies/{slug}/traffic-summary":{"get":{"operationId":"getCompanyTrafficSummary","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}},{"in":"query","name":"days","required":false,"schema":{"type":"integer"}},{"in":"query","name":"from","required":false,"schema":{"format":"date-time","type":"string"}},{"in":"query","name":"to","required":false,"schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Company traffic summary"}},"summary":"Get company traffic summary with human and bot classification"}},"/api/v1/analytics/traffic/summary":{"get":{"operationId":"getTrafficSummary","parameters":[{"in":"query","name":"days","required":false,"schema":{"type":"integer"}},{"in":"query","name":"from","required":false,"schema":{"format":"date-time","type":"string"}},{"in":"query","name":"to","required":false,"schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Traffic summary"}},"summary":"Get global traffic summary with human and bot classification"}},"/api/v1/companies/{origin}":{"get":{"operationId":"getCompanyBySlug","parameters":[{"in":"path","name":"origin","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Company profile"}},"summary":"Get canonical company summary"}},"/api/v1/meta/homepage-contract":{"get":{"operationId":"getHomepageContract","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Homepage contract"}},"summary":"Get machine-readable homepage contract"}},"/api/v1/meta/policies":{"get":{"operationId":"getMetaPolicies","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Policy metadata"}},"summary":"Get API policy metadata"}},"/api/v1/search":{"get":{"operationId":"searchCompanies","parameters":[{"in":"query","name":"q","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Search results"}},"summary":"Search public company knowledge"}},"/{origin}":{"get":{"operationId":"getCompanyPage","responses":{"200":{"description":"Company HTML"}},"summary":"Get canonical company page"}},"/{origin}.json":{"get":{"operationId":"getCompanyProfileJSON","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Company JSON profile"}},"summary":"Get canonical company JSON profile"}},"/{origin}.toon":{"get":{"operationId":"getCompanyProfileToon","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}},"description":"Company Toon profile"}},"summary":"Get compact Toon company profile"}}},"servers":[{"description":"Production","url":"https://mechareg.com"}]}