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

# Introduction

> Find proven short-form video formats on TikTok and Douyin, and turn them into shoot-ready playbooks.

The Nouvel API gives you programmatic access to the same pipeline the Nouvel app runs on: keyword scans across TikTok and Douyin, frame-level playbooks for any reel, sound matching, and a conversational router that decides which of those a user's message actually needs.

> [!NOTE]
>
> Access is invite-only. If your account has not been granted API access, every endpoint returns `403 forbidden`.

## The four endpoints

> [card] [Assist](https://docs.nouvelhq.com/api-reference/assist.md)
>
> Classify a user's message and get back the call to make. **\$0.01**

> [card] [Scan](https://docs.nouvelhq.com/api-reference/scan.md)
>
> Up to 20 ranked reels for one brief. **\$0.15**

> [card] [Playbook](https://docs.nouvelhq.com/api-reference/playbook.md)
>
> Frame-level breakdown of one reel, with a shot list. **\$0.20**

> [card] [Music](https://docs.nouvelhq.com/api-reference/music.md)
>
> Sound recommendations matched to one video. **\$0.25**

## How the pieces fit

Most integrations follow one shape. A user types something, you ask Assist what it means, and Assist tells you which endpoint to call next.

```mermaid theme={null}
%%{init: {'theme':'base','themeVariables':{'fontFamily':'ui-sans-serif, system-ui, -apple-system, sans-serif','fontSize':'14px','primaryColor':'#F4F4F5','primaryTextColor':'#18181B','primaryBorderColor':'#D4D4D8','lineColor':'#A1A1AA','tertiaryColor':'#FAFAFA','clusterBkg':'#FAFAFA','clusterBorder':'#E4E4E7'}}}%%
flowchart LR
    U(["User message"]) --> A["POST /v1/assist<br/><b>$0.01</b>"]

    A -->|"intent: chat"| C(["Show the reply"])
    A -->|"intent: scan"| S["POST /v1/scan<br/><b>$0.15</b>"]

    S --> R[("Reels")]
    R --> P["POST /v1/playbook<br/><b>$0.20</b>"]
    R --> M["POST /v1/music<br/><b>$0.25</b>"]

    classDef billed fill:#FFF1E8,stroke:#FF5500,stroke-width:1.5px,color:#7A2900
    classDef free fill:#F4F4F5,stroke:#D4D4D8,stroke-width:1.5px,color:#3F3F46
    classDef stop fill:#FEF2F2,stroke:#DC2626,stroke-width:1.5px,color:#7F1D1D
    classDef good fill:#F0FDF4,stroke:#16A34A,stroke-width:1.5px,color:#14532D
    class A,S,P,M billed
    class U,C,R free
```

> [!NOTE]
>
> Orange steps cost credit. **You** decide when to take each one: Assist tells you what it thinks comes next and stops there, so nothing is ever billed without an explicit call from you.

**Assist never executes anything.** It returns the call it thinks you should make and stops there, so you decide whether to spend the credit. A misclassification costs you a cent, not a scan.

## Base URL

```
https://nouvelhq.com/api/v1
```

Every endpoint is `POST`, takes JSON, and returns JSON.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.