{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/content_analysis/search.json","title":"content_analysis/search data fields","description":"Optional data supplied by this operation. Null means unknown.","type":"object","properties":{"_warnings":{"description":"Optional  warnings supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"count":{"description":"Number of records in this response, not lifetime or total matches.","type":["number","null"]},"cursor":{"description":"Opaque next-page token; pass it back unchanged. Null does not prove complete history.","type":["string","null"]},"dropped":{"description":"Optional dropped supplied by this operation. Null means unknown.","type":["number","null"]},"duplicates_removed":{"description":"Optional duplicates removed supplied by this operation. Null means unknown.","type":["number","null"]},"filters_applied":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array","null"],"items":{}},"gathered":{"description":"Optional gathered supplied by this operation. Null means unknown.","type":["number","null"]},"items":{"description":"Returned records. Source coverage and completeness vary.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":"object","properties":{"author":{"description":"Public author information supplied with this record.","type":["string","null"]},"categories":{"description":"Optional categories supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"engagement":{"description":"Optional engagement supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"comments":{"description":"Optional comments supplied by this operation. Null means unknown.","type":["number","null"]},"score":{"description":"Optional score supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"matched_terms":{"description":"Optional matched terms supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{},"additionalProperties":true}},"primary_category":{"description":"Optional primary category supplied by this operation. Null means unknown.","type":["string","null"]},"published_at":{"description":"Source publication time when available.","type":["string","null"]},"publisher":{"description":"Optional publisher supplied by this operation. Null means unknown.","type":["string","null"]},"raw_sentiment_score":{"description":"Optional raw sentiment score supplied by this operation. Null means unknown.","type":["number","null"]},"sentiment":{"description":"Optional sentiment supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"label":{"description":"Optional label supplied by this operation. Null means unknown.","type":["string","null"]},"score":{"description":"Optional score supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"source":{"description":"Optional source supplied by this operation. Null means unknown.","type":["string","null"]},"text_source":{"description":"Optional text source supplied by this operation. Null means unknown.","type":["string","null"]},"title":{"description":"Source title when supplied.","type":["string","null"]},"url":{"description":"Original source URL when supplied.","type":["string","null"]}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["author"],"properties":{"author":{"description":"Public author information supplied with this record.","type":["string"],"minLength":1}}},{"required":["categories"],"properties":{"categories":{"description":"Optional categories supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}}}},{"required":["engagement"],"properties":{"engagement":{"description":"Optional engagement supplied by this operation. Null means unknown.","type":["object"],"properties":{"comments":{"description":"Optional comments supplied by this operation. Null means unknown.","type":["number","null"]},"score":{"description":"Optional score supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}},{"required":["matched_terms"],"properties":{"matched_terms":{"description":"Optional matched terms supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{},"additionalProperties":true}}}},{"required":["primary_category"],"properties":{"primary_category":{"description":"Optional primary category supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["published_at"],"properties":{"published_at":{"description":"Source publication time when available.","type":["string"],"minLength":1}}},{"required":["publisher"],"properties":{"publisher":{"description":"Optional publisher supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["raw_sentiment_score"],"properties":{"raw_sentiment_score":{"description":"Optional raw sentiment score supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["sentiment"],"properties":{"sentiment":{"description":"Optional sentiment supplied by this operation. Null means unknown.","type":["object"],"properties":{"label":{"description":"Optional label supplied by this operation. Null means unknown.","type":["string","null"]},"score":{"description":"Optional score supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}},{"required":["source"],"properties":{"source":{"description":"Optional source supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["text_source"],"properties":{"text_source":{"description":"Optional text source supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["title"],"properties":{"title":{"description":"Source title when supplied.","type":["string"],"minLength":1}}},{"required":["url"],"properties":{"url":{"description":"Original source URL when supplied.","type":["string"],"minLength":1}}}]}]}},"keyword":{"description":"Optional keyword supplied by this operation. Null means unknown.","type":["string","null"]},"order_by":{"description":"Optional order by supplied by this operation. Null means unknown.","type":["string","null"]},"search_mode":{"description":"Optional search mode supplied by this operation. Null means unknown.","type":["string","null"]},"sentiment_method":{"description":"Optional sentiment method supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"ai_used":{"description":"Optional ai used supplied by this operation. Null means unknown.","type":["boolean","null"]},"kind":{"description":"Optional kind supplied by this operation. Null means unknown.","type":["string","null"]},"known_limits":{"description":"Optional known limits supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["string","null"]}},"lexicon":{"description":"Optional lexicon supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"diminishers":{"description":"Optional diminishers supplied by this operation. Null means unknown.","type":["number","null"]},"intensifiers":{"description":"Optional intensifiers supplied by this operation. Null means unknown.","type":["number","null"]},"negative_terms":{"description":"Optional negative terms supplied by this operation. Null means unknown.","type":["number","null"]},"negators":{"description":"Optional negators supplied by this operation. Null means unknown.","type":["number","null"]},"positive_terms":{"description":"Optional positive terms supplied by this operation. Null means unknown.","type":["number","null"]},"total_terms":{"description":"Optional total terms supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"modifiers":{"description":"Optional modifiers supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"diminisher":{"description":"Optional diminisher supplied by this operation. Null means unknown.","type":["string","null"]},"intensifier":{"description":"Optional intensifier supplied by this operation. Null means unknown.","type":["string","null"]},"matching":{"description":"Optional matching supplied by this operation. Null means unknown.","type":["string","null"]},"negation":{"description":"Optional negation supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true},"scoring":{"description":"Optional scoring supplied by this operation. Null means unknown.","type":["string","null"]},"thresholds":{"description":"Optional thresholds supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"negative":{"description":"Optional negative supplied by this operation. Null means unknown.","type":["number","null"]},"positive":{"description":"Optional positive supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}},"additionalProperties":true},"sources":{"description":"Optional sources supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"endpoint":{"description":"Optional endpoint supplied by this operation. Null means unknown.","type":["string","null"]},"error":{"description":"Optional error supplied by this operation. Null means unknown.","type":["string","null"]},"kept":{"description":"Optional kept supplied by this operation. Null means unknown.","type":["number","null"]},"ok":{"description":"Optional ok supplied by this operation. Null means unknown.","type":["boolean","null"]},"returned":{"description":"Optional returned supplied by this operation. Null means unknown.","type":["number","null"]},"source":{"description":"Optional source supplied by this operation. Null means unknown.","type":["string","null"]},"status":{"description":"Optional status supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}},"sources_unavailable":{"description":"Optional sources unavailable supplied by this operation. Null means unknown.","type":["array","null"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"reason":{"description":"Optional reason supplied by this operation. Null means unknown.","type":["string","null"]},"source":{"description":"Optional source supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}},"total_matched":{"description":"Optional total matched supplied by this operation. Null means unknown.","type":["number","null"]}},"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":[{"_warnings":["example"],"count":0,"cursor":null,"dropped":0,"duplicates_removed":0,"filters_applied":[],"gathered":0,"items":[{"author":"example","categories":["example"],"engagement":{"comments":0,"score":0},"matched_terms":[{}],"primary_category":"example","published_at":"2026-09-01T12:00:00Z","publisher":"example","raw_sentiment_score":0,"sentiment":{"label":"example","score":0},"source":"example","text_source":"example","title":"example","url":"https://example.com/example"}],"keyword":"example","order_by":"example","search_mode":"example","sentiment_method":{"ai_used":false,"kind":"example","known_limits":["example"],"lexicon":{"diminishers":0,"intensifiers":0,"negative_terms":0,"negators":0,"positive_terms":0,"total_terms":0},"modifiers":{"diminisher":"example","intensifier":"example","matching":"example","negation":"example"},"scoring":"example","thresholds":{"negative":0,"positive":0}},"sources":[{"endpoint":"example","error":"example","kept":0,"ok":false,"returned":0,"source":"example","status":0}],"sources_unavailable":[{"reason":"example","source":"example"}],"total_matched":0}]}