Skip to main content
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.
Access is invite-only. If your account has not been granted API access, every endpoint returns 403 forbidden.

​
The four endpoints

Assist

Classify a user’s message and get back the call to make. $0.01

Scan

Up to 20 ranked reels for one brief. $0.15

Playbook

Frame-level breakdown of one reel, with a shot list. $0.20

Music

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.
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

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