{"openapi":"3.1.0","info":{"title":"Sitemap XML Parse and Publication Guard API","version":"1.0.0","description":"Inspect and parse bounded caller-supplied Sitemap protocol XML, build URL-set and sitemap-index documents, compare snapshots, and apply explicit publication policy. The API fetches no URL, crawls no site, accesses no search-engine account, submits or publishes no sitemap, guarantees no indexing, and stores no payload."},"paths":{"/marketplace/rapid/sitemap/v1/inspect":{"post":{"tags":["Sitemap Inspection"],"summary":"Inspect Sitemap XML","operationId":"inspectSitemapXml","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SitemapXmlRequest"},"examples":{"example":{"summary":"Inspect Sitemap XML","value":{"content":"<?xml version=\"1.0\" encoding=\"UTF-8\"?><urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\"><url><loc>https://example.com/</loc><lastmod>2026-08-10</lastmod></url></urlset>"}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SitemapInspectionResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/rapid/sitemap/v1/parse":{"post":{"tags":["Sitemap Parsing"],"summary":"Parse Sitemap XML","operationId":"parseSitemapXml","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseSitemapRequest"},"examples":{"example":{"summary":"Parse Sitemap XML","value":{"content":"<?xml version=\"1.0\" encoding=\"UTF-8\"?><urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\"><url><loc>https://example.com/</loc><lastmod>2026-08-10</lastmod></url></urlset>","maximum_returned_entries":1000}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SitemapParseResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/rapid/sitemap/v1/build-urlset":{"post":{"tags":["URL Set Builder"],"summary":"Build Sitemap URL Set","operationId":"buildSitemapUrlset","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuildUrlsetRequest"},"examples":{"example":{"summary":"Build Sitemap URL Set","value":{"entries":[{"loc":"https://example.com/","lastmod":"2026-08-10"}]}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SitemapBuildResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/rapid/sitemap/v1/build-index":{"post":{"tags":["Sitemap Index Builder"],"summary":"Build Sitemap Index","operationId":"buildSitemapIndex","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BuildIndexRequest"},"examples":{"example":{"summary":"Build Sitemap Index","value":{"entries":[{"loc":"https://example.com/sitemap-1.xml","lastmod":"2026-08-10"}]}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SitemapBuildResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/rapid/sitemap/v1/compare":{"post":{"tags":["Sitemap Comparison"],"summary":"Compare Sitemap XML","operationId":"compareSitemapXml","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompareSitemapsRequest"},"examples":{"example":{"summary":"Compare Sitemap XML","value":{"before":"<?xml version=\"1.0\" encoding=\"UTF-8\"?><urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\"><url><loc>https://example.com/</loc><lastmod>2026-08-10</lastmod></url></urlset>","after":"<?xml version=\"1.0\" encoding=\"UTF-8\"?><urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\"><url><loc>https://example.com/</loc><lastmod>2026-08-10</lastmod></url></urlset>","maximum_changes":1000}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SitemapCompareResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/marketplace/rapid/sitemap/v1/policy-check":{"post":{"tags":["Sitemap Publication Policy"],"summary":"Check Sitemap Policy","operationId":"checkSitemapPolicy","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SitemapPolicyRequest"},"examples":{"example":{"summary":"Check Sitemap Policy","value":{"content":"<?xml version=\"1.0\" encoding=\"UTF-8\"?><sitemapindex xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\"><sitemap><loc>https://example.com/sitemap-1.xml</loc><lastmod>2026-08-10</lastmod></sitemap></sitemapindex>","required_document_type":"SITEMAP_INDEX","require_https":true,"require_single_host":true,"allowed_hosts":["example.com"],"require_lastmod":true,"evaluated_at":"2026-08-11T12:00:00Z","maximum_entries":10000,"document_url":"https://example.com/sitemap.xml","require_index_same_host":true}}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SitemapPolicyResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"BuildIndexEntry":{"properties":{"loc":{"type":"string","maxLength":2048,"minLength":1,"title":"Loc"},"lastmod":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Lastmod"}},"additionalProperties":false,"type":"object","required":["loc"],"title":"BuildIndexEntry"},"BuildIndexRequest":{"properties":{"entries":{"items":{"$ref":"#/components/schemas/BuildIndexEntry"},"type":"array","maxItems":5000,"minItems":1,"title":"Entries"}},"additionalProperties":false,"type":"object","required":["entries"],"title":"BuildIndexRequest"},"BuildUrlEntry":{"properties":{"loc":{"type":"string","maxLength":2048,"minLength":1,"title":"Loc"},"lastmod":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Lastmod"},"changefreq":{"anyOf":[{"type":"string","maxLength":16},{"type":"null"}],"title":"Changefreq"},"priority":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Priority"}},"additionalProperties":false,"type":"object","required":["loc"],"title":"BuildUrlEntry"},"BuildUrlsetRequest":{"properties":{"entries":{"items":{"$ref":"#/components/schemas/BuildUrlEntry"},"type":"array","maxItems":5000,"minItems":1,"title":"Entries"}},"additionalProperties":false,"type":"object","required":["entries"],"title":"BuildUrlsetRequest"},"CompareSitemapsRequest":{"properties":{"before":{"type":"string","minLength":1,"title":"Before"},"after":{"type":"string","minLength":1,"title":"After"},"maximum_changes":{"type":"integer","maximum":2000.0,"minimum":1.0,"title":"Maximum Changes","default":1000}},"additionalProperties":false,"type":"object","required":["before","after"],"title":"CompareSitemapsRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ParseSitemapRequest":{"properties":{"content":{"type":"string","minLength":1,"title":"Content"},"maximum_returned_entries":{"type":"integer","maximum":2000.0,"minimum":1.0,"title":"Maximum Returned Entries","default":1000}},"additionalProperties":false,"type":"object","required":["content"],"title":"ParseSitemapRequest"},"SitemapBuildResult":{"properties":{"status":{"type":"string","const":"COMPLETED","title":"Status","default":"COMPLETED"},"ruleset_version":{"type":"string","const":"SITEMAP_PROTOCOL_0_9_2026","title":"Ruleset Version","default":"SITEMAP_PROTOCOL_0_9_2026"},"scope":{"type":"string","const":"CALLER_SUPPLIED_SITEMAP_XML_ONLY","title":"Scope","default":"CALLER_SUPPLIED_SITEMAP_XML_ONLY"},"network_accessed":{"type":"boolean","const":false,"title":"Network Accessed","default":false},"url_fetched":{"type":"boolean","const":false,"title":"Url Fetched","default":false},"search_console_accessed":{"type":"boolean","const":false,"title":"Search Console Accessed","default":false},"sitemap_published":{"type":"boolean","const":false,"title":"Sitemap Published","default":false},"indexing_guaranteed":{"type":"boolean","const":false,"title":"Indexing Guaranteed","default":false},"payload_stored":{"type":"boolean","const":false,"title":"Payload Stored","default":false},"decision":{"type":"string","enum":["CLEAR","REVIEW_REQUIRED","BLOCKED"],"title":"Decision"},"document_type":{"type":"string","enum":["URLSET","SITEMAP_INDEX"],"title":"Document Type"},"entry_count":{"type":"integer","title":"Entry Count"},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content"},"byte_count":{"type":"integer","title":"Byte Count"},"sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sha256"},"findings":{"items":{"$ref":"#/components/schemas/SitemapIssue"},"type":"array","title":"Findings"},"next_action":{"type":"string","title":"Next Action"}},"type":"object","required":["decision","document_type","entry_count","content","byte_count","sha256","findings","next_action"],"title":"SitemapBuildResult"},"SitemapChange":{"properties":{"loc":{"type":"string","title":"Loc"},"changed_fields":{"items":{"type":"string"},"type":"array","title":"Changed Fields"},"before":{"anyOf":[{"$ref":"#/components/schemas/SitemapEntry"},{"type":"null"}]},"after":{"anyOf":[{"$ref":"#/components/schemas/SitemapEntry"},{"type":"null"}]}},"type":"object","required":["loc","changed_fields"],"title":"SitemapChange"},"SitemapCompareResult":{"properties":{"status":{"type":"string","const":"COMPLETED","title":"Status","default":"COMPLETED"},"ruleset_version":{"type":"string","const":"SITEMAP_PROTOCOL_0_9_2026","title":"Ruleset Version","default":"SITEMAP_PROTOCOL_0_9_2026"},"scope":{"type":"string","const":"CALLER_SUPPLIED_SITEMAP_XML_ONLY","title":"Scope","default":"CALLER_SUPPLIED_SITEMAP_XML_ONLY"},"network_accessed":{"type":"boolean","const":false,"title":"Network Accessed","default":false},"url_fetched":{"type":"boolean","const":false,"title":"Url Fetched","default":false},"search_console_accessed":{"type":"boolean","const":false,"title":"Search Console Accessed","default":false},"sitemap_published":{"type":"boolean","const":false,"title":"Sitemap Published","default":false},"indexing_guaranteed":{"type":"boolean","const":false,"title":"Indexing Guaranteed","default":false},"payload_stored":{"type":"boolean","const":false,"title":"Payload Stored","default":false},"decision":{"type":"string","enum":["CLEAR","REVIEW_REQUIRED","BLOCKED"],"title":"Decision"},"document_type":{"type":"string","enum":["URLSET","SITEMAP_INDEX"],"title":"Document Type"},"before_entry_count":{"type":"integer","title":"Before Entry Count"},"after_entry_count":{"type":"integer","title":"After Entry Count"},"added_count":{"type":"integer","title":"Added Count"},"removed_count":{"type":"integer","title":"Removed Count"},"modified_count":{"type":"integer","title":"Modified Count"},"changes":{"items":{"$ref":"#/components/schemas/SitemapChange"},"type":"array","title":"Changes"},"changes_truncated":{"type":"boolean","title":"Changes Truncated"},"findings":{"items":{"$ref":"#/components/schemas/SitemapIssue"},"type":"array","title":"Findings"},"next_action":{"type":"string","title":"Next Action"}},"type":"object","required":["decision","document_type","before_entry_count","after_entry_count","added_count","removed_count","modified_count","changes","changes_truncated","findings","next_action"],"title":"SitemapCompareResult"},"SitemapEntry":{"properties":{"loc":{"type":"string","title":"Loc"},"lastmod":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lastmod"},"changefreq":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Changefreq"},"priority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Priority"},"extension_names":{"items":{"type":"string"},"type":"array","title":"Extension Names"}},"type":"object","required":["loc"],"title":"SitemapEntry"},"SitemapInspectionResult":{"properties":{"status":{"type":"string","const":"COMPLETED","title":"Status","default":"COMPLETED"},"ruleset_version":{"type":"string","const":"SITEMAP_PROTOCOL_0_9_2026","title":"Ruleset Version","default":"SITEMAP_PROTOCOL_0_9_2026"},"scope":{"type":"string","const":"CALLER_SUPPLIED_SITEMAP_XML_ONLY","title":"Scope","default":"CALLER_SUPPLIED_SITEMAP_XML_ONLY"},"network_accessed":{"type":"boolean","const":false,"title":"Network Accessed","default":false},"url_fetched":{"type":"boolean","const":false,"title":"Url Fetched","default":false},"search_console_accessed":{"type":"boolean","const":false,"title":"Search Console Accessed","default":false},"sitemap_published":{"type":"boolean","const":false,"title":"Sitemap Published","default":false},"indexing_guaranteed":{"type":"boolean","const":false,"title":"Indexing Guaranteed","default":false},"payload_stored":{"type":"boolean","const":false,"title":"Payload Stored","default":false},"decision":{"type":"string","enum":["CLEAR","REVIEW_REQUIRED","BLOCKED"],"title":"Decision"},"document_type":{"type":"string","enum":["URLSET","SITEMAP_INDEX"],"title":"Document Type"},"byte_count":{"type":"integer","title":"Byte Count"},"entry_count":{"type":"integer","title":"Entry Count"},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace"},"hostnames":{"items":{"type":"string"},"type":"array","title":"Hostnames"},"duplicate_location_count":{"type":"integer","title":"Duplicate Location Count"},"entries_with_lastmod":{"type":"integer","title":"Entries With Lastmod"},"extension_names":{"items":{"type":"string"},"type":"array","title":"Extension Names"},"findings":{"items":{"$ref":"#/components/schemas/SitemapIssue"},"type":"array","title":"Findings"},"next_action":{"type":"string","title":"Next Action"}},"type":"object","required":["decision","document_type","byte_count","entry_count","namespace","hostnames","duplicate_location_count","entries_with_lastmod","extension_names","findings","next_action"],"title":"SitemapInspectionResult"},"SitemapIssue":{"properties":{"code":{"type":"string","title":"Code"},"severity":{"type":"string","enum":["LOW","MEDIUM","HIGH"],"title":"Severity"},"message":{"type":"string","title":"Message"},"evidence":{"additionalProperties":true,"type":"object","title":"Evidence"},"next_action":{"type":"string","title":"Next Action"}},"type":"object","required":["code","severity","message","evidence","next_action"],"title":"SitemapIssue"},"SitemapParseResult":{"properties":{"status":{"type":"string","const":"COMPLETED","title":"Status","default":"COMPLETED"},"ruleset_version":{"type":"string","const":"SITEMAP_PROTOCOL_0_9_2026","title":"Ruleset Version","default":"SITEMAP_PROTOCOL_0_9_2026"},"scope":{"type":"string","const":"CALLER_SUPPLIED_SITEMAP_XML_ONLY","title":"Scope","default":"CALLER_SUPPLIED_SITEMAP_XML_ONLY"},"network_accessed":{"type":"boolean","const":false,"title":"Network Accessed","default":false},"url_fetched":{"type":"boolean","const":false,"title":"Url Fetched","default":false},"search_console_accessed":{"type":"boolean","const":false,"title":"Search Console Accessed","default":false},"sitemap_published":{"type":"boolean","const":false,"title":"Sitemap Published","default":false},"indexing_guaranteed":{"type":"boolean","const":false,"title":"Indexing Guaranteed","default":false},"payload_stored":{"type":"boolean","const":false,"title":"Payload Stored","default":false},"decision":{"type":"string","enum":["CLEAR","REVIEW_REQUIRED","BLOCKED"],"title":"Decision"},"document_type":{"type":"string","enum":["URLSET","SITEMAP_INDEX"],"title":"Document Type"},"byte_count":{"type":"integer","title":"Byte Count"},"entry_count":{"type":"integer","title":"Entry Count"},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace"},"hostnames":{"items":{"type":"string"},"type":"array","title":"Hostnames"},"duplicate_location_count":{"type":"integer","title":"Duplicate Location Count"},"entries_with_lastmod":{"type":"integer","title":"Entries With Lastmod"},"extension_names":{"items":{"type":"string"},"type":"array","title":"Extension Names"},"findings":{"items":{"$ref":"#/components/schemas/SitemapIssue"},"type":"array","title":"Findings"},"next_action":{"type":"string","title":"Next Action"},"entries":{"items":{"$ref":"#/components/schemas/SitemapEntry"},"type":"array","title":"Entries"},"entries_truncated":{"type":"boolean","title":"Entries Truncated"}},"type":"object","required":["decision","document_type","byte_count","entry_count","namespace","hostnames","duplicate_location_count","entries_with_lastmod","extension_names","findings","next_action","entries","entries_truncated"],"title":"SitemapParseResult"},"SitemapPolicyRequest":{"properties":{"content":{"type":"string","minLength":1,"title":"Content"},"required_document_type":{"anyOf":[{"type":"string","enum":["URLSET","SITEMAP_INDEX"]},{"type":"null"}],"title":"Required Document Type"},"require_https":{"type":"boolean","title":"Require Https","default":true},"require_single_host":{"type":"boolean","title":"Require Single Host","default":true},"allowed_hosts":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":100},{"type":"null"}],"title":"Allowed Hosts"},"require_lastmod":{"type":"boolean","title":"Require Lastmod","default":false},"reject_future_lastmod":{"type":"boolean","title":"Reject Future Lastmod","default":true},"future_tolerance_days":{"type":"integer","maximum":365.0,"minimum":0.0,"title":"Future Tolerance Days","default":1},"evaluated_at":{"type":"string","format":"date-time","title":"Evaluated At"},"maximum_entries":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Maximum Entries","default":10000},"document_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Document Url"},"require_index_same_host":{"type":"boolean","title":"Require Index Same Host","default":false}},"additionalProperties":false,"type":"object","required":["content","evaluated_at"],"title":"SitemapPolicyRequest"},"SitemapPolicyResult":{"properties":{"status":{"type":"string","const":"COMPLETED","title":"Status","default":"COMPLETED"},"ruleset_version":{"type":"string","const":"SITEMAP_PROTOCOL_0_9_2026","title":"Ruleset Version","default":"SITEMAP_PROTOCOL_0_9_2026"},"scope":{"type":"string","const":"CALLER_SUPPLIED_SITEMAP_XML_ONLY","title":"Scope","default":"CALLER_SUPPLIED_SITEMAP_XML_ONLY"},"network_accessed":{"type":"boolean","const":false,"title":"Network Accessed","default":false},"url_fetched":{"type":"boolean","const":false,"title":"Url Fetched","default":false},"search_console_accessed":{"type":"boolean","const":false,"title":"Search Console Accessed","default":false},"sitemap_published":{"type":"boolean","const":false,"title":"Sitemap Published","default":false},"indexing_guaranteed":{"type":"boolean","const":false,"title":"Indexing Guaranteed","default":false},"payload_stored":{"type":"boolean","const":false,"title":"Payload Stored","default":false},"decision":{"type":"string","enum":["CLEAR","REVIEW_REQUIRED","BLOCKED"],"title":"Decision"},"document_type":{"type":"string","enum":["URLSET","SITEMAP_INDEX"],"title":"Document Type"},"byte_count":{"type":"integer","title":"Byte Count"},"entry_count":{"type":"integer","title":"Entry Count"},"namespace":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Namespace"},"hostnames":{"items":{"type":"string"},"type":"array","title":"Hostnames"},"duplicate_location_count":{"type":"integer","title":"Duplicate Location Count"},"entries_with_lastmod":{"type":"integer","title":"Entries With Lastmod"},"extension_names":{"items":{"type":"string"},"type":"array","title":"Extension Names"},"findings":{"items":{"$ref":"#/components/schemas/SitemapIssue"},"type":"array","title":"Findings"},"next_action":{"type":"string","title":"Next Action"},"allowed_by_policy":{"type":"boolean","title":"Allowed By Policy"},"evaluated_policy":{"additionalProperties":true,"type":"object","title":"Evaluated Policy"}},"type":"object","required":["decision","document_type","byte_count","entry_count","namespace","hostnames","duplicate_location_count","entries_with_lastmod","extension_names","findings","next_action","allowed_by_policy","evaluated_policy"],"title":"SitemapPolicyResult"},"SitemapXmlRequest":{"properties":{"content":{"type":"string","minLength":1,"title":"Content"}},"additionalProperties":false,"type":"object","required":["content"],"title":"SitemapXmlRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"Sitemap Inspection","description":"Bounded, stateless Sitemap protocol evidence for SEO tooling, content platforms, site migrations, publishing workflows, and AI agents."},{"name":"Sitemap Parsing","description":"Bounded, stateless Sitemap protocol evidence for SEO tooling, content platforms, site migrations, publishing workflows, and AI agents."},{"name":"URL Set Builder","description":"Bounded, stateless Sitemap protocol evidence for SEO tooling, content platforms, site migrations, publishing workflows, and AI agents."},{"name":"Sitemap Index Builder","description":"Bounded, stateless Sitemap protocol evidence for SEO tooling, content platforms, site migrations, publishing workflows, and AI agents."},{"name":"Sitemap Comparison","description":"Bounded, stateless Sitemap protocol evidence for SEO tooling, content platforms, site migrations, publishing workflows, and AI agents."},{"name":"Sitemap Publication Policy","description":"Bounded, stateless Sitemap protocol evidence for SEO tooling, content platforms, site migrations, publishing workflows, and AI agents."}],"servers":[{"url":"https://api-production-9502.up.railway.app"}]}