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

# Introduction

> Cloudglue API Reference

## Features

### Video Document Parsing

Foundational APIs that transform unstructured video and audio into structured, queryable context.

<CardGroup cols={3}>
  <Card title="Describe" icon="sparkles" href="/api-reference/endpoint/describe">
    Get a comprehensive moment-by-moment description on a video, including transcript, diarization, visual descriptions, audio desecriptions, sound, on-screen text, and more. Perfect for getting every detail on a video.
  </Card>

  <Card title="Extract" icon="table" href="/api-reference/endpoint/extract/post">
    Extract structured data from videos at scale, across modalities, using a prompt or custom schema. Making videos easy to program against, query against, and categorize in your application.
  </Card>

  <Card title="Segment" icon="scissors" href="/api-reference/endpoint/segments/post">
    Split videos into meaningful parts with  segmentation options like intelligent shot detection, and narrative (chapters). Turning videos into logical sequences.
  </Card>
</CardGroup>

### Video Reasoning

Higher-level APIs that enable multimodal search, chat, and reasoning directly over video content.

<CardGroup cols={3}>
  <Card title="Search" icon="magnifying-glass" href="/api-reference/endpoint/search/post">
    Add semantic search over videos and segments with natural-language queries. Enable this in your application with just a few lines of code.
  </Card>

  <Card title="Chat Completion" icon="message-bot" href="/api-reference/endpoint/chat/completions">
    Add conversational AI that can query, compare, and reason across hundreds of videos, complete with full citations, with just a few lines of code.
  </Card>

  <Card title="Responses API" icon="comments" href="/deep-dives/responses-api">
    Next-gen conversational API with streaming, entity-backed knowledge, multi-turn support, and background processing.
  </Card>
</CardGroup>

## Base URL

The base URL for all API endpoints is:

```
https://api.cloudglue.dev
```

## Authentication

For authentication, it’s required to include an Authorization header. The header should contain Bearer cg-123456789, where cg-123456789 represents your API Key.

```json theme={null}
Authorization: Bearer cg-123456789
```

## Response codes

Cloudglue employs traditional HTTP response codes.

| Status | Description                                      |
| ------ | ------------------------------------------------ |
| 200    | Request was successful                           |
| 400    | Bad Request. Check the parameters and try again. |
| 401    | API key is invalid or was not provided           |
| 402    | Insufficient credits on the account.             |
| 404    | Specific resource was not found                  |
| 429    | Usage limit has been exceeded.                   |
| 500    | Signifies a problem with Cloudglue.              |

Refer to the Error Codes section for a detailed explanation of all potential API errors.

## Usage limits

The Cloudglue API has a rate limit to ensure the stability and reliability of the service. You exceed the rate limit, you will receive a 429 error code.

For more information on the usage limits, please refer to the [Usage Limits](/getting-started/usage-limits) page.