---
title: "Guest Intelligence — per-episode multi-role read for a show / creator: video sentiment, per-cast-member (host / co-host / guest / mentioned) sentiment + top praise + top criticism ranked by engagement, Claim Truth verdicts tied to each cast entity, low-confidence NER conflation warnings, plus a Guest Impact roll-up of which appearances moved AI Visibility 7d pre → 7d post. Coded reduction over stored comment_signal + episode_entity + score_snapshots + claim-truth. Zero LLM cost."
method: GET
path: "/entities/{entityId}/guest-intelligence"
tags: ["Layer 1 — Profile"]
---

# Guest Intelligence — per-episode multi-role read for a show / creator: video sentiment, per-cast-member (host / co-host / guest / mentioned) sentiment + top praise + top criticism ranked by engagement, Claim Truth verdicts tied to each cast entity, low-confidence NER conflation warnings, plus a Guest Impact roll-up of which appearances moved AI Visibility 7d pre → 7d post. Coded reduction over stored comment_signal + episode_entity + score_snapshots + claim-truth. Zero LLM cost.

`GET /entities/{entityId}/guest-intelligence`

## Request

- Base URL: `https://entidex.com/api/v1`
- URL: `https://entidex.com/api/v1/entities/{entityId}/guest-intelligence`
- Auth: HTTP bearer

## Path parameters

- `entityId` string, required

## Response `200`

Guest Intelligence payload, or { available: false } when the entity has no episodes or no attributed comment signal.

- union
  - GuestIntelligence
    - `entityId` string, required
    - `available` true, required
    - `computationVersion` string, required
    - `computedAt` string, date-time, required
    - `latestEpisode` GuestIntelligenceEpisodeCastRead
      - `episodeId` string, required
      - `platform` string, required
      - `platformId` string, required
      - `title` string, nullable
      - `publishedAt` string, date-time, nullable
      - `videoSentiment` object, required
        - `sampleSize` integer, required
        - `positivePct` integer, nullable, required
        - `negativePct` integer, nullable, required
      - `totalComments` integer, required
      - `cast` GuestIntelligenceCastMember[], required
        - `entityId` string, required
        - `entitySlug` string, required
        - `entityName` string, required
        - `role` 'owner' | 'host' | 'co_host' | 'guest' | 'panellist' | 'mentioned' | 'sponsor', required
        - `linkConfidence` number, nullable
        - `sentiment` object, required
          - `sampleSize` integer, required
          - `positivePct` integer, nullable, required
          - `negativePct` integer, nullable, required
        - `topPraise` GuestIntelligenceCastCommentQuote[], required
          - `text` string, required
          - `authorHandle` string, nullable
          - `likeCount` integer, required
          - `publishedAt` string, date-time, nullable
          - `platformCommentId` string, required
        - `topCriticism` GuestIntelligenceCastCommentQuote[], required
          - `text` string, required
          - `authorHandle` string, nullable
          - `likeCount` integer, required
          - `publishedAt` string, date-time, nullable
          - `platformCommentId` string, required
        - `claimVerdicts` object[], required
          - `claim` string, required
          - `verdict` string, required: Claim Truth Engine verdict (contradicted | disputed | died | corroborated | published | propagating | confirmed | surfaced).
          - `verifiedPosition` string, nullable
          - `evidenceDate` string, date-time, nullable
        - `conflation` object, nullable
          - `reason` string, required
          - `ambiguousComments` integer, required
    - `recentEpisodes` GuestIntelligenceEpisodeCastRead[], required
      - `episodeId` string, required
      - `platform` string, required
      - `platformId` string, required
      - `title` string, nullable
      - `publishedAt` string, date-time, nullable
      - `videoSentiment` object, required
        - `sampleSize` integer, required
        - `positivePct` integer, nullable, required
        - `negativePct` integer, nullable, required
      - `totalComments` integer, required
      - `cast` GuestIntelligenceCastMember[], required
        - `entityId` string, required
        - `entitySlug` string, required
        - `entityName` string, required
        - `role` 'owner' | 'host' | 'co_host' | 'guest' | 'panellist' | 'mentioned' | 'sponsor', required
        - `linkConfidence` number, nullable
        - `sentiment` object, required
          - `sampleSize` integer, required
          - `positivePct` integer, nullable, required
          - `negativePct` integer, nullable, required
        - `topPraise` GuestIntelligenceCastCommentQuote[], required
          - `text` string, required
          - `authorHandle` string, nullable
          - `likeCount` integer, required
          - `publishedAt` string, date-time, nullable
          - `platformCommentId` string, required
        - `topCriticism` GuestIntelligenceCastCommentQuote[], required
          - `text` string, required
          - `authorHandle` string, nullable
          - `likeCount` integer, required
          - `publishedAt` string, date-time, nullable
          - `platformCommentId` string, required
        - `claimVerdicts` object[], required
          - `claim` string, required
          - `verdict` string, required: Claim Truth Engine verdict (contradicted | disputed | died | corroborated | published | propagating | confirmed | surfaced).
          - `verifiedPosition` string, nullable
          - `evidenceDate` string, date-time, nullable
        - `conflation` object, nullable
          - `reason` string, required
          - `ambiguousComments` integer, required
    - `guestImpact` object, required
      - `windowDays` integer, required
      - `totalAppearances` integer, required
      - `guests` GuestIntelligenceImpactRow[], required
        - `entityId` string, required
        - `entitySlug` string, required
        - `entityName` string, required
        - `appearances` integer, required
        - `meanVisibilityDelta` number, nullable
        - `meanSentimentDelta` number, nullable
        - `latestAppearanceAt` string, date-time, nullable
      - `topLifters` GuestIntelligenceImpactRow[], required
        - `entityId` string, required
        - `entitySlug` string, required
        - `entityName` string, required
        - `appearances` integer, required
        - `meanVisibilityDelta` number, nullable
        - `meanSentimentDelta` number, nullable
        - `latestAppearanceAt` string, date-time, nullable
      - `topDrags` GuestIntelligenceImpactRow[], required
        - `entityId` string, required
        - `entitySlug` string, required
        - `entityName` string, required
        - `appearances` integer, required
        - `meanVisibilityDelta` number, nullable
        - `meanSentimentDelta` number, nullable
        - `latestAppearanceAt` string, date-time, nullable
    - `methodology` string, required
    - `provenance` object, required
      - `issuer` string, required
      - `methodologyUrl` string, uri, required
      - `note` string, required
  - GuestIntelligenceUnavailable
    - `entityId` string, required
    - `available` false, required
    - `reason` 'no_episodes' | 'no_signal_yet' | 'entity_out_of_scope' | 'disabled', required

## Other responses

- `404`: Entity or resource not found.

---

[API](https://skmtc.dev/entidex/apis/entidex-api.md) · [All operations](https://skmtc.dev/entidex/apis/entidex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/entidex/apis/entidex-api/revisions/86b92f21a09a?raw)