---
title: uruads API reference
description: REST API for AI video and image generation, avatars, auto-editing, competitor research and social scheduling.
canonical: https://uruads.ai/docs/api
---

# uruads REST API

Base URL: `https://uruads.ai/api/external/v1`

Authenticate every request with `Authorization: Bearer <api-key>`. The complete
machine-readable description is at <https://uruads.ai/openapi.json> — 53 paths
and 66 operations, each with a unique `operationId` and a description.

## Surface

| Area | Endpoints |
| --- | --- |
| Account and brands | `/account`, `/brands` |
| Video | `/videos/generate`, `/videos/{id}`, `/videos/auto-edit`, `/videos/longform-edit`, `/videos/motion-broll`, `/videos/compose-scenes` |
| Image | `/images/generate`, `/images/{id}`, `/images/soul-styles` |
| Avatars and characters | `/avatar-loops/generate`, `/avatar-loops/{id}`, `/characters` |
| Editing | `/edit/projects`, `/edit/versions/{id}`, `/edit-presets` |
| Research | `/inspiration/search`, `/inspiration/winners`, `/inspiration/competitor-gap`, `/competitors`, `/trends/search` |
| Performance | `/performance/accounts`, `/performance/posts`, `/performance/refresh` |
| Planning | `/plans`, `/plans/generate`, `/plans/{id}/execute` |
| Publishing | `/schedule`, `/social-accounts`, `/satellites` |
| Assets and audio | `/assets`, `/assets/ingest`, `/voices`, `/tts/generate`, `/subtitles/templates` |

## Asynchronous work

Generation endpoints return a job rather than a finished asset. Poll the
matching status endpoint — do not re-issue the request, which is charged again.

## Errors

Every error returns JSON with an `error` field. A 401 carries
`WWW-Authenticate` with a `resource_metadata` pointer to
<https://uruads.ai/.well-known/oauth-protected-resource>.

See <https://uruads.ai/auth.md> for credentials and <https://uruads.ai/developers>
for the quickstart.