{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/panorama/brand-mentions.json","title":"panorama/brand-mentions data fields","description":"Documented optional core fields of data. Additional source fields are allowed. This is not the response envelope or a guarantee of availability or completeness.","type":"object","properties":{"schema_version":{"type":["string","null"],"description":"social-evidence-v2."},"scope":{"type":["string","null"],"description":"native_social_search_sample, not a full platform mention count."},"window":{"type":"object","properties":{"from":{"type":["string","null"],"description":"Window start."},"to":{"type":["string","null"],"description":"Window end."},"date_mode":{"type":["string","null"],"description":"ranked retains date-labelled results; strict excludes undated and out-of-window rows."}},"additionalProperties":true},"coverage":{"type":"object","additionalProperties":{"type":"object","properties":{"status":{"type":["string","null"],"description":"Source outcome."},"fetched":{"type":["number","null"],"description":"Fetched source rows."},"examined":{"type":["number","null"],"description":"Rows examined."},"returned":{"type":["number","null"],"description":"Retained evidence."},"deduplicated":{"type":["number","null"],"description":"Repeated native rows removed."},"within_window":{"type":["number","null"],"description":"Rows dated within the window."},"undated":{"type":["number","null"],"description":"Rows without known dates."},"outside_window":{"type":["number","null"],"description":"Rows outside the window."},"sample_cap":{"type":["number","null"],"description":"Requested collection cap."},"has_more":{"type":["boolean","null"],"description":"Source indicates continuation; null means unknown."},"date_mode":{"type":["string","null"],"description":"ranked or strict."},"query":{"type":["string","null"],"description":"Actual source retrieval query; the original identity target remains separate."}},"additionalProperties":true}},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Native record identifier; preserve exact case and value."},"platform":{"type":["string","null"],"description":"Platform id."},"source":{"type":["string","null"],"description":"Collection lane."},"title":{"type":["string","null"],"description":"Original title."},"text":{"type":["string","null"],"description":"Original text."},"url":{"type":["string","null"],"description":"Original link."},"canonical_url":{"type":["string","null"],"description":"Deduplication URL preserving source identity."},"author":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Author id."},"handle":{"type":["string","null"],"description":"Public username."},"name":{"type":["string","null"],"description":"Display name."},"url":{"type":["string","null"],"description":"Author link."}},"additionalProperties":true},"metrics":{"type":"object","properties":{"likes":{"type":["number","null"],"description":"Native likes or null."},"score":{"type":["number","null"],"description":"Native net score; can be negative."},"comments":{"type":["number","null"],"description":"Native comments or replies."},"reshares":{"type":["number","null"],"description":"Native reposts/reshares."},"views":{"type":["number","null"],"description":"Native views; separate from interactions."},"interactions":{"type":["number","null"],"description":"Documented interaction total when available."},"complete_interactions":{"type":["boolean","null"],"description":"All inputs for the interaction total are known."}},"additionalProperties":true},"engagement":{"type":["number","null"],"description":"Observed interaction sum; inspect metrics for original counters. This value is not a cross-platform ranking score."},"created_at":{"type":["string","null"],"description":"Publication timestamp or null."},"fetched_at":{"type":["string","null"],"description":"Collection timestamp."},"date_status":{"type":["string","null"],"description":"within_window, outside_window or undated."},"relevance":{"type":"object","properties":{"method":{"type":["string","null"],"description":"literal_subject_match or jev."},"classification":{"type":["string","null"],"description":"keyword_match, subject_match, unrelated or needs_review. Lexical matching is not identity verification."},"entity_verified":{"type":["boolean","null"],"description":"False for keyword-only matching."},"model":{"type":["string","null"],"description":"Model identifier when classified."},"version":{"type":["string","null"],"description":"Classifier version."},"status":{"type":["string","null"],"description":"classified or unavailable for optional Jev analysis."},"reason":{"type":["string","null"],"description":"Reason analysis was unavailable."},"identity":{"type":["string","null"],"description":"yes, no or uncertain."},"identity_support":{"type":["number","null"],"description":"Model support0–1, not a calibrated correctness probability."},"discussion":{"type":["string","null"],"description":"substantive, incidental, adjacent, unrelated or uncertain."},"discussion_support":{"type":["number","null"],"description":"Model support0–1."},"usefulness":{"type":["string","null"],"description":"evidence, question, capability, passing or unclear."},"usefulness_support":{"type":["number","null"],"description":"Model support0–1."},"evidence_scope":{"type":["string","null"],"description":"returned_title_and_text; attached context is separate reading evidence."}},"additionalProperties":true},"provenance":{"type":"array","items":{"type":"object","properties":{"platform":{"type":["string","null"],"description":"Original platform."},"endpoint":{"type":["string","null"],"description":"Original endpoint."},"query":{"type":["string","null"],"description":"Query used."},"params":{"type":"object","properties":{},"additionalProperties":true}},"additionalProperties":true}},"context_evidence":{"type":"object","properties":{"kind":{"type":["string","null"],"description":"comments or transcripts."},"status":{"type":["string","null"],"description":"answered, unavailable or invalid_response."},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Original comment identifier."},"text":{"type":["string","null"],"description":"Readable comment text; YouTube HTML formatting is converted to plain text."},"url":{"type":["string","null"],"description":"Original comment URL."},"created_at":{"type":["string","null"],"description":"Original publication timestamp or null."},"date_status":{"type":["string","null"],"description":"within_window or outside_window against the disclosed context window; undated without a publication timestamp; not_evaluated if no valid window was supplied."}},"additionalProperties":true}},"window":{"type":["object","null"],"properties":{"from":{"type":["string","null"],"description":"Explicit parent query-window start."},"to":{"type":["string","null"],"description":"Explicit parent query-window end."}},"additionalProperties":true},"excluded_parent_records":{"type":["number","null"],"description":"X records excluded because native ID or canonical URL matched the parent post, not actual replies."},"counted_as_mentions":{"type":["boolean","null"],"description":"False: contextual comments do not add mentions to the search sample."},"sample_cap":{"type":["number","null"],"description":"At most 10 returned comments per selected parent."}},"additionalProperties":true},"source_rank":{"type":["number","null"],"description":"One-based original source page position before non-content filtering and deduplication; null for legacy evidence or separately attached context."}},"additionalProperties":true}},"ranking":{"type":"object","properties":{"version":{"type":["string","null"],"description":"panorama-source-diverse-v2."},"order":{"type":["string","null"],"description":"Relevance tier, authored-content priority, balanced source lanes, context overlap, then native source rank."},"relevance_tiers":{"type":"array","items":{"type":"string"}},"source_order":{"type":"array","items":{"type":"string"}},"records":{"type":["number","null"],"description":"Number of records ordered, before any top-evidence preview limit."},"per_source":{"type":"object","additionalProperties":{"type":["number","null"],"description":"Number of records in this group."}},"per_tier":{"type":"object","additionalProperties":{"type":["number","null"],"description":"Number of records in this group."}},"source_rank_basis":{"type":"object","properties":{"record_source_rank":{"type":["number","null"],"description":"Records with original one-based page rank."},"input_source_order":{"type":["number","null"],"description":"Legacy records using encounter order within their source."}},"additionalProperties":true},"accounting_policy":{"type":["string","null"],"description":"Ordering leaves collected evidence, sample counts and billing unchanged."},"relevance_policy":{"type":["string","null"],"description":"Lexical cues are candidates, not entity verification."},"repeated_text_records":{"type":["number","null"],"description":"Repeated long authored text deferred within a relevance tier, not deleted or counted as an independent opinion."}},"additionalProperties":true},"relevance_analysis":{"type":"object","properties":{"method":{"type":["string","null"],"description":"jev."},"model":{"type":["string","null"],"description":"Configured model identifier."},"version":{"type":["string","null"],"description":"Classification prompt version."},"examined":{"type":["number","null"],"description":"Selected records, including those whose analysis was unavailable."},"classified":{"type":["number","null"],"description":"Records with complete valid classification answers."},"batches":{"type":["number","null"],"description":"Attempted bounded classification batches."},"status":{"type":["string","null"],"description":"complete, partial, unavailable or no_candidates; complete means all selected candidates were classified, not the full pool."},"unavailable":{"type":["number","null"],"description":"Selected records whose classification did not complete."},"remaining_unclassified":{"type":["number","null"],"description":"All collected records without completed classification, including failed selected candidates."},"selection":{"type":"object","properties":{"version":{"type":["string","null"],"description":"Ranking version."},"limit":{"type":["number","null"],"description":"Maximum candidates; Jev at most20 per brand, enrichment at most3."},"collected":{"type":["number","null"],"description":"Collected records supplied to selection."},"eligible":{"type":["number","null"],"description":"Records not explicitly classified unrelated."},"selected":{"type":["number","null"],"description":"Records selected for attempted interpretation."},"remaining_eligible":{"type":["number","null"],"description":"Eligible records outside the selection allowance."},"explicitly_unrelated_not_selected":{"type":["number","null"],"description":"Unrelated records retained in the response without using interpretation slots."},"per_source":{"type":"object","additionalProperties":{"type":["number","null"],"description":"Number of records in this group."}},"per_tier":{"type":"object","additionalProperties":{"type":["number","null"],"description":"Number of records in this group."}},"order":{"type":["string","null"],"description":"Selection ordering policy."},"evidence_preserved":{"type":["boolean","null"],"description":"True; candidate selection does not filter the evidence response."}},"additionalProperties":true},"metrics_policy":{"type":["string","null"],"description":"Labels are additive; sample arithmetic is unchanged."}},"additionalProperties":true},"history":{"type":"object","properties":{"scope":{"type":["string","null"],"description":"indexed_web_citations."},"status":{"type":["string","null"],"description":"complete, partial or unavailable source operation responses; inspect inner coverage."},"summary":{"type":["object","null"],"properties":{"schema_version":{"type":["string","null"],"description":"indexed-web-v1."},"query":{"type":["string","null"],"description":"Keyword expression."},"scope":{"type":["string","null"],"description":"indexed_web_citations, separate from native social samples."},"window":{"type":"object","properties":{"date_from":{"type":["string","null"],"description":"Inclusive UTC date start or null."},"date_to":{"type":["string","null"],"description":"Inclusive UTC date end or null."},"date_basis":{"type":["string","null"],"description":"publication_date for search/summary, source_reporting_date for trends."},"timezone":{"type":["string","null"],"description":"UTC."},"end_inclusive":{"type":["boolean","null"],"description":"True."},"verified":{"type":["boolean","null"],"description":"True only when local publication filtering verified every returned record; aggregate source window enforcement is not established."}},"additionalProperties":true},"provenance":{"type":"object","properties":{"collection_method":{"type":["string","null"],"description":"indexed_web."},"observed_at":{"type":["string","null"],"description":"Request observation time."},"history_available_from":{"type":["string","null"],"description":"Earliest supported index history date; not a promise every keyword has data."},"coverage_complete":{"type":["boolean","null"],"description":"False; an index is not a census."},"coverage_identity":{"type":["string","null"],"description":"Null where no immutable index identity is supplied."},"query_fingerprint":{"type":["string","null"],"description":"Hash of query/filter measurement scope."}},"additionalProperties":true},"filters":{"type":"object","properties":{"language":{"type":["string","null"],"description":"Language filter."},"country":{"type":["string","null"],"description":"Publisher country, not audience location."},"page_types":{"type":"array","items":{"type":"string"}},"verified":{"type":["boolean","null"],"description":"Local record filter enforcement; aggregate filters are requested but not independently verified."}},"additionalProperties":true},"_warnings":{"type":"array","items":{"type":"string"}},"total_count":{"type":["number","null"],"description":"Indexed citation count; null means unavailable."},"count_unit":{"type":["string","null"],"description":"indexed_citations."},"connotation_types":{"type":"object","properties":{"positive":{"type":["number","null"],"description":"Reported positive polarity assignments; categories need not partition unique citations."},"negative":{"type":["number","null"],"description":"Reported negative polarity assignments; categories need not partition unique citations."},"neutral":{"type":["number","null"],"description":"Reported neutral polarity assignments; categories need not partition unique citations."}},"additionalProperties":true},"classified_count":{"type":["number","null"],"description":"Sum of reported positive, negative and neutral assignments. The source may assign overlapping categories; not a verified unique-citation total."},"negative_share":{"type":["number","null"],"description":"Negative reported assignments divided by all positive+negative+neutral assignments, a fraction0–1. Not the share of unique citations that are negative."},"negative_share_unit":{"type":["string","null"],"description":"fraction."},"negative_share_denominator":{"type":["string","null"],"description":"positive + negative + neutral reported polarity assignments; not a verified partition of unique citations."},"sentiment_method":{"type":"object","properties":{"id":{"type":["string","null"],"description":"indexed-source-polarity-v1."},"kind":{"type":["string","null"],"description":"upstream_classification."},"unit":{"type":["string","null"],"description":"citation_count."},"confidence":{"type":["number","null"],"description":"Null when undisclosed."},"language_coverage":{"type":["string","null"],"description":"source_defined."}},"additionalProperties":true},"top_domains":{"type":"array","items":{"type":"object","properties":{"domain":{"type":["string","null"],"description":"Domain."},"count":{"type":["number","null"],"description":"Indexed citations."}},"additionalProperties":true}},"classified_count_unit":{"type":["string","null"],"description":"reported_polarity_assignments."}},"additionalProperties":true},"trends":{"type":["object","null"],"properties":{"schema_version":{"type":["string","null"],"description":"indexed-web-v1."},"query":{"type":["string","null"],"description":"Keyword expression."},"scope":{"type":["string","null"],"description":"indexed_web_citations, separate from native social samples."},"window":{"type":"object","properties":{"date_from":{"type":["string","null"],"description":"Inclusive UTC date start or null."},"date_to":{"type":["string","null"],"description":"Inclusive UTC date end or null."},"date_basis":{"type":["string","null"],"description":"publication_date for search/summary, source_reporting_date for trends."},"timezone":{"type":["string","null"],"description":"UTC."},"end_inclusive":{"type":["boolean","null"],"description":"True."},"verified":{"type":["boolean","null"],"description":"True only when local publication filtering verified every returned record; aggregate source window enforcement is not established."}},"additionalProperties":true},"provenance":{"type":"object","properties":{"collection_method":{"type":["string","null"],"description":"indexed_web."},"observed_at":{"type":["string","null"],"description":"Request observation time."},"history_available_from":{"type":["string","null"],"description":"Earliest supported index history date; not a promise every keyword has data."},"coverage_complete":{"type":["boolean","null"],"description":"False; an index is not a census."},"coverage_identity":{"type":["string","null"],"description":"Null where no immutable index identity is supplied."},"query_fingerprint":{"type":["string","null"],"description":"Hash of query/filter measurement scope."}},"additionalProperties":true},"filters":{"type":"object","properties":{"language":{"type":["string","null"],"description":"Language filter."},"country":{"type":["string","null"],"description":"Publisher country, not audience location."},"page_types":{"type":"array","items":{"type":"string"}},"verified":{"type":["boolean","null"],"description":"Local record filter enforcement; aggregate filters are requested but not independently verified."}},"additionalProperties":true},"_warnings":{"type":"array","items":{"type":"string"}},"items":{"type":"array","items":{"type":"object","properties":{"total_count":{"type":["number","null"],"description":"Indexed citation count; null means unavailable."},"count_unit":{"type":["string","null"],"description":"indexed_citations."},"connotation_types":{"type":"object","properties":{"positive":{"type":["number","null"],"description":"Reported positive polarity assignments; categories need not partition unique citations."},"negative":{"type":["number","null"],"description":"Reported negative polarity assignments; categories need not partition unique citations."},"neutral":{"type":["number","null"],"description":"Reported neutral polarity assignments; categories need not partition unique citations."}},"additionalProperties":true},"classified_count":{"type":["number","null"],"description":"Sum of reported positive, negative and neutral assignments. The source may assign overlapping categories; not a verified unique-citation total."},"negative_share":{"type":["number","null"],"description":"Negative reported assignments divided by all positive+negative+neutral assignments, a fraction0–1. Not the share of unique citations that are negative."},"negative_share_unit":{"type":["string","null"],"description":"fraction."},"negative_share_denominator":{"type":["string","null"],"description":"positive + negative + neutral reported polarity assignments; not a verified partition of unique citations."},"sentiment_method":{"type":"object","properties":{"id":{"type":["string","null"],"description":"indexed-source-polarity-v1."},"kind":{"type":["string","null"],"description":"upstream_classification."},"unit":{"type":["string","null"],"description":"citation_count."},"confidence":{"type":["number","null"],"description":"Null when undisclosed."},"language_coverage":{"type":["string","null"],"description":"source_defined."}},"additionalProperties":true},"top_domains":{"type":"array","items":{"type":"object","properties":{"domain":{"type":["string","null"],"description":"Domain."},"count":{"type":["number","null"],"description":"Indexed citations."}},"additionalProperties":true}},"date":{"type":["string","null"],"description":"Source reporting bucket date."},"classified_count_unit":{"type":["string","null"],"description":"reported_polarity_assignments."},"bucket_start":{"type":["string","null"],"description":"UTC calendar-aligned start used to detect gaps. Original source reporting date remains in date."}},"additionalProperties":true}},"date_group":{"type":["string","null"],"description":"day, week or month."},"missing_buckets":{"type":"array","items":{"type":"string"}},"expected_buckets":{"type":["number","null"],"description":"Number of requested reporting buckets."},"coverage":{"type":"object","properties":{"bucket_complete":{"type":["boolean","null"],"description":"Every requested bucket returned without rejected extras."},"comparable_source_roster":{"type":["boolean","null"],"description":"Null when source roster continuity is unknown."},"rejected_bucket_count":{"type":["number","null"],"description":"Malformed, duplicate or excess buckets excluded."}},"additionalProperties":true}},"additionalProperties":true},"examples":{"type":["object","null"],"properties":{"schema_version":{"type":["string","null"],"description":"indexed-web-v1."},"query":{"type":["string","null"],"description":"Keyword expression."},"scope":{"type":["string","null"],"description":"indexed_web_citations, separate from native social samples."},"window":{"type":"object","properties":{"date_from":{"type":["string","null"],"description":"Inclusive UTC date start or null."},"date_to":{"type":["string","null"],"description":"Inclusive UTC date end or null."},"date_basis":{"type":["string","null"],"description":"publication_date for search/summary, source_reporting_date for trends."},"timezone":{"type":["string","null"],"description":"UTC."},"end_inclusive":{"type":["boolean","null"],"description":"True."},"verified":{"type":["boolean","null"],"description":"True only when local publication filtering verified every returned record; aggregate source window enforcement is not established."}},"additionalProperties":true},"provenance":{"type":"object","properties":{"collection_method":{"type":["string","null"],"description":"indexed_web."},"observed_at":{"type":["string","null"],"description":"Request observation time."},"history_available_from":{"type":["string","null"],"description":"Earliest supported index history date; not a promise every keyword has data."},"coverage_complete":{"type":["boolean","null"],"description":"False; an index is not a census."},"coverage_identity":{"type":["string","null"],"description":"Null where no immutable index identity is supplied."},"query_fingerprint":{"type":["string","null"],"description":"Hash of query/filter measurement scope."}},"additionalProperties":true},"filters":{"type":"object","properties":{"language":{"type":["string","null"],"description":"Language filter."},"country":{"type":["string","null"],"description":"Publisher country, not audience location."},"page_types":{"type":"array","items":{"type":"string"}},"verified":{"type":["boolean","null"],"description":"Local record filter enforcement; aggregate filters are requested but not independently verified."}},"additionalProperties":true},"_warnings":{"type":"array","items":{"type":"string"}},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Stable normalized citation id."},"url":{"type":["string","null"],"description":"Original URL."},"title":{"type":["string","null"],"description":"Page title."},"text":{"type":["string","null"],"description":"Source snippet."},"published_at":{"type":["string","null"],"description":"Publication date."},"observed_at":{"type":["string","null"],"description":"Source fetch date."},"sentiment":{"type":"object","properties":{"probabilities":{"type":"object","properties":{"positive":{"type":["number","null"],"description":"0–1 source probability."},"negative":{"type":["number","null"],"description":"0–1 source probability."},"neutral":{"type":["number","null"],"description":"0–1 source probability."}},"additionalProperties":true}},"additionalProperties":true},"source_group_date":{"type":["string","null"],"description":"Source grouped date; can refer to publication OR first crawler visit."},"source_group_date_basis":{"type":["string","null"],"description":"Source meaning of group date. Never assume it is first-seen time."}},"additionalProperties":true}},"count":{"type":["number","null"],"description":"Returned citation count."},"total_count":{"type":["number","null"],"description":"Source match count, not necessarily retrievable in full."},"cursor":{"type":["string","null"],"description":"Offset continuation; null when no next page is supplied."},"has_more":{"type":["boolean","null"],"description":"Source continuation signal."},"discarded_outside_window":{"type":["number","null"],"description":"Source results removed because dates were missing or outside the explicit publication window."},"total_count_scope":{"type":["string","null"],"description":"source_reported_before_local_filtering; not the count after local date/language/country checks."}},"additionalProperties":true},"negative_share_slope_per_day":{"type":["number","null"],"description":"OLS slope of reported negative-assignment fractions; per day, not negative count slope."}},"additionalProperties":true},"query_plan":{"type":"object","properties":{"version":{"type":["string","null"],"description":"panorama-context-query-v1."},"subject":{"type":["string","null"],"description":"Original identity target."},"query":{"type":["string","null"],"description":"Bounded expanded query template; actual source queries are listed in lanes."},"mode":{"type":["string","null"],"description":"subject, subject_with_context or mixed_subject_and_context."},"context_terms":{"type":"array","items":{"type":"string"}},"source_order":{"type":"array","items":{"type":"string"}},"lanes":{"type":"array","items":{"type":"object","properties":{"platform":{"type":["string","null"],"description":"Source platform."},"query":{"type":["string","null"],"description":"Exact native retrieval query for this lane."},"mode":{"type":["string","null"],"description":"subject or subject_with_context."}},"additionalProperties":true}},"literal_sources":{"type":"array","items":{"type":"string"}},"context_sources":{"type":"array","items":{"type":"string"}},"max_requests_per_source":{"type":["number","null"],"description":"One bounded search per selected source."},"policy":{"type":["string","null"],"description":"Caller context and retrieval limitations."}},"additionalProperties":true},"match_summary":{"type":"object","properties":{"status":{"type":["string","null"],"description":"matched, candidates_only, no_supported_match or empty_sample."},"collected_records":{"type":["number","null"],"description":"All retained records, including uncertain and unrelated evidence."},"supported_matches":{"type":["number","null"],"description":"Completed Jev subject matches."},"supported_useful_matches":{"type":["number","null"],"description":"Supported subject matches with substantive useful evidence."},"lexical_candidates":{"type":["number","null"],"description":"Authored keyword/context candidates; may be namesakes."},"unresolved_records":{"type":["number","null"],"description":"Evidence without supported identity or literal candidacy."},"unrelated_records":{"type":["number","null"],"description":"Explicit unrelated classifications."},"scope":{"type":["string","null"],"description":"returned_sample."},"entity_verified":{"type":["boolean","null"],"description":"False: model support is not independent identity verification."},"policy":{"type":["string","null"],"description":"Original evidence remains available; no supported match does not establish absence from the web."}},"additionalProperties":true},"matched_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Native record identifier; preserve exact case and value."},"platform":{"type":["string","null"],"description":"Platform id."},"source":{"type":["string","null"],"description":"Collection lane."},"title":{"type":["string","null"],"description":"Original title."},"text":{"type":["string","null"],"description":"Original text."},"url":{"type":["string","null"],"description":"Original link."},"canonical_url":{"type":["string","null"],"description":"Deduplication URL preserving source identity."},"author":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Author id."},"handle":{"type":["string","null"],"description":"Public username."},"name":{"type":["string","null"],"description":"Display name."},"url":{"type":["string","null"],"description":"Author link."}},"additionalProperties":true},"metrics":{"type":"object","properties":{"likes":{"type":["number","null"],"description":"Native likes or null."},"score":{"type":["number","null"],"description":"Native net score; can be negative."},"comments":{"type":["number","null"],"description":"Native comments or replies."},"reshares":{"type":["number","null"],"description":"Native reposts/reshares."},"views":{"type":["number","null"],"description":"Native views; separate from interactions."},"interactions":{"type":["number","null"],"description":"Documented interaction total when available."},"complete_interactions":{"type":["boolean","null"],"description":"All inputs for the interaction total are known."}},"additionalProperties":true},"engagement":{"type":["number","null"],"description":"Observed interaction sum; inspect metrics for original counters. This value is not a cross-platform ranking score."},"created_at":{"type":["string","null"],"description":"Publication timestamp or null."},"fetched_at":{"type":["string","null"],"description":"Collection timestamp."},"date_status":{"type":["string","null"],"description":"within_window, outside_window or undated."},"relevance":{"type":"object","properties":{"method":{"type":["string","null"],"description":"literal_subject_match or jev."},"classification":{"type":["string","null"],"description":"keyword_match, subject_match, unrelated or needs_review. Lexical matching is not identity verification."},"entity_verified":{"type":["boolean","null"],"description":"False for keyword-only matching."},"model":{"type":["string","null"],"description":"Model identifier when classified."},"version":{"type":["string","null"],"description":"Classifier version."},"status":{"type":["string","null"],"description":"classified or unavailable for optional Jev analysis."},"reason":{"type":["string","null"],"description":"Reason analysis was unavailable."},"identity":{"type":["string","null"],"description":"yes, no or uncertain."},"identity_support":{"type":["number","null"],"description":"Model support0–1, not a calibrated correctness probability."},"discussion":{"type":["string","null"],"description":"substantive, incidental, adjacent, unrelated or uncertain."},"discussion_support":{"type":["number","null"],"description":"Model support0–1."},"usefulness":{"type":["string","null"],"description":"evidence, question, capability, passing or unclear."},"usefulness_support":{"type":["number","null"],"description":"Model support0–1."},"evidence_scope":{"type":["string","null"],"description":"returned_title_and_text; attached context is separate reading evidence."}},"additionalProperties":true},"provenance":{"type":"array","items":{"type":"object","properties":{"platform":{"type":["string","null"],"description":"Original platform."},"endpoint":{"type":["string","null"],"description":"Original endpoint."},"query":{"type":["string","null"],"description":"Query used."},"params":{"type":"object","properties":{},"additionalProperties":true}},"additionalProperties":true}},"context_evidence":{"type":"object","properties":{"kind":{"type":["string","null"],"description":"comments or transcripts."},"status":{"type":["string","null"],"description":"answered, unavailable or invalid_response."},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Original comment identifier."},"text":{"type":["string","null"],"description":"Readable comment text; YouTube HTML formatting is converted to plain text."},"url":{"type":["string","null"],"description":"Original comment URL."},"created_at":{"type":["string","null"],"description":"Original publication timestamp or null."},"date_status":{"type":["string","null"],"description":"within_window or outside_window against the disclosed context window; undated without a publication timestamp; not_evaluated if no valid window was supplied."}},"additionalProperties":true}},"window":{"type":["object","null"],"properties":{"from":{"type":["string","null"],"description":"Explicit parent query-window start."},"to":{"type":["string","null"],"description":"Explicit parent query-window end."}},"additionalProperties":true},"excluded_parent_records":{"type":["number","null"],"description":"X records excluded because native ID or canonical URL matched the parent post, not actual replies."},"counted_as_mentions":{"type":["boolean","null"],"description":"False: contextual comments do not add mentions to the search sample."},"sample_cap":{"type":["number","null"],"description":"At most 10 returned comments per selected parent."}},"additionalProperties":true},"source_rank":{"type":["number","null"],"description":"One-based original source page position before non-content filtering and deduplication; null for legacy evidence or separately attached context."}},"additionalProperties":true}},"candidate_items":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Native record identifier; preserve exact case and value."},"platform":{"type":["string","null"],"description":"Platform id."},"source":{"type":["string","null"],"description":"Collection lane."},"title":{"type":["string","null"],"description":"Original title."},"text":{"type":["string","null"],"description":"Original text."},"url":{"type":["string","null"],"description":"Original link."},"canonical_url":{"type":["string","null"],"description":"Deduplication URL preserving source identity."},"author":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Author id."},"handle":{"type":["string","null"],"description":"Public username."},"name":{"type":["string","null"],"description":"Display name."},"url":{"type":["string","null"],"description":"Author link."}},"additionalProperties":true},"metrics":{"type":"object","properties":{"likes":{"type":["number","null"],"description":"Native likes or null."},"score":{"type":["number","null"],"description":"Native net score; can be negative."},"comments":{"type":["number","null"],"description":"Native comments or replies."},"reshares":{"type":["number","null"],"description":"Native reposts/reshares."},"views":{"type":["number","null"],"description":"Native views; separate from interactions."},"interactions":{"type":["number","null"],"description":"Documented interaction total when available."},"complete_interactions":{"type":["boolean","null"],"description":"All inputs for the interaction total are known."}},"additionalProperties":true},"engagement":{"type":["number","null"],"description":"Observed interaction sum; inspect metrics for original counters. This value is not a cross-platform ranking score."},"created_at":{"type":["string","null"],"description":"Publication timestamp or null."},"fetched_at":{"type":["string","null"],"description":"Collection timestamp."},"date_status":{"type":["string","null"],"description":"within_window, outside_window or undated."},"relevance":{"type":"object","properties":{"method":{"type":["string","null"],"description":"literal_subject_match or jev."},"classification":{"type":["string","null"],"description":"keyword_match, subject_match, unrelated or needs_review. Lexical matching is not identity verification."},"entity_verified":{"type":["boolean","null"],"description":"False for keyword-only matching."},"model":{"type":["string","null"],"description":"Model identifier when classified."},"version":{"type":["string","null"],"description":"Classifier version."},"status":{"type":["string","null"],"description":"classified or unavailable for optional Jev analysis."},"reason":{"type":["string","null"],"description":"Reason analysis was unavailable."},"identity":{"type":["string","null"],"description":"yes, no or uncertain."},"identity_support":{"type":["number","null"],"description":"Model support0–1, not a calibrated correctness probability."},"discussion":{"type":["string","null"],"description":"substantive, incidental, adjacent, unrelated or uncertain."},"discussion_support":{"type":["number","null"],"description":"Model support0–1."},"usefulness":{"type":["string","null"],"description":"evidence, question, capability, passing or unclear."},"usefulness_support":{"type":["number","null"],"description":"Model support0–1."},"evidence_scope":{"type":["string","null"],"description":"returned_title_and_text; attached context is separate reading evidence."}},"additionalProperties":true},"provenance":{"type":"array","items":{"type":"object","properties":{"platform":{"type":["string","null"],"description":"Original platform."},"endpoint":{"type":["string","null"],"description":"Original endpoint."},"query":{"type":["string","null"],"description":"Query used."},"params":{"type":"object","properties":{},"additionalProperties":true}},"additionalProperties":true}},"context_evidence":{"type":"object","properties":{"kind":{"type":["string","null"],"description":"comments or transcripts."},"status":{"type":["string","null"],"description":"answered, unavailable or invalid_response."},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":["string","null"],"description":"Original comment identifier."},"text":{"type":["string","null"],"description":"Readable comment text; YouTube HTML formatting is converted to plain text."},"url":{"type":["string","null"],"description":"Original comment URL."},"created_at":{"type":["string","null"],"description":"Original publication timestamp or null."},"date_status":{"type":["string","null"],"description":"within_window or outside_window against the disclosed context window; undated without a publication timestamp; not_evaluated if no valid window was supplied."}},"additionalProperties":true}},"window":{"type":["object","null"],"properties":{"from":{"type":["string","null"],"description":"Explicit parent query-window start."},"to":{"type":["string","null"],"description":"Explicit parent query-window end."}},"additionalProperties":true},"excluded_parent_records":{"type":["number","null"],"description":"X records excluded because native ID or canonical URL matched the parent post, not actual replies."},"counted_as_mentions":{"type":["boolean","null"],"description":"False: contextual comments do not add mentions to the search sample."},"sample_cap":{"type":["number","null"],"description":"At most 10 returned comments per selected parent."}},"additionalProperties":true},"source_rank":{"type":["number","null"],"description":"One-based original source page position before non-content filtering and deduplication; null for legacy evidence or separately attached context."}},"additionalProperties":true}}},"additionalProperties":true,"examples":[{"schema_version":"social-evidence-v2","scope":"native_social_search_sample","brand":"My Brand","mentions":1,"engagement":12,"items":[{"id":"101","platform":"hackernews","source":"hackernews","title":"Using My Brand","text":null,"url":"https://news.ycombinator.com/item?id=101","canonical_url":"https://news.ycombinator.com/item?id=101","author":{"id":null,"handle":"example_reader","name":null,"url":null},"metrics":{"likes":null,"score":10,"comments":2,"reshares":null,"views":null,"interactions":12,"complete_interactions":false},"engagement":12,"created_at":"2026-09-18T12:00:00.000Z","fetched_at":"2026-09-19T12:00:00.000Z","date_status":"within_window","relevance":{"method":"literal_subject_match","classification":"keyword_match","entity_verified":false},"provenance":[{"platform":"hackernews","endpoint":"search","query":"My Brand","params":{"query":"My Brand"}}]}],"coverage":{"hackernews":{"status":"answered","fetched":1,"examined":1,"returned":1,"deduplicated":0,"within_window":1,"undated":0,"outside_window":0,"sample_cap":25,"has_more":false,"date_mode":"strict"}},"timeline":[{"date":"2026-09-18","count":1}],"timeline_undated":0,"query_plan":{"version":"panorama-context-query-v1","subject":"My Brand","query":"My Brand","mode":"subject","context_terms":[],"source_order":["hackernews"],"lanes":[{"platform":"hackernews","query":"My Brand","mode":"subject"}],"literal_sources":["hackernews"],"context_sources":[],"max_requests_per_source":1,"policy":"One bounded native search per source. Original subject remains the identity target; lexical matching is not proof of identity."},"matched_items":[],"candidate_items":[{"id":"101","platform":"hackernews","source":"hackernews","title":"Using My Brand","text":null,"url":"https://news.ycombinator.com/item?id=101","canonical_url":"https://news.ycombinator.com/item?id=101","author":{"id":null,"handle":"example_reader","name":null,"url":null},"metrics":{"likes":null,"score":10,"comments":2,"reshares":null,"views":null,"interactions":12,"complete_interactions":false},"engagement":12,"created_at":"2026-09-18T12:00:00.000Z","fetched_at":"2026-09-19T12:00:00.000Z","date_status":"within_window","relevance":{"method":"literal_subject_match","classification":"keyword_match","entity_verified":false},"provenance":[{"platform":"hackernews","endpoint":"search","query":"My Brand","params":{"query":"My Brand"}}]}],"match_summary":{"status":"candidates_only","collected_records":1,"supported_matches":0,"supported_useful_matches":0,"lexical_candidates":1,"unresolved_records":0,"unrelated_records":0,"scope":"returned_sample","entity_verified":false,"policy":"No completed relevance classification in this illustration. The original records remain available; these are lexical candidates, not verified matches."}}]}