{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/web/parse.json","title":"web/parse data fields","description":"Required core structure for successful data, with optional source fields. Additional fields are allowed. This is not a completeness guarantee.","type":"object","properties":{"url":{"type":["string","null"],"description":"url"},"final_url":{"type":["string","null"],"description":"final url"},"content_type":{"type":["string","null"],"description":"content type"},"detected_type":{"type":["string","null"],"description":"detected type"},"detected_via":{"type":["string","null"],"description":"detected via"},"text":{"type":["string","null"],"description":"text"},"byte_size":{"type":["number","null"],"description":"byte size; null is unknown."},"text_length":{"type":["number","null"],"description":"text length; null is unknown."},"pages":{"type":["number","null"],"description":"pages; null is unknown."},"metadata":{"type":["object","null"],"properties":{},"additionalProperties":true},"truncated":{"type":["boolean","null"],"description":"Whether returned document text was cut short."},"texts":{"type":"array","items":{"type":["string","null"],"description":"Source text."}},"_warnings":{"type":"array","items":{"type":["string","null"],"description":"Source text."}}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["url"],"properties":{"url":{"type":["string"],"description":"url","minLength":1}}},{"required":["final_url"],"properties":{"final_url":{"type":["string"],"description":"final url","minLength":1}}},{"required":["content_type"],"properties":{"content_type":{"type":["string"],"description":"content type","minLength":1}}},{"required":["detected_type"],"properties":{"detected_type":{"type":["string"],"description":"detected type","minLength":1}}},{"required":["detected_via"],"properties":{"detected_via":{"type":["string"],"description":"detected via","minLength":1}}},{"required":["text"],"properties":{"text":{"type":["string"],"description":"text","minLength":1}}},{"required":["byte_size"],"properties":{"byte_size":{"type":["number"],"description":"byte size; null is unknown."}}},{"required":["text_length"],"properties":{"text_length":{"type":["number"],"description":"text length; null is unknown."}}},{"required":["pages"],"properties":{"pages":{"type":["number"],"description":"pages; null is unknown."}}},{"required":["metadata"],"properties":{"metadata":{"type":["object"],"properties":{},"additionalProperties":true}}},{"required":["truncated"],"properties":{"truncated":{"type":["boolean"],"description":"Whether returned document text was cut short."}}},{"required":["texts"],"properties":{"texts":{"type":"array","items":{"type":["string","null"],"description":"Source text."}}}}]}],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"detected_type":"image","text":"Example visible text","texts":["Example visible text"],"truncated":false}]}