Create a video - LocalAds API

curl --request POST \
  --url https://makelocalads.com/api/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "ugc",
  "product_id": "a1516a75-9be5-461a-93af-c1896a0a3127",
  "audience_id": "0f0c5a4e-54f7-4f0e-9d4e-1a8c3a6b5d11"
}
'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "type": "ugc",
  "product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "queued",
  "title": "<string>",
  "recipe_id": "<string>",
  "audience_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "source_creative_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "video_url": "<string>",
  "thumbnail_url": "<string>",
  "duration_seconds": 123,
  "aspect_ratio": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "credits_charged": 123
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

POST

videos

curl --request POST \
  --url https://makelocalads.com/api/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "ugc",
  "product_id": "a1516a75-9be5-461a-93af-c1896a0a3127",
  "audience_id": "0f0c5a4e-54f7-4f0e-9d4e-1a8c3a6b5d11"
}
'

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "type": "ugc",
  "product_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "queued",
  "title": "<string>",
  "recipe_id": "<string>",
  "audience_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "source_creative_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "video_url": "<string>",
  "thumbnail_url": "<string>",
  "duration_seconds": 123,
  "aspect_ratio": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "credits_charged": 123
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "code": "<string>",
  "request_id": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key

string

Optional caller-generated value that prevents duplicate generation when retrying the same request.

Required string length: 1 - 255

Body

application/json

Option 1
Option 2

type

string

required

Allowed value: "ugc"

product_id

string<uuid>

required

audience_id

string<uuid> | null

required

Required. A saved audience of the product, from GET /products/{product_id}/audiences, or null for a broad video.

recipe_id

string

default:ugc-30s-voiceover

concept_id

string<uuid>

A concept from GET /video-concepts for this product.

voice_id

string<uuid>

A voice from GET /voices.

max_credits

integer

Refuse the request with 422 credit_limit_exceeded, before anything is charged, if it would cost more than this many credits.

Required range: x >= 1

Response

Video accepted.

string<uuid>

required

type

enum<string>

required

Available options:

ugc,

animation

product_id

string<uuid>

required

status

enum<string>

required

Available options:

queued,

in_progress,

completed,

failed,

canceled

title

string | null

required

recipe_id

string | null

required

audience_id

string<uuid> | null

required

source_creative_id

string<uuid> | null

required

video_url

string<uri> | null

required

thumbnail_url

string<uri> | null

required

duration_seconds

integer | null

required

aspect_ratio

string | null

required

created_at

string<date-time>

required

credits_charged

integer

required

Net credits charged. A failed render is refunded.

Last modified on September 30, 2026