Docs · Platform API

MakeUGC Platform API

The MakeUGC Platform API lets partners generate AI UGC videos, list avatars and voices, create custom avatars, and run Product-in-Hand or Content Library jobs from their own stack.

Base URL

All documented v1 routes are served from a single HTTPS origin:

https://app.makeugc.ai/api/platform

How these docs are organized

• API v1 — version overview and endpoint index
• Authentication — API keys and request headers
• Errors — HTTP status codes and failure payloads
• Rate limits — credits, script length, and polling
• Endpoint pages — one topic each: video, custom avatar, Product-in-Hand, shopable, Content Library, and MCP

Quickstart: list avatars

After you have a key, list template and custom avatars. Filter with the optional gender query parameter.

curl -X GET "https://app.makeugc.ai/api/platform/video/avatars" \
  -H "X-Api-Key: YOUR_API_KEY"

const response = await fetch("https://app.makeugc.ai/api/platform/video/avatars", {
  headers: { "X-Api-Key": "YOUR_API_KEY" },
});
const payload = await response.json();

import requests

response = requests.get(
    "https://app.makeugc.ai/api/platform/video/avatars",
    headers={"X-Api-Key": "YOUR_API_KEY"},
)
print(response.json())

Response

{
  "status": true,
  "message": "Avatars fetched",
  "data": [
    {
      "id": "avatar_123",
      "name": "Avatar Name",
      "thumbnail": "https://...",
      "gender": "Male"
    }
  ]
}