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

# Watch Online Video

> Read what a video **shows**, along with what it says. The response holds the video's transcript and a list of `scenes`: for each one, when it starts and ends, a description of the picture, and the text readable on screen.

Works with every platform `POST /transcript` and `POST /transcribe` support. The transcript comes from the platform's captions when it has them, and from speech-to-text otherwise.

**Options:**
- `detail`: how closely the picture is followed (`low`, `auto`, `high`). The number of frames depends on the video at every level: few on a fixed shot, many on a fast-cut clip
- `include_transcript=false`: the scenes only
- `transcript_text=true`: the transcript as a single text string instead of segments

A video without speech is not an error: `transcript` is empty, `transcript_error` says why, and the scenes are returned.

Set `include_usage=true` to receive the `usage` block.

**Long videos:** this endpoint is synchronous. For media longer than ~10 minutes use `POST /watch/async` instead, which returns a `task_id` and can call your webhook when it finishes. See https://docs.vidnavigator.com/guides/async-jobs

Videos longer than 2 hours are not accepted (`video_too_long`), except on YouTube.

Read what a video **shows**, next to what it says: its transcript and a list of scenes, each with a description of the picture and the text readable on screen, in one response.

## Overview

A transcript holds what is said. This endpoint adds the picture. For each scene of the video you get when it starts and ends, a description of what is visible (people, setting, action, objects) and the text on screen (captions, titles, signs), verbatim.

Use it when the picture matters:

- a video with little or no speech,
- a product demo or a tutorial,
- prices, names or claims written on screen,
- checking that what is said matches what is shown.

The transcript comes with the scenes by default. It is taken from the platform's captions when it has them, and from speech-to-text otherwise. For the words alone, [`/transcript`](https://docs.vidnavigator.com/api-reference/endpoint/transcript.md) and [`/transcribe`](https://docs.vidnavigator.com/api-reference/endpoint/transcribe.md) remain the cheaper calls.

## Synchronous or async?

This endpoint comes in two modes, with the same request body and the same result:

