{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.monocrawl.com/schemas/panorama/share-of-voice.json","title":"panorama/share-of-voice 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}},"brands":{"type":"array","items":{"type":"object","properties":{"brand":{"type":["string","null"],"description":"Compared name."},"mentions":{"type":["number","null"],"description":"Bounded observed sample count."},"comparable_mentions":{"type":["number","null"],"description":"Sample mentions on common sources."},"share_of_mentions":{"type":["number","null"],"description":"Brand common-source mentions / all compared brand common-source mentions; 0–1 fraction, null if unavailable."},"share_of_engagement":{"type":["number","null"],"description":"Observed interaction share, 0–1 fraction; missing inputs excluded and views separate."},"evidence":{"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}},"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}},"comparable_engagement":{"type":["number","null"],"description":"Observed interactions on the common engagement sources, or null when unavailable."},"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},"top_evidence":{"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}},"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}},"comparison":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string"}},"engagement_sources":{"type":"array","items":{"type":"string"}},"engagement_comparable":{"type":["boolean","null"],"description":"Every compared brand has observed interactions on the disclosed engagement sources."}},"additionalProperties":true},"totals":{"type":"object","properties":{"comparable_mentions":{"type":["number","null"],"description":"Common-source denominator."},"comparable_engagement":{"type":["number","null"],"description":"Observed interaction denominator."}},"additionalProperties":true}},"additionalProperties":true,"examples":[{"schema_version":"social-evidence-v2","scope":"native_social_search_sample","comparison":{"sources":["hackernews"]},"totals":{"comparable_mentions":2,"comparable_engagement":16},"brands":[{"brand":"My Brand","mentions":1,"comparable_mentions":1,"share_of_mentions":0.5,"share_of_engagement":0.75,"evidence":[{"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"}},"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."}},{"brand":"Other Brand","mentions":1,"comparable_mentions":1,"share_of_mentions":0.5,"share_of_engagement":0.25,"evidence":[{"id":"102","platform":"hackernews","source":"hackernews","title":"Using Other Brand","text":null,"url":"https://news.ycombinator.com/item?id=102","canonical_url":"https://news.ycombinator.com/item?id=102","author":{"id":null,"handle":"example_reader","name":null,"url":null},"metrics":{"likes":null,"score":2,"comments":2,"reshares":null,"views":null,"interactions":4,"complete_interactions":false},"engagement":4,"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":"Other Brand","params":{"query":"Other 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"}},"query_plan":{"version":"panorama-context-query-v1","subject":"Other Brand","query":"Other Brand","mode":"subject","context_terms":[],"source_order":["hackernews"],"lanes":[{"platform":"hackernews","query":"Other 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":"102","platform":"hackernews","source":"hackernews","title":"Using Other Brand","text":null,"url":"https://news.ycombinator.com/item?id=102","canonical_url":"https://news.ycombinator.com/item?id=102","author":{"id":null,"handle":"example_reader","name":null,"url":null},"metrics":{"likes":null,"score":2,"comments":2,"reshares":null,"views":null,"interactions":4,"complete_interactions":false},"engagement":4,"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":"Other Brand","params":{"query":"Other 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."}}]}]}