{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/research/briefing.json","title":"research/briefing 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":{"outcome":{"type":["string","null"],"description":"outcome"},"research_version":{"type":["string","null"],"description":"research version"},"query":{"type":["string","null"],"description":"query"},"answer":{"type":["object","null"],"properties":{"text":{"type":["string","null"],"description":"text"},"claim_id":{"type":["string","null"],"description":"claim id"},"confidence":{"type":["string","null"],"description":"confidence"},"basis":{"type":["string","null"],"description":"basis"}},"additionalProperties":true},"claims":{"type":"array","items":{"type":["object","null"],"properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"kind":{"type":["string","null"],"description":"kind"},"text":{"type":["string","null"],"description":"text"},"confidence":{"type":["string","null"],"description":"confidence"},"evidence_ids":{"type":"array","items":{"type":["string","null"],"description":"Source text."}}},"additionalProperties":true}},"evidence":{"type":"array","items":{"type":["object","null"],"properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"url":{"type":["string","null"],"description":"Original source URL when supplied."},"platform":{"type":["string","null"],"description":"platform"},"title":{"type":["string","null"],"description":"title"},"text":{"type":["string","null"],"description":"text"},"caption":{"type":["string","null"],"description":"caption"},"created_at":{"type":["string","null"],"description":"created at"},"author":{"anyOf":[{"type":["object","null"],"properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"handle":{"type":["string","null"],"description":"handle"},"name":{"type":["string","null"],"description":"name"},"url":{"type":["string","null"],"description":"url"},"headline":{"type":["string","null"],"description":"headline"},"location":{"type":["string","null"],"description":"location"},"avatar_url":{"type":["string","null"],"description":"avatar url"},"followers":{"type":["number","null"],"description":"Public follower count."},"verified":{"type":["boolean","null"],"description":"Explicit verification flag when supplied."}},"additionalProperties":true},{"type":["string","null"],"description":"Public author handle."}]},"stats":{"type":["object","null"],"properties":{"likes":{"type":["number","null"],"description":"likes; null is unknown."},"comments":{"type":["number","null"],"description":"comments; null is unknown."},"replies":{"type":["number","null"],"description":"replies; null is unknown."},"shares":{"type":["number","null"],"description":"shares; null is unknown."},"views":{"type":["number","null"],"description":"views; null is unknown."}},"additionalProperties":true}},"additionalProperties":true}},"historical":{"type":"array","items":{"type":["object","null"],"properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"url":{"type":["string","null"],"description":"Original source URL when supplied."},"platform":{"type":["string","null"],"description":"platform"},"title":{"type":["string","null"],"description":"title"},"text":{"type":["string","null"],"description":"text"},"caption":{"type":["string","null"],"description":"caption"},"created_at":{"type":["string","null"],"description":"created at"},"author":{"anyOf":[{"type":["object","null"],"properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"handle":{"type":["string","null"],"description":"handle"},"name":{"type":["string","null"],"description":"name"},"url":{"type":["string","null"],"description":"url"},"headline":{"type":["string","null"],"description":"headline"},"location":{"type":["string","null"],"description":"location"},"avatar_url":{"type":["string","null"],"description":"avatar url"},"followers":{"type":["number","null"],"description":"Public follower count."},"verified":{"type":["boolean","null"],"description":"Explicit verification flag when supplied."}},"additionalProperties":true},{"type":["string","null"],"description":"Public author handle."}]},"stats":{"type":["object","null"],"properties":{"likes":{"type":["number","null"],"description":"likes; null is unknown."},"comments":{"type":["number","null"],"description":"comments; null is unknown."},"replies":{"type":["number","null"],"description":"replies; null is unknown."},"shares":{"type":["number","null"],"description":"shares; null is unknown."},"views":{"type":["number","null"],"description":"views; null is unknown."}},"additionalProperties":true}},"additionalProperties":true}},"counts":{"type":["object","null"],"properties":{"kept_after_scope":{"type":["number","null"],"description":"kept after scope; null is unknown."},"dropped_out_of_scope":{"type":["number","null"],"description":"dropped out of scope; null is unknown."},"duplicates_removed_total":{"type":["number","null"],"description":"duplicates removed total; null is unknown."}},"additionalProperties":true},"report":{"type":["object","null"],"properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"url":{"type":["string","null"],"description":"Original source URL when supplied."}},"additionalProperties":true},"_warnings":{"type":"array","items":{"type":["string","null"],"description":"Source text."}}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["outcome"],"properties":{"outcome":{"type":["string"],"description":"outcome","minLength":1}}},{"required":["research_version"],"properties":{"research_version":{"type":["string"],"description":"research version","minLength":1}}},{"required":["answer"],"properties":{"answer":{"type":["object"],"properties":{"text":{"type":["string","null"],"description":"text"},"claim_id":{"type":["string","null"],"description":"claim id"},"confidence":{"type":["string","null"],"description":"confidence"},"basis":{"type":["string","null"],"description":"basis"}},"additionalProperties":true}}},{"required":["claims"],"properties":{"claims":{"type":"array","items":{"type":["object","null"],"properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"kind":{"type":["string","null"],"description":"kind"},"text":{"type":["string","null"],"description":"text"},"confidence":{"type":["string","null"],"description":"confidence"},"evidence_ids":{"type":"array","items":{"type":["string","null"],"description":"Source text."}}},"additionalProperties":true}}}},{"required":["evidence"],"properties":{"evidence":{"type":"array","items":{"type":["object","null"],"properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"url":{"type":["string","null"],"description":"Original source URL when supplied."},"platform":{"type":["string","null"],"description":"platform"},"title":{"type":["string","null"],"description":"title"},"text":{"type":["string","null"],"description":"text"},"caption":{"type":["string","null"],"description":"caption"},"created_at":{"type":["string","null"],"description":"created at"},"author":{"anyOf":[{"type":["object","null"],"properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"handle":{"type":["string","null"],"description":"handle"},"name":{"type":["string","null"],"description":"name"},"url":{"type":["string","null"],"description":"url"},"headline":{"type":["string","null"],"description":"headline"},"location":{"type":["string","null"],"description":"location"},"avatar_url":{"type":["string","null"],"description":"avatar url"},"followers":{"type":["number","null"],"description":"Public follower count."},"verified":{"type":["boolean","null"],"description":"Explicit verification flag when supplied."}},"additionalProperties":true},{"type":["string","null"],"description":"Public author handle."}]},"stats":{"type":["object","null"],"properties":{"likes":{"type":["number","null"],"description":"likes; null is unknown."},"comments":{"type":["number","null"],"description":"comments; null is unknown."},"replies":{"type":["number","null"],"description":"replies; null is unknown."},"shares":{"type":["number","null"],"description":"shares; null is unknown."},"views":{"type":["number","null"],"description":"views; null is unknown."}},"additionalProperties":true}},"additionalProperties":true}}}},{"required":["historical"],"properties":{"historical":{"type":"array","items":{"type":["object","null"],"properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"url":{"type":["string","null"],"description":"Original source URL when supplied."},"platform":{"type":["string","null"],"description":"platform"},"title":{"type":["string","null"],"description":"title"},"text":{"type":["string","null"],"description":"text"},"caption":{"type":["string","null"],"description":"caption"},"created_at":{"type":["string","null"],"description":"created at"},"author":{"anyOf":[{"type":["object","null"],"properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"handle":{"type":["string","null"],"description":"handle"},"name":{"type":["string","null"],"description":"name"},"url":{"type":["string","null"],"description":"url"},"headline":{"type":["string","null"],"description":"headline"},"location":{"type":["string","null"],"description":"location"},"avatar_url":{"type":["string","null"],"description":"avatar url"},"followers":{"type":["number","null"],"description":"Public follower count."},"verified":{"type":["boolean","null"],"description":"Explicit verification flag when supplied."}},"additionalProperties":true},{"type":["string","null"],"description":"Public author handle."}]},"stats":{"type":["object","null"],"properties":{"likes":{"type":["number","null"],"description":"likes; null is unknown."},"comments":{"type":["number","null"],"description":"comments; null is unknown."},"replies":{"type":["number","null"],"description":"replies; null is unknown."},"shares":{"type":["number","null"],"description":"shares; null is unknown."},"views":{"type":["number","null"],"description":"views; null is unknown."}},"additionalProperties":true}},"additionalProperties":true}}}},{"required":["counts"],"properties":{"counts":{"type":["object"],"properties":{"kept_after_scope":{"type":["number","null"],"description":"kept after scope; null is unknown."},"dropped_out_of_scope":{"type":["number","null"],"description":"dropped out of scope; null is unknown."},"duplicates_removed_total":{"type":["number","null"],"description":"duplicates removed total; null is unknown."}},"additionalProperties":true}}},{"required":["report"],"properties":{"report":{"type":["object"],"properties":{"id":{"type":["string","null"],"description":"Exact source identifier; preserve it as a string."},"url":{"type":["string","null"],"description":"Original source URL when supplied."}},"additionalProperties":true}}}]}],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"outcome":"BRIEFING","query":"Example topic","answer":null,"claims":[],"evidence":[]}]}