{"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"}}}},"/bulk":{"get":{"operationId":"getBulkTemplate","summary":"Download the CSV template for a type: every accepted column, with the example as the first row","parameters":[{"name":"type","in":"query","required":true,"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"]}}],"responses":{"200":{"description":"CSV template","content":{"text/csv":{"schema":{"type":"string"}}}},"400":{"description":"Unknown type"}}},"post":{"operationId":"generateSchemaBulk","summary":"Generate JSON-LD for every row of a CSV (up to 1,000 rows), checked against Google's requirements","description":"Columns are field names. Group sub-fields join with a dot (offers.price), numbered entries of a list of groups use offers.1.price style names, and list cells separate values with |. Comma, semicolon, and tab delimiters are detected.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["type","csv"],"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"]},"csv":{"type":"string","description":"Header row, then one row per item."}}},"example":{"type":"product","csv":"name,offers.price,offers.priceCurrency,offers.availability\nTrail Runner 2,129.00,EUR,InStock\n"}}}},"responses":{"200":{"description":"One result per row: row number, ok, jsonld, and issues; plus a summary and unknownColumns"},"400":{"description":"Unknown type, unusable CSV, or more than 1,000 rows"},"413":{"description":"Body larger than 2 MB"}}}},"/validate":{"post":{"operationId":"validateMarkup","summary":"Check a page, HTML, or JSON-LD against the full Schema.org vocabulary","description":"Send exactly one of url (a public page to fetch), html (JSON-LD scripts, Microdata and RDFa are read), or jsonld. Each item found is returned with its own issues; the top-level issues list has them all, with item pointing into items.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"A public http or https page to fetch."},"html":{"type":"string","description":"HTML to read JSON-LD, Microdata and RDFa from."},"jsonld":{"description":"A JSON-LD object or array, or a string of JSON or HTML."}}},"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","items","issues","problems","counts"],"properties":{"valid":{"type":"boolean"},"items":{"type":"array","items":{"type":"object","properties":{"format":{"type":"string","enum":["json-ld","microdata","rdfa"]},"line":{"type":"integer"},"types":{"type":"array","items":{"type":"string"}},"data":{"type":"object"},"issues":{"type":"array"}}}},"problems":{"type":"array","description":"Markup that could not be read, such as invalid JSON."},"counts":{"type":"object"},"source":{"type":"object","description":"Set for url requests: url, finalUrl, status."},"issues":{"type":"array","items":{"type":"object","required":["level","path","message","item"],"properties":{"item":{"type":"integer"},"level":{"type":"string","enum":["error","warning"]},"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"400":{"description":"The body is not valid JSON, or the URL is not a public http(s) page"},"502":{"description":"The page could not be fetched or answered with an error"}}}},"/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"}