Skip to content
Marketplace SSP API
/
/Seats

Vistar Media Marketplace SSP API

The Vistar Media Marketplace SSP API enables developers to programmatically interact with Vistar's SSP outside of the web application. It enables Media Owners to build system integrations and automations.

For authentication, rate limiting, and other general usage information, please see our getting started documentation.

Download OpenAPI description
ssp.json
ssp.yaml
Languages
Servers
Staging
https://staging-platform-api.vistarmedia.com/
Production
https://platform-api.vistarmedia.com/

Creatives

The Creative resource represents a specific creative provided by a buyer that targets one of your Networks.

Your approval status of the Creative is in the audit object within the Creative.

The API allows you to list and retrieve Creatives and update their audit values.

Creatives can be categorized using IAB categories and your own custom Tags. The Creative Category and Tag endpoints allow you to discover ids to use when updating Creatives. You can also create new Tags.

You can also access a Creative's assets and associated Campaign information.

Operations

Advertisers

An Advertiser is a company that runs a campaign.

You can use the Advertiser APIs to resolve the advertiser_id on a Creative to a human-readable name.

Operations

Bidders

A Bidder is a DSP where a campaign originated.

You can use the Bidder APIs to resolve the bidder_id on a Creative to a human-readable name.

Operations

Networks

A Network is a Media Owner's venue collection. You can use the Network APIs to list your Networks.

Operations

Seats

A Seat is buyer of a Campaign.

You can use the Seat APIs to resolve the seat_id on a Creative to a human-readable name.

Operations

List Seats

Request

List all Seats

Security
cookieAuthStaging or cookieAuthProd
Query
page_sizeinteger(int64)
pageinteger(int64)
orderstring

Supported order fields: name

ascboolean
filterArray of strings

Supported filter fields: id

searchArray of strings

Supported search fields: name

curl -i -X GET \
  'https://staging-platform-api.vistarmedia.com/seats?page_size=0&page=0&order=string&asc=true&filter=string&search=string' \
  -b tr-staging=YOUR_API_KEY_HERE

Responses

A successful response.

Bodyapplication/json
seatsArray of objects(api.ssp.v1.Seat)
total_sizeinteger(int64)
Example: 1
Response
application/json
{
  "seats": [
    { … }
  ],
  "total_size": 1
}

Get Seat by ID

Request

Get a Seat by ID

Security
cookieAuthStaging or cookieAuthProd
Path
idstringrequired
curl -i -X GET \
  'https://staging-platform-api.vistarmedia.com/seats/{id}' \
  -b tr-staging=YOUR_API_KEY_HERE

Responses

A successful response.

Bodyapplication/json
idstring
Example: "juIGaOygS0CBBqtmXHamqA"
namestring
Example: "Test User"
Response
application/json
{
  "id": "juIGaOygS0CBBqtmXHamqA",
  "name": "Test User"
}
© 2025 Vistar Media. All Rights Reserved.