---
title: "YouTube Intelligence — the channel-authority + audience read for a show/creator: channel stats, a daily sentiment timeline with anomaly flags, per-episode sentiment + comment-intent breakdown, top audience questions, the overall intent distribution, and topic ownership (per-episode + per-guest). Coded read over stored YouTube comment + transcript signal. Zero LLM cost."
method: GET
path: "/entities/{entityId}/youtube-intelligence"
tags: ["Layer 1 — Profile"]
---

# YouTube Intelligence — the channel-authority + audience read for a show/creator: channel stats, a daily sentiment timeline with anomaly flags, per-episode sentiment + comment-intent breakdown, top audience questions, the overall intent distribution, and topic ownership (per-episode + per-guest). Coded read over stored YouTube comment + transcript signal. Zero LLM cost.

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

## Request

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

## Path parameters

- `entityId` string, required

## Response `200`

YouTube Intelligence payload, or { available: false } when the entity has no YouTube footprint yet.

- union
  - YouTubeIntelligence
    - `entityId` string, required
    - `entitySlug` string, required
    - `available` true, required
    - `windowDays` integer, required
    - `channel` object, nullable, required
      - `subscriberCount` integer, nullable
      - `totalViewCount` integer, nullable
      - `videoCount` integer, nullable
      - `fetchedAt` string, date-time, nullable
    - `sentimentTimeline` object[], required
      - `date` string, date
      - `total` integer
      - `positive` integer
      - `neutral` integer
      - `negative` integer
      - `isAnomaly` boolean
    - `anomalyCount` integer, required
    - `episodes` object[], required
      - `episodeId` string
      - `platformId` string
      - `title` string, nullable
      - `publishedAt` string, date-time, nullable
      - `totalComments` integer
      - `positive` integer
      - `neutral` integer
      - `negative` integer
      - `positiveRatio` number
      - `intentDistribution` object
    - `topQuestions` object[], required
      - `commentText` string
      - `authorHandle` string, nullable
      - `publishedAt` string, date-time, nullable
      - `likeCount` integer
      - `replyCount` integer
      - `episodeTitle` string, nullable
    - `intentSummary` object, required
      - `total` integer
      - `distribution` object
      - `distributionPct` object
      - `topIntent` string
    - `episodeTopics` object[], required
      - `episodeId` string
      - `platformId` string
      - `title` string, nullable
      - `topics` YouTubeTopic[]
        - `topic` string, required
        - `count` integer, required
        - `density` number, required
      - `entityMentionDensity` number
      - `wordCount` integer
    - `guestTopics` object[], required
      - `guestSlug` string
      - `guestName` string
      - `episodeCount` integer
      - `topics` YouTubeTopic[]
        - `topic` string, required
        - `count` integer, required
        - `density` number, required
      - `avgEntityMentionDensity` number
  - YouTubeIntelligenceUnavailable
    - `entityId` string, required
    - `available` false, required
    - `reason` 'no_footprint' | 'no_signal_yet' | '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)