Panorama brand-mentions API

Endpoint

GET/v1/panorama/brand-mentionslive · provenUp to 5 credits

Parameters

Query parameters

Name	Required	Description	Example
`brand`	yes	The brand or product to find mentions of	`minoapi`
`platforms`	no	CSV of supported sources: reddit,hackernews,bluesky,github,x,tiktok,instagram,youtube,linkedin,threads,pinterest. Default the six example sources. Each remains subject to eligibility, funding, deadlines and limits.	`reddit,hackernews,x,tiktok,instagram,youtube`
`date_mode`	no	ranked (default) retains date-labelled matches; strict excludes unknown and out-of-window dates.	`strict`
`per_source_limit`	no	Integer 1–50, default25. Bounded sample per source; no full-platform count.	`25`
`lookback_days`	no	Integer1–366, default30.	`30`
`context`	no	Optional subject context, at most1000 characters. Adds a bounded hint from the caller’s positive context to native search and prioritises returned candidates; inspect query_plan and source queries. Also guides optional Jev classification where supported. No inferred aliases or identity guarantee.	`Mercury, the business banking service; not the planet.`
`relevance`	no	none (default) or jev. Optional funded classification on at most20 candidates per brand, balanced across sources within relevance tiers. All original evidence and sampled arithmetic remain available. Inspect selection and classified counts; capacity and funding can leave records unclassified.	`none`
`include_history`	no	Optional indexed web summary, trends and example citations. Defaultfalse. Reported separately from social sample metrics and subject to the same workflow supply budget.	`true`
`enrich`	no	none (default), comments or transcripts. Add context to at most3 supported posts, capped at10 comments or8000 transcript characters each. Enrichment is not counted as another mention.	`comments`
`dry_run`	no	Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution.	`1`

Examples

Make the request

curl

curl "https://www.monocrawl.com/v1/panorama/brand-mentions?brand=minoapi" \
  -H "x-api-key: mn_your_key_here"

TypeScript

typescript

const key = process.env.MONOCRAWL_API_KEY;
if (!key) throw new Error('Set MONOCRAWL_API_KEY on your server.');
const res = await fetch(
  "https://www.monocrawl.com/v1/panorama/brand-mentions?brand=minoapi",
  { headers: { "x-api-key": key } },
);
const body = await res.json();

if (!body.success) {
  // one error shape for every endpoint — see /docs/errors
  throw new Error(`${body.error.type}: ${body.error.message}`);
}

console.log(body.data, "credits left:", body.credits_remaining);

Python

python

import os
import requests

res = requests.get(
    "https://www.monocrawl.com/v1/panorama/brand-mentions?brand=minoapi",
    headers={"x-api-key": os.environ["MONOCRAWL_API_KEY"]},
    timeout=60,
)
body = res.json()

if not body["success"]:
    # one error shape for every endpoint — see /docs/errors
    raise RuntimeError(f"{body['error']['type']}: {body['error']['message']}")

print(body["data"], "credits left:", body["credits_remaining"])

Response

Response fields and example

This example is illustrative, not a captured live response. Variable-cost operations may settle a charge different from the list price below. A successful response puts the platform payload in data and reports the exact credits used, remaining balance, request id and cache status beside it.

200 · application/json

{
  "success": true,
  "platform": "panorama",
  "endpoint": "/v1/panorama/brand-mentions",
  "data": {
    "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."
    }
  },
  "credits_used": 5,
  "credits_remaining": 99,
  "request_id": "req_…",
  "cached": false
}

The example uses fictional values and shows a documented subset of data. The fields below are optional across supported sources; nullable fields can also be absent. Preserve unknown values and accept additional fields.

Download the data JSON Schema. Validate response.data, not the whole envelope. A valid shape does not establish that every field or source record was returned.

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

Counts describe the bounded returned social sample. Native keyword and hashtag coverage differ by platform.

strict dates exclude undated and outside-window records. ranked mode retains their labels. Literal keyword matching does not verify an entity.

Evidence is ordered by relevance tier and balanced across sources within each tier, preserving source page rank. Context supplies a bounded search hint from the caller’s words and lexical priority cues. Inspect query_plan and per-source queries; added terms can narrow retrieval and do not verify identity. Ordering and optional labels do not change sample counts or share denominators.

Use match_summary to distinguish supported matches, lexical candidates and no supported match. matched_items and candidate_items are views into the retained pool, not additional mentions. A complete relevance_analysis covers selected candidates only; remaining_unclassified includes both unselected and failed records.

Failures use the typed error envelope. A confirmed uncharged or refunded failure reports zero; a pending reconciliation can report an unknown charge. Read credits_used and error.details.billing_status, and keep request_id for recovery. Response contract · Error reference

Brand mentions

Query parameters

Make the request

Response fields and example

First call in under a minute

Brand mentions

Query parameters

Make the request

Response fields and example

More Panorama reference

First call in under a minute