MMEDIARAZZIVIDEO AD SERVING TECHNOLOGY
DEVELOPERS · ADVANCED

Developer API overview

Authenticated JSON access to commercials, pods, saved tags and statistics.

The MEDIARAZZI management API is available at:

https://mediarazzi.com/api/v1

It is not the VAST delivery service. Public playback still uses https://ads.mediarazzi.com/vast/.... The API is intended for trusted backend integrations and development tools.

Authentication

Create a key under Developer Tools → Developer API. Send it with each request:

Authorization: Bearer YOUR_PRIVATE_API_KEY
Accept: application/json

Do not paste a secret API key into a web page, mobile client, public GitHub repository, screenshot, or VAST tag. Use server-side access and revoke exposed keys immediately.

Supported resources in the current release

The current API supports listing and creating commercials, selected commercial reads/updates/deletes, video upload, listing and creating pods, replacing pod items, listing/creating/deleting saved tags, and grouped statistics. There is no general-purpose SDK published yet. A versioned OpenAPI description is available from the running installation at /api/openapi.json.

Responses

Requests return JSON. A browser visit to the API without a bearer key returns 401 with a JSON error; that is normal, not a missing page.

Limits

The current implementation enforces approximately 120 authenticated requests per API key per minute and restricts responses to the authenticated account. Read-only keys cannot perform writes.