> ## Documentation Index
> Fetch the complete documentation index at: https://docs.babbl-labs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Field Categories

Field categories organize the Extended Dataset's 24 fields into logical groupings for easier understanding and implementation.

## Channel Fields

YouTube channel metadata and coverage information.

| Field                                | Type   | Description                                                  |
| ------------------------------------ | ------ | ------------------------------------------------------------ |
| **channel\_id**                      | STRING | Immutable Babbl Labs internal unique identifier (UUID)       |
| **channel\_custom\_url**             | STRING | Mutable custom URL for channel                               |
| **channel\_name**                    | STRING | Channel title from YouTube metadata                          |
| **channel\_description**             | STRING | Channel description from YouTube metadata (default: NONE)    |
| **channel\_locale**                  | STRING | Geographic country code (ISO 3166-1 alpha-2) (default: NONE) |
| **channel\_published\_at**           | FLOAT  | Unix timestamp when channel was created                      |
| **channel\_coverage\_initiated\_at** | FLOAT  | Unix timestamp when we initiated coverage                    |

## Video Fields

Video-level metadata and publication information.

| Field                    | Type   | Description                                             |
| ------------------------ | ------ | ------------------------------------------------------- |
| **video\_published\_at** | FLOAT  | Unix timestamp when video was originally published      |
| **video\_title**         | STRING | Video title from YouTube metadata                       |
| **video\_description**   | STRING | Video description from YouTube metadata (default: NONE) |
| **video\_language**      | STRING | Video language code (ISO 639-1)                         |

## Processing Fields

Data processing timeline and model versioning information.

| Field                           | Type   | Description                                    |
| ------------------------------- | ------ | ---------------------------------------------- |
| **downloaded\_at**              | FLOAT  | Unix timestamp when we downloaded video        |
| **transcribed\_at**             | FLOAT  | Unix timestamp when we transcribed video       |
| **transcription\_version\_tag** | STRING | Identifier for transcription model used        |
| **recorded\_at**                | FLOAT  | Unix timestamp when video was added to dataset |

## Segment Fields

Transcript segment identification, timing, and content information.

| Field                    | Type   | Description                                                     |
| ------------------------ | ------ | --------------------------------------------------------------- |
| **segment\_id**          | STRING | Unique identifier for transcript segment across all videos      |
| **segment\_start\_ts**   | FLOAT  | Starting point in seconds from video start                      |
| **segment\_end\_ts**     | FLOAT  | End point in seconds from video start                           |
| **segment\_text**        | STRING | Complete verbatim transcript text for segment (5-60s of speech) |
| **segment\_char\_start** | INT    | Character index from start of video transcript                  |
| **segment\_char\_end**   | INT    | Character index to end of segment in transcript                 |

## Speaker Fields

Speaker identification and context information (fields with NONE defaults).

| Field                           | Type   | Description                                                   |
| ------------------------------- | ------ | ------------------------------------------------------------- |
| **speaker\_name**               | STRING | Name of speaker if identifiable (default: NONE)               |
| **speaker\_associated\_entity** | STRING | Entity/company speaker is associated with (default: NONE)     |
| **speaker\_position**           | STRING | Known title of speaker (default: NONE)                        |
| **speaker\_role\_context**      | STRING | Role within video context (HOST, GUEST, etc.) (default: NONE) |

## Transcript Metrics

Complete transcript statistics and duration information.

| Field                              | Type  | Description                                   |
| ---------------------------------- | ----- | --------------------------------------------- |
| **transcript\_total\_char\_count** | INT   | Total characters in complete video transcript |
| **transcript\_total\_duration**    | FLOAT | Total video duration in seconds               |

## Data Types & Constraints

| Type       | Format                | Example  |
| ---------- | --------------------- | -------- |
| **STRING** | Variable-length text  | `"CNBC"` |
| **FLOAT**  | Floating-point number | `49.5`   |
| **INT**    | Integer number        | `3543`   |

<Note>
  All timestamp fields use Unix timestamp format. Fields with NONE defaults handle missing information gracefully. Geographic codes follow ISO 3166-1 alpha-2, language codes follow ISO 639-1.
</Note>