{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/content_analysis/phrase-trends.json","title":"content_analysis/phrase-trends 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"]}},"bucket_count":{"description":"Optional bucket count supplied by this operation. Null means unknown.","type":["number","null"]},"buckets":{"description":"Optional buckets 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":{"bucket_end":{"description":"Optional bucket end supplied by this operation. Null means unknown.","type":["string","null"]},"bucket_start":{"description":"Optional bucket start supplied by this operation. Null means unknown.","type":["string","null"]},"by_source":{"description":"Optional by source supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"google_news":{"description":"Optional google news supplied by this operation. Null means unknown.","type":["number","null"]},"hackernews":{"description":"Optional hackernews supplied by this operation. Null means unknown.","type":["number","null"]},"reddit":{"description":"Optional reddit supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"mentions":{"description":"Optional mentions 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":{"mean_score":{"description":"Optional mean score supplied by this operation. Null means unknown.","type":["number","null"]},"negative":{"description":"Optional negative supplied by this operation. Null means unknown.","type":["number","null"]},"neutral":{"description":"Optional neutral 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}},"date_from":{"description":"Optional date from supplied by this operation. Null means unknown.","type":["string","null"]},"date_group":{"description":"Optional date group supplied by this operation. Null means unknown.","type":["string","null"]},"date_to":{"description":"Optional date to supplied by this operation. Null means unknown.","type":["string","null"]},"excluded":{"description":"Optional excluded supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"out_of_window_mentions":{"description":"Optional out of window mentions supplied by this operation. Null means unknown.","type":["number","null"]},"undated_mentions":{"description":"Optional undated mentions supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"filters_applied":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array","null"],"items":{}},"keyword":{"description":"Optional keyword 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}},"top_terms":{"description":"Optional top 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":{"mentions":{"description":"Optional mentions supplied by this operation. Null means unknown.","type":["number","null"]},"occurrences":{"description":"Optional occurrences supplied by this operation. Null means unknown.","type":["number","null"]},"term":{"description":"Optional term supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}},"totals":{"description":"Optional totals supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"buckets_with_mentions":{"description":"Optional buckets with mentions 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"]},"gathered_before_filters":{"description":"Optional gathered before filters supplied by this operation. Null means unknown.","type":["number","null"]},"mentions":{"description":"Optional mentions supplied by this operation. Null means unknown.","type":["number","null"]},"peak_bucket":{"description":"Optional peak bucket supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"bucket_start":{"description":"Optional bucket start supplied by this operation. Null means unknown.","type":["string","null"]},"mentions":{"description":"Optional mentions supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"sentiment":{"description":"Optional sentiment supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"max_score":{"description":"Optional max score supplied by this operation. Null means unknown.","type":["number","null"]},"mean_score":{"description":"Optional mean score supplied by this operation. Null means unknown.","type":["number","null"]},"median_score":{"description":"Optional median score supplied by this operation. Null means unknown.","type":["number","null"]},"min_score":{"description":"Optional min score supplied by this operation. Null means unknown.","type":["number","null"]},"negative":{"description":"Optional negative supplied by this operation. Null means unknown.","type":["number","null"]},"neutral":{"description":"Optional neutral supplied by this operation. Null means unknown.","type":["number","null"]},"positive":{"description":"Optional positive supplied by this operation. Null means unknown.","type":["number","null"]},"total":{"description":"Source-reported total; null is unknown.","type":["number","null"]}},"additionalProperties":true}},"additionalProperties":true}},"additionalProperties":true,"allOf":[{"anyOf":[{"required":["bucket_count"],"properties":{"bucket_count":{"description":"Optional bucket count supplied by this operation. Null means unknown.","type":["number"]}}},{"required":["buckets"],"properties":{"buckets":{"description":"Optional buckets supplied by this operation. Null means unknown.","type":["array"],"items":{"description":"Optional record supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"bucket_end":{"description":"Optional bucket end supplied by this operation. Null means unknown.","type":["string","null"]},"bucket_start":{"description":"Optional bucket start supplied by this operation. Null means unknown.","type":["string","null"]},"by_source":{"description":"Optional by source supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"google_news":{"description":"Optional google news supplied by this operation. Null means unknown.","type":["number","null"]},"hackernews":{"description":"Optional hackernews supplied by this operation. Null means unknown.","type":["number","null"]},"reddit":{"description":"Optional reddit supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"mentions":{"description":"Optional mentions 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":{"mean_score":{"description":"Optional mean score supplied by this operation. Null means unknown.","type":["number","null"]},"negative":{"description":"Optional negative supplied by this operation. Null means unknown.","type":["number","null"]},"neutral":{"description":"Optional neutral 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}}}},{"required":["date_from"],"properties":{"date_from":{"description":"Optional date from supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["date_group"],"properties":{"date_group":{"description":"Optional date group supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["date_to"],"properties":{"date_to":{"description":"Optional date to supplied by this operation. Null means unknown.","type":["string"],"minLength":1}}},{"required":["excluded"],"properties":{"excluded":{"description":"Optional excluded supplied by this operation. Null means unknown.","type":["object"],"properties":{"out_of_window_mentions":{"description":"Optional out of window mentions supplied by this operation. Null means unknown.","type":["number","null"]},"undated_mentions":{"description":"Optional undated mentions supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true}}},{"required":["filters_applied"],"properties":{"filters_applied":{"description":"Source array was empty in the reviewed captures; item fields remain unspecified.","type":["array"],"items":{}}}},{"required":["sentiment_method"],"properties":{"sentiment_method":{"description":"Optional sentiment method supplied by this operation. Null means unknown.","type":["object"],"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}}},{"required":["sources"],"properties":{"sources":{"description":"Optional sources supplied by this operation. Null means unknown.","type":["array"],"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}}}},{"required":["sources_unavailable"],"properties":{"sources_unavailable":{"description":"Optional sources unavailable supplied by this operation. Null means unknown.","type":["array"],"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}}}},{"required":["top_terms"],"properties":{"top_terms":{"description":"Optional top 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":{"mentions":{"description":"Optional mentions supplied by this operation. Null means unknown.","type":["number","null"]},"occurrences":{"description":"Optional occurrences supplied by this operation. Null means unknown.","type":["number","null"]},"term":{"description":"Optional term supplied by this operation. Null means unknown.","type":["string","null"]}},"additionalProperties":true}}}},{"required":["totals"],"properties":{"totals":{"description":"Optional totals supplied by this operation. Null means unknown.","type":["object"],"properties":{"buckets_with_mentions":{"description":"Optional buckets with mentions 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"]},"gathered_before_filters":{"description":"Optional gathered before filters supplied by this operation. Null means unknown.","type":["number","null"]},"mentions":{"description":"Optional mentions supplied by this operation. Null means unknown.","type":["number","null"]},"peak_bucket":{"description":"Optional peak bucket supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"bucket_start":{"description":"Optional bucket start supplied by this operation. Null means unknown.","type":["string","null"]},"mentions":{"description":"Optional mentions supplied by this operation. Null means unknown.","type":["number","null"]}},"additionalProperties":true},"sentiment":{"description":"Optional sentiment supplied by this operation. Null means unknown.","type":["object","null"],"properties":{"max_score":{"description":"Optional max score supplied by this operation. Null means unknown.","type":["number","null"]},"mean_score":{"description":"Optional mean score supplied by this operation. Null means unknown.","type":["number","null"]},"median_score":{"description":"Optional median score supplied by this operation. Null means unknown.","type":["number","null"]},"min_score":{"description":"Optional min score supplied by this operation. Null means unknown.","type":["number","null"]},"negative":{"description":"Optional negative supplied by this operation. Null means unknown.","type":["number","null"]},"neutral":{"description":"Optional neutral supplied by this operation. Null means unknown.","type":["number","null"]},"positive":{"description":"Optional positive supplied by this operation. Null means unknown.","type":["number","null"]},"total":{"description":"Source-reported total; null is unknown.","type":["number","null"]}},"additionalProperties":true}},"additionalProperties":true}}}]}],"x-contract-version":"2026-09-22","x-validation-scope":"Required success payload structure; optional fields and source completeness remain separate.","examples":[{"_warnings":["example"],"bucket_count":0,"buckets":[{"bucket_end":"example","bucket_start":"example","by_source":{"google_news":0,"hackernews":0,"reddit":0},"mentions":0,"sentiment":{"mean_score":0,"negative":0,"neutral":0,"positive":0}}],"date_from":"2026-09-01T12:00:00Z","date_group":"2026-09-01T12:00:00Z","date_to":"2026-09-01T12:00:00Z","excluded":{"out_of_window_mentions":0,"undated_mentions":0},"filters_applied":[],"keyword":"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"}],"top_terms":[{"mentions":0,"occurrences":0,"term":"example"}],"totals":{"buckets_with_mentions":0,"duplicates_removed":0,"gathered_before_filters":0,"mentions":0,"peak_bucket":{"bucket_start":"example","mentions":0},"sentiment":{"max_score":0,"mean_score":0,"median_score":0,"min_score":0,"negative":0,"neutral":0,"positive":0,"total":0}}}]}