{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/x/mentions.json","title":"x/mentions 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":{"items":{"type":"array","items":{"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."},"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,"allOf":[{"anyOf":[{"required":["id"],"properties":{"id":{"type":["string"],"description":"Exact source identifier; preserve it as a string.","minLength":1}}},{"required":["url"],"properties":{"url":{"type":["string"],"description":"Original source URL when supplied.","minLength":1}}},{"required":["title"],"properties":{"title":{"type":["string"],"description":"title","minLength":1}}},{"required":["text"],"properties":{"text":{"type":["string"],"description":"text","minLength":1}}},{"required":["caption"],"properties":{"caption":{"type":["string"],"description":"caption","minLength":1}}},{"required":["created_at"],"properties":{"created_at":{"type":["string"],"description":"created at","minLength":1}}},{"required":["author"],"properties":{"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."}]}}},{"required":["stats"],"properties":{"stats":{"type":["object"],"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}}}]}]}},"count":{"type":["number","null"],"description":"Returned rows, not the total population."},"cursor":{"type":["string","null"],"description":"Opaque continuation; pass unchanged."},"has_more":{"type":["boolean","null"],"description":"Source continuation indicator."},"total":{"type":["number","null"],"description":"Source-reported total; null means unknown."}},"additionalProperties":true,"required":["items"],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"items":[],"cursor":null}]}