How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

MediaMath Video Creatives API

Video Creatives API (v1.0) for hosted video and audio creative management — reserving creative records, obtaining presigned S3 upload URLs, polling encode status through Pending/Processing/Finished, listing encoded variants, managing companion banners, validating VAST tags and retrieving VAST XML. Also exposes IAB attribute, IAB vertical and language reference collections and creative classification.

MediaMath Video Creatives API is one of 46 APIs that MediaMath publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Video, Creatives, VAST, Encoding, and CTV. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and rate-limit docs.

This API exposes 46 operations across 36 paths, organized into 6 resource areas, and defines 49 schemas. It is described by OpenAPI 3.0.0, at version v1.0.

Requests are made against a single base URL, https://api.mediamath.com.

46 operations 36 paths 49 schemas 2 DELETE26 GET2 PATCH15 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
v1.0
Base URL
https://api.mediamath.com
Authentication
OAuth 2.0
License
Resource Areas
6

Authentication & Security 1

MediaMath Video Creatives API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (OAuth2) using the password flow.

Paths & Operations 46

Across 36 paths, the API surfaces 46 operations — 2 DELETE, 26 GET, 2 PATCH, 15 POST, 1 PUT. They span 6 resource areas: Video Creative Management (V2), IAB (V1.0 - Deprecated), Classification (V1.0 - Deprecated), Video Creative Management (V3), Classification (V3), IAB Data (V3). Each is listed below with its method, path, parameters, and response codes.

Video Creative Management (V2) 10

V2.0 video creative endpoints (legacy)

GET
/video/v2.0/creatives/{video_id}/companions
Get Video Creative Companions
GET_video-v2-0-creatives-video_id-companions 1 param → 200404
POST
/video/v2.0/creatives/{video_id}/companions
Create Video Creative Companions
POST_video-v2-0-creatives-video_id-companions 1 param body → 201400404
POST
/video/v2.0/creatives/{video_id}/upload
Upload Video Creative
POST_video-v2-0-creatives-video_id-upload 2 params body → 200400404
GET
/video/v2.0/creatives/{video_id}/variants
Get Video Creative Variants
GET_video-v2-0-creatives-video_id-variants 1 param → 200404
GET
/video/v2.0/creatives/{video_id}/variants/{variant_id}
Get Video Creative Variant
GET_video-v2-0-creatives-video_id-variants-variant_id 2 params → 200404
GET
/video/v2.0/creatives/{video_id}/status
Get Video Creative Status
GET_video-v2-0-creatives-video_id-status 1 param → 200404
GET
/video/v2.0/creatives/{video_id}/companions/{companion_id}/delete
Delete Video Creative Companion
GET_video-v2-0-creatives-video_id-companions-companion_id-delete 2 params → 200404
POST
/video/v2.0/creatives/validateVAST
Validate VAST XML
POST_video-v2-0-creatives-validateVAST body → 200
GET
/video/v2.0/creatives/{video_id}/vast
Get Video creative VAST XML
Get-Video-creative-VAST-XML 1 param → 200404
POST
/video/v2.0/creatives/{video_id}/vast/extension
Update creative VAST with Extension node
Update-creative-VAST-with-Extension-node 1 param body → 200400404
IAB (V1.0 - Deprecated) 6

{% admonition type="danger" name="This API is deprecated and will be removed in July 2026" %} Please migrate to the IAB Data API v3.0 (GET /v3.0/staticdata/{category}) documented…

GET
/static_data/v1.0/iab_attributes
Get IAB Attributes List
GET_static_data-v1-0-iab_attributes → 200
GET
/static_data/v1.0/language/{language_id}
Get IAB Language
GET_static_data-v1-0-language-language_id 1 param body → 200
GET
/static_data/v1.0/iab_verticals
List IAB Verticals
GET_static_data-v1-0-iab_verticals → 200
GET
/static_data/v1.0/iab_verticals/{vertical_id}
Get IAB Vertical
GET_static_data-v1-0-iab_verticals-vertical_id 1 param → 200
GET
/static_data/v1.0/language
List IAB Languages
GET_static_data-v1-0-language → 200
GET
/static_data/v1.0/iab_attributes/{id}
Get IAB Attribute
Get-IAB-Attribute 1 param → 200
Classification (V1.0 - Deprecated) 6

