{"openapi":"3.1.0","info":{"title":"Schema Generator API","version":"1.9.0","description":"Generate Schema.org JSON-LD over HTTP and check it against Google's documented rich-result requirements. Same builders as the web generators. No authentication."},"servers":[{"url":"https://schemagenerator.dev/api/v1"}],"paths":{"/health":{"get":{"operationId":"getHealth","summary":"Service health check","responses":{"200":{"description":"Service is available"}}}},"/schema-types":{"get":{"operationId":"listSchemaTypes","summary":"List supported schema types, or describe one with ?type=","parameters":[{"name":"type","in":"query","required":false,"schema":{"type":"string","enum":["organization","localBusiness","product","article","website","breadcrumb","carousel","person","event","recipe","jobPosting","videoObject","review","softwareApplication","returnPolicy","shippingPolicy","loyaltyProgram","discussionForum","qaPage","dataset","imageLicense","employerRating","movie","faq","course","mathSolver","flashcards"]},"description":"Return the fields, Google tiers, and an example input for this type."}],"responses":{"200":{"description":"Schema types or field list"}}}},"/validate":{"post":{"operationId":"validateJsonLd","summary":"Check any JSON-LD against the full Schema.org vocabulary","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonld"],"properties":{"jsonld":{"description":"A JSON-LD object or array, or a string of JSON or script tags."}}},"example":{"jsonld":{"@context":"https://schema.org","@type":"Restaurant","name":"Trattoria Roma","servesCuisine":"Italian"}}}}},"responses":{"200":{"description":"Vocabulary issues; valid is true when there are no errors","content":{"application/json":{"schema":{"type":"object","required":["valid","issues"],"properties":{"valid":{"type":"boolean"},"issues":{"type":"array","items":{"type":"object","required":["level","path","message"],"properties":{"level":{"type":"string","enum":["error","warning"]},"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"400":{"description":"The body or the markup is not valid JSON"}}}},"/generate":{"post":{"operationId":"generateSchema","summary":"Generate JSON-LD from field values","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["type","data"],"properties":{"type":{"type":"string","enum":["organization","localBusiness","product","article","website","breadcrumb","carousel","person","event","recipe","jobPosting","videoObject","review","softwareApplication","returnPolicy","shippingPolicy","loyaltyProgram","discussionForum","qaPage","dataset","imageLicense","employerRating","movie","faq","course","mathSolver","flashcards"]},"data":{"type":"object"}}},"example":{"type":"organization","data":{"name":"Northwind Studio","url":"https://northwind.example"}}}}},"responses":{"200":{"description":"Generated JSON-LD, a <script> tag, and issues found by the Google checks","content":{"application/json":{"schema":{"type":"object","required":["type","jsonld","scriptTag","issues","missingRequiredFields","ok"],"properties":{"type":{"type":"string"},"jsonld":{"type":"object"},"scriptTag":{"type":"string"},"issues":{"type":"array","items":{"type":"object","required":["level","message"],"properties":{"level":{"type":"string","enum":["error","warning"]},"field":{"type":"string"},"message":{"type":"string"}}}},"missingRequiredFields":{"type":"array","items":{"type":"string"}},"ok":{"type":"boolean","description":"True when there are no error-level issues."}}}}}},"400":{"description":"Unknown type or invalid body"}}}}},"x-mcp-endpoint":"https://schemagenerator.dev/api/mcp"}