| Mode        | Endpoint                                                                                   | Media duration                            | How you get the result                                                                        |
| ----------- | ------------------------------------------------------------------------------------------ | ----------------------------------------- | --------------------------------------------------------------------------------------------- |
| Synchronous | `POST /watch`                                                                              | **Up to 10 minutes**                      | In the HTTP response                                                                          |
| Async       | [`POST /watch/async`](https://docs.vidnavigator.com/api-reference/endpoint/watch-async.md) | **Up to 2 hours** (any length on YouTube) | Poll `GET /watch/{task_id}` or receive a [webhook](https://docs.vidnavigator.com/webhooks.md) |

> [!WARNING]
>
> **Media longer than 10 minutes is rejected by the synchronous endpoint** with `400 video_too_long`. Use the [async mode](https://docs.vidnavigator.com/api-reference/endpoint/watch-async.md) for anything that may run past 10 minutes. It also works for short videos, so it is the safe default when you don't know the duration.

## Billing

A watch request is charged for the fetch of the video, for the transcription when it is needed, and for the frames analyzed:

| Charge                                      | When                                                                                                                      | Amount                                        |
| ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- |
| `standard_request` or `residential_request` | Always: the fetch of the video, as on [`/transcript`](https://docs.vidnavigator.com/api-reference/endpoint/transcript.md) | 1 request                                     |
| `transcription_hour`                        | Only when the transcript needs speech-to-text, because the video has no captions                                          | The duration of the video: 1 credit = 3 hours |
| `frame_analysis`                            | Always: the picture                                                                                                       | 1 unit per frame: **1 credit = 1,000 frames** |

The number of frames follows the picture: few on a fixed shot, more when it changes often, and more at a higher [`detail`](#level-of-detail). A video is analyzed, and charged, for **at least 334 frames per hour of video**, in proportion to its length, so an hour of video watched never costs less than an hour of transcription.

As a guide, at the default level: a fixed shot stays at that minimum, about 0.33 credit per hour of video, and an hour of television programme is typically between 0.5 and 1 credit.

`include_transcript: false` leaves the transcription out, and its charge with it. When a request fails, the frames and the transcription are not charged.

Set `include_usage: true` to receive a [`usage`](https://docs.vidnavigator.com/api-reference/usage-costs.md#per-call-usage-disclosure) block with the breakdown: the `quantity` of its `frame_analysis` entry is the number of frames charged.

## Supported Platforms

Every platform supported by [`/transcript`](https://docs.vidnavigator.com/api-reference/endpoint/transcript.md) and [`/transcribe`](https://docs.vidnavigator.com/api-reference/endpoint/transcribe.md):

- YouTube
- TikTok
- Instagram
- X / Twitter
- Facebook (public videos only)
- Vimeo
- Dailymotion
- Loom
- Snapchat

Uploaded files are not supported by this endpoint.

## Request Parameters

| Parameter            | Type    | Required | Description                                                                                                                                                   |
| -------------------- | ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `video_url`          | string  | Yes      | URL of the video to watch. For Instagram carousel posts and Snapchat highlights, append `?img_index=N` to select a specific video.                            |
| `detail`             | string  | No       | How closely the picture is followed: `low`, `auto` (default) or `high`. See [Level of detail](#level-of-detail).                                              |
| `include_transcript` | boolean | No       | Default `true`. When `false`, only the scenes are returned and no transcript is fetched or produced.                                                          |
| `transcript_text`    | boolean | No       | When `true`, returns the transcript as a single plain-text string instead of an array of segments.                                                            |
| `include_usage`      | boolean | No       | When `true`, the response includes the [`usage`](https://docs.vidnavigator.com/api-reference/usage-costs.md#per-call-usage-disclosure) block of this request. |

## Level of detail

The number of frames analyzed depends on the video at every level: few on a fixed shot, many on a fast-cut clip. A frame is taken where the picture changes, and at least one every 10 seconds. `detail` sets how small a change counts:

| `detail` | Behavior                                                          |
| -------- | ----------------------------------------------------------------- |
| `low`    | Keeps the larger changes of picture.                              |
| `auto`   | The balanced default.                                             |
| `high`   | Follows faster cuts, and looks at a still picture twice as often. |

A higher level analyzes more frames on a video whose picture changes often. The response tells how many were analyzed in `frames_analyzed`.

## Example Usage

```bash cURL
curl -X POST "https://api.vidnavigator.com/v1/watch" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.tiktok.com/@nasa/video/7300000000000000000"
  }'
```

```python Python
from vidnavigator import VidNavigatorClient, VidNavigatorError

client = VidNavigatorClient()

try:
    result = client.watch_video(
        video_url="https://www.tiktok.com/@nasa/video/7300000000000000000"
    )
    print("Video Title:", result.data.video_info.title)
    for scene in result.data.scenes:
        print(f"[{scene.start:.0f}s - {scene.end:.0f}s] {scene.description}")
        if scene.on_screen_text:
            print("   on screen:", scene.on_screen_text)
    for segment in result.data.transcript or []:
        print(f"[{segment.start:.2f}s] {segment.text}")
except VidNavigatorError as e:
    print(f"An error occurred: {e.message}")
```

```javascript JavaScript
const { VidNavigatorClient, VidNavigatorError } = require('vidnavigator');

const client = new VidNavigatorClient({
  apiKey: process.env.VIDNAVIGATOR_API_KEY,
});

async function watchVideo() {
  try {
    const { video_info, scenes, transcript } = await client.watch(
      'https://www.tiktok.com/@nasa/video/7300000000000000000'
    );
    console.log('Video Title:', video_info.title);
    scenes.forEach(scene => {
      console.log(`[${scene.start}s - ${scene.end}s] ${scene.description}`);
      if (scene.on_screen_text) console.log('   on screen:', scene.on_screen_text);
    });
    (transcript || []).forEach(segment => {
      console.log(`[${segment.start.toFixed(2)}s] ${segment.text}`);
    });
  } catch (error) {
    if (error instanceof VidNavigatorError) {
      console.error(`An error occurred: ${error.message}`);
    } else {
      console.error('An unexpected error occurred:', error);
    }
  }
}

watchVideo();
```

> [!NOTE]
>
> Both SDKs run this call as a [background job](https://docs.vidnavigator.com/guides/async-jobs.md) (`POST /watch/async`, then polling), so it is not limited to 10 minutes of video.

### Scenes only

```bash
curl -X POST "https://api.vidnavigator.com/v1/watch" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_url": "https://www.tiktok.com/@nasa/video/7300000000000000000",
    "include_transcript": false,
    "detail": "high"
  }'
```

## Success Response (200 OK)

```json
{
  "status": "success",
  "data": {
    "video_info": {
      "title": "Evening news",
      "description": "An example description for the video.",
      "thumbnail": "https://example.com/thumbnail.jpg",
      "url": "https://www.tiktok.com/@nasa/video/7300000000000000000",
      "channel": "Example Creator",
      "duration": 24.0,
      "views": 123456,
      "likes": 7890,
      "published_date": "2026-07-01"
    },
    "transcript": [
      {
        "text": "Good evening. Tonight, the storm reaches the coast.",
        "start": 0.4,
        "end": 3.9
      }
    ],
    "scenes": [
      {
        "start": 0.0,
        "end": 4.0,
        "description": "A studio with a news desk. A presenter in a dark suit faces the camera.",
        "on_screen_text": ""
      },
      {
        "start": 4.0,
        "end": 12.0,
        "description": "A presenter stands in front of a world map and points at Europe.",
        "on_screen_text": "BREAKING NEWS"
      },
      {
        "start": 12.0,
        "end": 24.0,
        "description": "Waves break over a sea wall; a few people walk away from the shore.",
        "on_screen_text": "LIVE - 18:42"
      }
    ],
    "frames_analyzed": 23
  }
}
```

| Field                            | Description                                                                                                                                                                               |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `video_info`                     | The video's metadata, as on [`/transcript`](https://docs.vidnavigator.com/api-reference/endpoint/transcript.md).                                                                          |
| `transcript`                     | What is said: an array of segments, or one string with `transcript_text=true`. Left out when `include_transcript=false`; empty when the video has no transcript (see `transcript_error`). |
| `scenes`                         | What is shown, in chronological order.                                                                                                                                                    |
| `scenes[].start`, `scenes[].end` | Start and end of the scene, in seconds from the beginning of the video. A scene ends where the next one starts, or at the end of the video.                                               |
| `scenes[].description`           | What is visible: people, setting, action, objects.                                                                                                                                        |
| `scenes[].on_screen_text`        | Text readable on screen, verbatim. Empty when there is none.                                                                                                                              |
| `frames_analyzed`                | Number of frames of the video that were analyzed to produce the scenes.                                                                                                                   |
| `transcript_error`               | Present only when the transcript could not be had.                                                                                                                                        |

### A video without speech

A video without speech is not an error. The scenes are returned, `transcript` is empty and `transcript_error` says why. The same applies to a YouTube video that has no captions.

```json
{
  "status": "success",
  "data": {
    "video_info": { "title": "Timelapse of a harbour", "duration": 30.0 },
    "transcript": [],
    "transcript_error": {
      "error": "transcript_not_available",
      "message": "No transcript found for this video."
    },
    "scenes": [
      {
        "start": 0.0,
        "end": 30.0,
        "description": "A harbour at dusk, seen from above. Cranes unload a container ship while the sky darkens.",
        "on_screen_text": ""
      }
    ],
    "frames_analyzed": 6
  }
}
```

## Error Responses

| Status       | `error`                                                                          | Description                                                                                                                                                                                                         |
| ------------ | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `400`        | `missing_parameter`, `invalid_parameter`, `invalid_url`, `request_body_required` | Invalid request. An unknown `detail` is an `invalid_parameter`.                                                                                                                                                     |
| `400`        | `no_videos_found`                                                                | The post carries no video (e.g. an image-only carousel).                                                                                                                                                            |
| `400`        | `video_too_long`                                                                 | The media is longer than 10 minutes: use [`POST /watch/async`](https://docs.vidnavigator.com/api-reference/endpoint/watch-async.md). Videos longer than 2 hours are not accepted in either mode, except on YouTube. |
| `402`        | `limit_exceeded`                                                                 | Not enough credits.                                                                                                                                                                                                 |
| `403`        | `content_restricted`                                                             | The content requires login or age verification.                                                                                                                                                                     |
| `404`        | `video_unavailable`, `video_not_yet_available`                                   | The video is gone, or not published yet.                                                                                                                                                                            |
| `404`        | `frames_not_available`                                                           | The picture cannot be read: a live stream, or a clip of a few seconds.                                                                                                                                              |
| `404`        | `metadata_fetch_failed`                                                          | The video could not be reached after our retries. May be temporary.                                                                                                                                                 |
| `451`        | `geo_restricted`                                                                 | The content is not available in this region.                                                                                                                                                                        |
| `502`, `503` | `video_download_failed`, `watch_failed`, `watch_unavailable`                     | The video could not be watched this time. Temporary: try again.                                                                                                                                                     |

See [Errors](https://docs.vidnavigator.com/api-reference/errors.md) for the full list.

## OpenAPI

````yaml POST /watch
openapi: 3.0.3
info:
  title: VidNavigator Developer API
  version: 1.0.0
servers:
  - url: https://api.vidnavigator.com/v1
    description: Production server
security:
  - ApiKeyAuth: []
paths:
  /watch:
    post:
      summary: Watch a video
      description: |-
        Read what a video **shows**, along with what it says. The response holds the video's transcript and a list of `scenes`: for each one, when it starts and ends, a description of the picture, and the text readable on screen.

        Works with every platform `POST /transcript` and `POST /transcribe` support. The transcript comes from the platform's captions when it has them, and from speech-to-text otherwise.

        **Options:**
        - `detail`: how closely the picture is followed (`low`, `auto`, `high`). The number of frames depends on the video at every level: few on a fixed shot, many on a fast-cut clip
        - `include_transcript=false`: the scenes only
        - `transcript_text=true`: the transcript as a single text string instead of segments

        A video without speech is not an error: `transcript` is empty, `transcript_error` says why, and the scenes are returned.

        Set `include_usage=true` to receive the `usage` block.

        **Long videos:** this endpoint is synchronous. For media longer than ~10 minutes use `POST /watch/async` instead, which returns a `task_id` and can call your webhook when it finishes. See https://docs.vidnavigator.com/guides/async-jobs

        Videos longer than 2 hours are not accepted (`video_too_long`), except on YouTube.
      operationId: watchVideo
      tags:
        - Watch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - video_url
              properties:
                video_url:
                  type: string
                  format: uri
                  description: URL of the video to watch. For Instagram carousel posts and Snapchat highlights, append ?img_index=N to select a specific video.
                  example: https://www.tiktok.com/@nasa/video/7300000000000000000
                detail:
                  type: string
                  enum:
                    - low
                    - auto
                    - high
                  default: auto
                  description: How closely the picture is followed. At every level a frame is taken where the picture changes, and at least one every 10 seconds; the level sets how small a change counts. `low` keeps the larger changes, `auto` is the balanced default, `high` follows faster cuts and looks at a still picture twice as often. A higher level analyzes more frames on a video whose picture changes often.
                include_transcript:
                  type: boolean
                  default: true
                  description: When false, only the scenes are returned and no transcript is fetched or produced.
                transcript_text:
                  type: boolean
                  default: false
                  description: When true, returns the transcript as a single plain-text string instead of an array of segments.
                include_usage:
                  type: boolean
                  default: false
                  description: When true, the response includes the `usage` block of this request.
      responses:
        "200":
          description: The video was watched.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  data:
                    $ref: "#/components/schemas/WatchResult"
                  usage:
                    $ref: "#/components/schemas/UsageBlock"
        "400":
          description: Bad request — invalid parameters, no videos found, or the video exceeds the synchronous duration cap (`video_too_long`; use `POST /watch/async`).
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  error:
                    type: string
                    enum:
                      - request_body_required
                      - missing_parameter
                      - invalid_parameter
                      - invalid_url
                      - no_videos_found
                      - video_too_long
                  message:
                    type: string
        "402":
          $ref: "#/components/responses/PaymentRequired"
        "403":
          $ref: "#/components/responses/ContentRestricted"
        "404":
          description: "The video is gone (`video_unavailable`) or not published yet (`video_not_yet_available`), its picture cannot be read (`frames_not_available`: a live stream, or a clip of a few seconds), or we could not reach it after our retries (`metadata_fetch_failed` — may be temporary)."
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  error:
                    type: string
                    enum:
                      - video_unavailable
                      - video_not_yet_available
                      - frames_not_available
                      - metadata_fetch_failed
                  message:
                    type: string
        "451":
          $ref: "#/components/responses/GeoRestricted"
        "500":
          $ref: "#/components/responses/InternalServerError"
        "502":
          description: "The video could not be watched this time (`video_download_failed`, `watch_failed`, `watch_unavailable`). Temporary: try again."
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  error:
                    type: string
                    enum:
                      - video_download_failed
                      - watch_failed
                      - watch_unavailable
                  message:
                    type: string
        "503":
          description: "The video could not be watched this time (`video_download_failed`, `watch_failed`, `watch_unavailable`). Temporary: try again."
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  error:
                    type: string
                    enum:
                      - video_download_failed
                      - watch_failed
                      - watch_unavailable
                  message:
                    type: string
components:
  schemas:
    WatchResult:
      type: object
      description: "A watched video: its metadata, its transcript and its scenes."
      properties:
        video_info:
          $ref: "#/components/schemas/VideoInfo"
        transcript:
          allOf:
            - $ref: "#/components/schemas/TranscriptOutput"
          description: What is said. Left out when `include_transcript=false`; empty when the video has no transcript (see `transcript_error`).
        transcript_error:
          type: object
          description: Present only when the transcript could not be had, for instance on a video without speech. The scenes are returned all the same.
          properties:
            error:
              type: string
              example: transcript_not_available
            message:
              type: string
        scenes:
          type: array
          description: What is shown, in chronological order.
          items:
            $ref: "#/components/schemas/VideoScene"
        frames_analyzed:
          type: integer
          description: Number of frames of the video that were analyzed to produce the scenes.
          example: 23
    VideoInfo:
      type: object
      properties:
        title:
          type: string
          description: Video title
        description:
          type: string
          description: Video description
        thumbnail:
          type: string
          format: uri
          description: Video thumbnail URL
        url:
          type: string
          format: uri
          description: Video URL
        channel:
          type: string
          description: Channel name
        channel_url:
          type: string
          format: uri
          description: Channel URL
        duration:
          type: number
          description: Duration in seconds
        views:
          type: integer
          description: View count
        likes:
          type: integer
          description: Like count
        published_date:
          type: string
          description: Publication date
        keywords:
          type: array
          items:
            type: string
          description: Video keywords/tags
        category:
          type: string
          description: Video category
        available_languages:
          type: array
          items:
            type: string
          description: Available transcript languages
        selected_language:
          type: string
          description: Selected transcript language
        carousel_info:
          $ref: "#/components/schemas/VideoCarouselInfo"
          description: Present only for carousel posts (e.g., Instagram posts with multiple videos)
    VideoCarouselInfo:
      type: object
      description: Carousel information for a single video within a carousel post
      properties:
        total_items:
          type: integer
          description: Total number of items in the carousel (videos + images)
        video_count:
          type: integer
          description: Number of videos in the carousel
        image_count:
          type: integer
          description: Number of images in the carousel
        selected_index:
          type: integer
          description: 1-based index of the selected video
    TranscriptOutput:
      description: Transcript output. By default it is an array of segments. When `transcript_text=true`, it is returned as a single plain-text string.
      oneOf:
        - type: array
          items:
            $ref: "#/components/schemas/TranscriptSegment"
        - type: string
    TranscriptSegment:
      type: object
      properties:
        text:
          type: string
          description: Transcript text for this segment
        start:
          type: number
          description: Start time in seconds
        end:
          type: number
          description: End time in seconds
    VideoScene:
      type: object
      description: What the video shows between `start` and `end`.
      properties:
        start:
          type: number
          description: Start of the scene, in seconds from the beginning of the video.
        end:
          type: number
          description: "End of the scene, in seconds: the start of the next scene, or the end of the video."
        description:
          type: string
          description: "What is visible: people, setting, action, objects."
        on_screen_text:
          type: string
          description: Text readable on screen (captions, titles, signs), verbatim. Empty when there is none.
      required:
        - start
        - end
        - description
        - on_screen_text
      example:
        start: 4
        end: 12
        description: A presenter stands in front of a world map and points at Europe.
        on_screen_text: BREAKING NEWS
    UsageBlock:
      type: object
      description: |-
        Per-call usage, returned only when the request sets `include_usage=true`: the charges of this request, one entry per `service_type`, and the total credits deducted. A waived charge carries `waived: true` and `credits_saved`, with a top-level `waived.credits_saved` summary.

        For endpoints that run an AI analysis (`/extract/video`, `/extract/file`, `/analyze/video`, `/analyze/file`, `/youtube/search`), the `analysis_request` entry carries a nested `tokens` object with the request's token counts.
      properties:
        charges:
          type: array
          description: The charges of this request, one entry per `service_type`. A charge reversed within the request is left out.
          items:
            type: object
            properties:
              service_type:
                type: string
                enum:
                  - standard_request
                  - residential_request
                  - transcription_hour
                  - analysis_request
                  - search_request
                  - scene_analysis_hour
                  - frame_analysis
                description: The kind of charge.
              quantity:
                type: number
                description: Net units consumed (hours for `transcription_hour`, frames for `frame_analysis`).
              credits:
                type: number
                description: Net credits deducted for this charge; 0 when it was waived.
              waived:
                type: boolean
                description: True when this charge was waived.
              credits_saved:
                type: number
                description: When waived=true, the credits that would have been charged otherwise.
              tokens:
                type: object
                description: "Only on the `analysis_request` entry of endpoints that run an AI analysis: the request's total token counts."
                properties:
                  prompt_tokens:
                    type: integer
                    description: Total input tokens.
                  completion_tokens:
                    type: integer
                    description: Total output tokens.
                  total_tokens:
                    type: integer
                    description: Sum of `prompt_tokens` + `completion_tokens`.
        total_credits:
          type: number
          description: Net credits deducted by this request (sum of all `charges[].credits`).
        waived:
          type: object
          description: Present only when one or more charges in this request were waived.
          properties:
            credits_saved:
              type: number
              description: Total credits waived on this request.
  responses:
    PaymentRequired:
      description: Usage limit exceeded - upgrade required
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                enum:
                  - error
              error:
                type: string
                enum:
                  - limit_exceeded
              message:
                type: string
    ContentRestricted:
      description: Content restricted - requires login or age verification
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                enum:
                  - error
              error:
                type: string
                enum:
                  - content_restricted
              message:
                type: string
    GeoRestricted:
      description: Content not available in your region
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                enum:
                  - error
              error:
                type: string
                enum:
                  - geo_restricted
              message:
                type: string
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            type: object
            properties:
              status:
                type: string
                enum:
                  - error
              error:
                type: string
                enum:
                  - metadata_fetch_failed
                  - audio_extraction_failed
                  - transcription_failed
                  - internal_server_error
              message:
                type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API key authentication. Include your VidNavigator API key in the X-API-Key header.
````