{% admonition type="danger" name="This API is deprecated and will be removed in July 2026" %} Please migrate to the Classification API v3.0 documented below. {% /admonition %} {%…

GET
/classification/v1.0/{creative_id}/inflate
Get Inflated Classification
GET_classification-v1-0-creative_id-inflate 1 param → 200
GET
/classification/v1.0/bulk/{creative_ids}/inflate
Bulk Inflated Classification
GET_classification-v1-0-bulk-creative_ids-inflate 1 param → 200
GET
/classification/v1.0/bulk/{creative_ids}
Bulk Classification
GET_classification-v1-0-bulk-creative_ids 1 param → 200
POST
/classification/v1.0/bulk
Bulk Update Classification
POST_classification-v1-0-bulk body → 200
POST
/classification/v1.0/{creative_id}
Update Classification
POST_classification-v1-0-creative_id 1 param body → 200
GET
/classification/v1.0/{creative_id}
Get Classification
GET_classification-v1-0-creative_id 1 param → 200
Video Creative Management (V3) 15

V3.0 video creative management endpoints

PUT
/v3.0/creatives/bulk
Bulk create video creatives
PUT_v3-0-creatives-bulk body → 201400
PATCH
/v3.0/creatives/bulk
Bulk update video creatives
PATCH_v3-0-creatives-bulk body → 201400
POST
/v3.0/creatives
Create a new video creative
POST_v3-0-creatives body → 201400
POST
/v3.0/creatives/list
Bulk get creatives by IDs
POST_v3-0-creatives-list body → 200400
GET
/v3.0/creatives/{creativeId}
Get creative details
GET_v3-0-creatives-creativeId 1 param → 200404
POST
/v3.0/creatives/{creativeId}
Update video creative (full update)
POST_v3-0-creatives-creativeId 1 param body → 200400404
PATCH
/v3.0/creatives/{creativeId}
Update video creative (partial update)
PATCH_v3-0-creatives-creativeId 1 param body → 201400404
POST
/v3.0/creatives/validateVAST
Validate VAST XML - V3
POST_v3-0-creatives-validateVAST body → 200401
GET
/v3.0/creatives/{creativeId}/history
List history for a creative - V3
GET_v3-0-creatives-creativeId-history 5 params → 200404
DELETE
/v3.0/creatives/{creativeId}/history
Delete history entry for creative - V3
DELETE_v3-0-creatives-creativeId-history 1 param → 200404
POST
/v3.0/creatives/{creativeId}/companions
Create companion ad - V3
POST_v3-0-creatives-creativeId-companions 1 param body → 201400401403404
GET
/v3.0/creatives/{creativeId}/companions
Get all companions - V3
GET_v3-0-creatives-creativeId-companions 1 param → 200401403404
GET
/v3.0/creatives/{creativeId}/companions/{companionId}
Get specific companion - V3
GET_v3-0-creatives-creativeId-companions-companionId 2 params → 200401403404
POST
/v3.0/creatives/{creativeId}/companions/{companionId}
Update companion - V3
POST_v3-0-creatives-creativeId-companions-companionId 2 params body → 200400401403404
DELETE
/v3.0/creatives/{creativeId}/companions/{companionId}
Delete companion - V3
DELETE_v3-0-creatives-creativeId-companions-companionId 2 params → 200401403404
Classification (V3) 7

V3.0 creative classification endpoints. Uses Bearer (JWT) authentication.

GET
/v3.0/classification/{cid}
Get a Classification by ID
GET_v3-0-classification-cid 1 param → 200400404500
POST
/v3.0/classification/{cid}
Save a Classification
POST_v3-0-classification-cid 1 param body → 200400401500
POST
/v3.0/classification/{cid}/force-publish
Force-publish a Classification
POST_v3-0-classification-cid-force-publish 1 param → 200500
GET
/v3.0/classification/{cid}/inflate
Get an Inflated Classification by ID
GET_v3-0-classification-cid-inflate 1 param → 200400404500
POST
/v3.0/classification/bulk
Save Bulk Classification
POST_v3-0-classification-bulk body → 200400401500
GET
/v3.0/classification/bulk/{cids}
Get Bulk Classification by IDs
GET_v3-0-classification-bulk-cids 1 param → 200400404500
GET
/v3.0/classification/bulk/{cids}/inflate
Get Bulk Inflated Classification by IDs
GET_v3-0-classification-bulk-cids-inflate 1 param → 200400404500
IAB Data (V3) 2

V3.0 IAB data endpoints. A single pair of endpoints serves all categories (iabverticals, iabattributes, language). Uses Bearer (JWT) authentication.

GET
/v3.0/static_data/{category}
Get IAB Data by Category
GET_v3-0-static_data-category 2 params → 200400404
GET
/v3.0/static_data/{category}/{id}
Get IAB Data Item by Category and ID
GET_v3-0-static_data-category-id 3 params → 200400404

Schemas 49

The contract defines 49 schemas that model the data the API accepts and returns. The most detailed are CreativeDetailsResponse (20 properties), LegacyEncoding (20 properties), PatchCreativeUpdate (19 properties), V3CreateCreativeRequest (19 properties). Each schema is shown below with its type and property counts.

ModifyCompanionRequest
object
5 properties 1 required
CompanionDetails
object
7 properties 5 required
ValidateVASTResponse
object
2 properties
CreativeStatusResponse
object
2 properties
FileInfo
object
7 properties
GetStatusResponse
object
3 properties
GetStatusResponse_Encoding
object
4 properties
GetCreativeVariantsResponse
object
1 property
LegacyEncoding
object
20 properties
CompanionAd
object
7 properties
CompanionsResponse
object
1 property
CreateCompanionResponse
object
1 property
ErrorInfoList
object
1 property
ErrorInfo
object
5 properties
EncodingStatus
string
V3CreateCreativeRequest
object
19 properties 3 required
V3UpdateCreativeRequest
object
18 properties 2 required
PatchCreativeUpdate
object
Partial update request - only provided fields will be updated. Set field to null to clear it.
19 properties
BulkNewCreativeRequest
object
1 property 1 required
BulkUpdateCreativeRequest
object
1 property 1 required
BulkGetRequest
object
1 property 1 required
EventPixelRequest
object
2 properties 2 required
EventPixel
object
2 properties
VASTVersion
string
NewCreativeResponse
object
4 properties
InsecureVendorURLs
object
3 properties
CreativeDetails
object
19 properties
CreativeDetailsResponse
object
20 properties
CreativeDetailsResponseWrapper
object
2 properties
BulkResponseMeta
object
2 properties
Status
object
2 properties
BulkCreativeResponse
object
4 properties
HistoryResponse
object
2 properties
WithPart
object
2 properties
LogEntriesWrapper
object
3 properties
LogEntryResponse
object
5 properties
FieldChangeEntry
object
3 properties
Classification
object
3 properties
ClassificationAttribute
object
4 properties
ClassificationLanguage
object
6 properties
ClassificationVertical
object
5 properties
InflatedClassificationResponse
object
3 properties
InflatedDetails
object
3 properties
ClassificationDetail
object
2 properties
BulkInflatedRecord
object
2 properties
BulkClassificationResponse
object
1 property
BulkInflatedClassificationResponse
object
1 property
UIErrorType
object
1 property
UIError
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

mediamath-video-creatives-api-openapi.yml Raw ↑

Other APIs MediaMath publishes across the network.

MediaMath Marketplaces API V2.0
MediaMath Bring Your Own Algorithm (BYOA) API
MediaMath Audience Onboarding API
MediaMath Server-to-Server Data Distribution API
MediaMath Ad Servers API
MediaMath Advertisers API
MediaMath Agencies API
MediaMath Atomic Creatives API
MediaMath Audience Vendors API
MediaMath Campaign Plans API
MediaMath Campaigns API
MediaMath Campaigns Budget Flights API
Where this information came from

This is an independent, third-party profile of MediaMath Video Creatives API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.