Use this topic to explore practical API (application programming interface) requests for using the Media Owner API. Here you’ll find examples for common actions like approving, denying, tagging, and retrieving creatives—plus batch operations and asset access.
In this topic, you'll learn how to:
- Get a list of creatives for approval.
- Approve or deny a creative.
- Add tags or categories to a creative.
- Batch approve or update creatives.
- Create a new tag.
- Search for creative categories by name.
- Retrieve the names of several advertisers.
- Retrieve full-size creative assets.
Use this request to get a paginated list of creatives that still need approval. To help you prioritize your reviews, results are sorted from oldest to newest,. You’ll receive up to 20 creatives per page.
GET https://platform-api.vistarmedia.com/api/ssp/v1/creatives?page_size=20&page=0&order=audit.create_time&asc=true&filter=audit.status:pendingUse this endpoint to update the approval status of a specific creative.
PATCH https://platform-api.vistarmedia.com/api/ssp/v1/creatives/429kp1cDR869Sz6Eoe4JLw:00y5XQZ0QWie0kjCKFCivA{
"audit": {
"status": "APPROVED"
}
}PATCH https://platform-api.vistarmedia.com/api/ssp/v1/creatives/429kp1cDR869Sz6Eoe4JLw:00y5XQZ0QWie0kjCKFCivA{
"audit": {
"status": "DENIED"
}
}You can assign tags or categories to a creative as part of the creative approval process—or update them separately.
PATCH https://platform-api.vistarmedia.com/api/ssp/v1/creatives/429kp1cDR869Sz6Eoe4JLw:00y5XQZ0QWie0kjCKFCivA{
"audit": {
"tag_ids": [
"A5ZWu4p0RkKiJqAYNgKo3w"
],
"category_ids": [
"IAB15-1",
"IAB22"
]
}
}Use this endpoint to update multiple creatives at once. You can approve, deny, or assign tags and categories in a single call—up to 100 creatives per request.
PATCH https://platform-api.vistarmedia.com/api/ssp/v1/creatives/{
"creatives": [
{
"id": "xKgdLkHaSVexQYurJmRIkw:0MdIpRogSWi5tIMtqox0Sw",
"audit": {
"status": "APPROVED"
}
},
{
"id": "429kp1cDR869Sz6Eoe4JLw:apGvurD3RFqSBBWDJFCK9w",
"audit": {
"status": "APPROVED",
"category_ids": [
"IAB15-1",
"IAB22"
],
"tag_ids": [
"A5ZWu4p0RkKijqAYNgKo3w"
]
}
},
{
"id": "xKgdLkHaSVexQYurJmRIkw:apGvurD3RFqSBBWDJFCK9w",
"audit": {
"status": "DENIED",
"message": "This is the denial message."
}
}
]
}Use this endpoint to create a new tag to help organize your creatives. After you create the tag, the response includes its ID, which you can use to label creatives for targeting, reporting, or categorization.
POST https://platform-api.vistarmedia.com/api/ssp/v1/tags{
"name": "my new tag"
}{
"id": "BPC9ZA_jTiSNqnia3ijIfw",
"name": "my new tag"
}Use this search endpoint to find creative categories by name. This is especially helpful when assigning categories during the approval process. The following sample returns all categories with the word “automotive”.
GET https://platform-api.vistarmedia.com/api/ssp/v1/creative_categories?search=name%3AautomotiveIf you’re populating a user interface and need to look up user-friendly field names, use this endpoint. It supports up to 100 filter parameters in a single request so you can batch-resolve IDs to readable names.
GET https://platform-api.vistarmedia.com/api/ssp/v1/advertisers?filter=id:cd0vcnTsza_GRBL2khoKg&filter=id:q6xvzuWSAqnU2Ebt-4AWQ&filter=id:wj7ZtLdsSSvaMGvturAsg&filter=id%3A8UM7Dw0iR16m9gYhevFd&filter=id%3Ab26jsC_9QCC8tr2Z-xfSWv&filter=id%3Acr62fHhS5869jS3Each-vQ&filter=id%3AzhTnI0XQPC36Gp3fHqbZAkWhen you need a URL for the full-size version of a creative (image or video) for review, use this endpoint. It returns all assets and formats associated with the Creative ID you provide.
GET https://platform-api.vistarmedia.com/api/ssp/v1/creatives/429kp1cDR869Sz6Eoe4JLw:0J2pv8uaQV67JynYERiL40/assetsTo learn more about this topic, see: