Get a Marketplace

Organizations

Operations

Agencies

Operations

Advertisers

Operations

Campaigns

Operations

Campaigns Budget Flights

Operations

Campaign Plans

Operations

Strategies

Operations

Strategy Parameters

Operations

Strategy Templates

Operations

New Strategy Plans

Operations

Targeting

Operations

Targeting Attachments

TargetingAttachments

Operations

Targeting Segments

Operations

Targeting Segment Objectives

Operations

Vendor Contracts

Operations

Contracts

Operations

Audience Vendors

Operations

Vendors

Operations

Atomic Creatives

Operations

Concepts

Operations

Creatives

Operations

Pixel Bundles

Operations

Pixel Providers

Operations

Marketplaces

Operations

Get a Marketplace

Request

Get a marketplace by ID

Security

Auth0

Path

marketplace_idintegerrequired

Numeric ID of the marketplace to get

curl -i -X GET \
  'https://api.mediamath.com/api/v3.0/marketplaces/{marketplace_id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Marketplace response

Bodyapplication/json

dataobject(marketplace_full)

metaobject(single_metadata)

Response

application/json

{
  "data": {
    "id": 0,
    "version": 0,
    "created_on": "2019-08-24T14:15:22Z",
    "updated_on": "2019-08-24T14:15:22Z",
    "name": "string",
    "supply_type": "string",
    "status": true,
    "rtb_enabled": true,
    "strategy_id": 0,
    "code": "string",
    "bidder_exchange_identifier": 0,
    "rtb_type": "string",
    "has_display": true,
    "has_mobile_display": true,
    "has_video": true,
    "has_mobile_video": true,
    "requires_creative_audit": true,
    "has_desktop_video": true,
    "has_connected_tv": true,
    "mma_free": true,
    "private": true,
    "mkt_sell_price": -1,
    "mkt_sell_price_currency_code": "USD",
    "permission_organizations": [ … ],
    "permission_agencies": [ … ]
  },
  "meta": {
    "status": "success"
  }
}

Update a Marketplace

Request

Update a marketplace by ID

Security

Auth0

Path

marketplace_idintegerrequired

Numeric ID of the marketplace to update

Bodyapplication/json

idinteger

versioninteger

namestringnon-empty

supply_typestringnon-empty

statusboolean

rtb_enabledboolean

strategy_idinteger

codestringnon-empty

bidder_exchange_identifierinteger

rtb_typestringnon-empty

has_displayboolean

has_mobile_displayboolean

has_videoboolean

has_mobile_videoboolean

requires_creative_auditboolean

has_desktop_videoboolean

has_connected_tvboolean

mma_freeboolean

privateboolean

mkt_sell_pricenumber or null(float)>= -1

mkt_sell_price_currency_codestring or null= 3 characters

Example: "USD"

permission_organizationsArray of integers(int32)

permission_agenciesArray of integers(int32)

curl -i -X POST \
  'https://api.mediamath.com/api/v3.0/marketplaces/{marketplace_id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 0,
    "version": 0,
    "name": "string",
    "supply_type": "string",
    "status": true,
    "rtb_enabled": true,
    "strategy_id": 0,
    "code": "string",
    "bidder_exchange_identifier": 0,
    "rtb_type": "string",
    "has_display": true,
    "has_mobile_display": true,
    "has_video": true,
    "has_mobile_video": true,
    "requires_creative_audit": true,
    "has_desktop_video": true,
    "has_connected_tv": true,
    "mma_free": true,
    "private": true,
    "mkt_sell_price": -1,
    "mkt_sell_price_currency_code": "USD",
    "permission_organizations": [
      0
    ],
    "permission_agencies": [
      0
    ]
  }'

Responses

Marketplace response

Bodyapplication/json

dataobject(marketplace_full)

metaobject(single_metadata)

Response

application/json

{
  "data": {
    "id": 0,
    "version": 0,
    "created_on": "2019-08-24T14:15:22Z",
    "updated_on": "2019-08-24T14:15:22Z",
    "name": "string",
    "supply_type": "string",
    "status": true,
    "rtb_enabled": true,
    "strategy_id": 0,
    "code": "string",
    "bidder_exchange_identifier": 0,
    "rtb_type": "string",
    "has_display": true,
    "has_mobile_display": true,
    "has_video": true,
    "has_mobile_video": true,
    "requires_creative_audit": true,
    "has_desktop_video": true,
    "has_connected_tv": true,
    "mma_free": true,
    "private": true,
    "mkt_sell_price": -1,
    "mkt_sell_price_currency_code": "USD",
    "permission_organizations": [ … ],
    "permission_agencies": [ … ]
  },
  "meta": {
    "status": "success"
  }
}

List Marketplaces

Request

Get a list of marketplaces

Security

Auth0

curl -i -X GET \
  https://api.mediamath.com/api/v3.0/marketplaces \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

List marketplaces response

Bodyapplication/json

dataArray of objects(marketplace_full)

metaobject(pagination metadata)

Response

application/json

{
  "data": [
    { … }
  ],
  "meta": {
    "status": "success",
    "count": 10,
    "total_count": 100,
    "offset": 0,
    "next_page": "string",
    "prev_page": "string"
  }
}

Create a Marketplace

Request

Create a marketplace

Security

Auth0

Bodyapplication/json

idinteger

versioninteger

namestringnon-emptyrequired

supply_typestringnon-empty

statusboolean

rtb_enabledboolean

strategy_idintegerrequired

codestringnon-empty

bidder_exchange_identifierinteger

rtb_typestringnon-empty

has_displayboolean

has_mobile_displayboolean

has_videoboolean

has_mobile_videoboolean

requires_creative_auditboolean

has_desktop_videoboolean

has_connected_tvboolean

mma_freeboolean

privateboolean

mkt_sell_pricenumber or null(float)>= -1

mkt_sell_price_currency_codestring or null= 3 characters

Example: "USD"

permission_organizationsArray of integers(int32)

permission_agenciesArray of integers(int32)

curl -i -X POST \
  https://api.mediamath.com/api/v3.0/marketplaces \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 0,
    "version": 0,
    "name": "string",
    "supply_type": "string",
    "status": true,
    "rtb_enabled": true,
    "strategy_id": 0,
    "code": "string",
    "bidder_exchange_identifier": 0,
    "rtb_type": "string",
    "has_display": true,
    "has_mobile_display": true,
    "has_video": true,
    "has_mobile_video": true,
    "requires_creative_audit": true,
    "has_desktop_video": true,
    "has_connected_tv": true,
    "mma_free": true,
    "private": true,
    "mkt_sell_price": -1,
    "mkt_sell_price_currency_code": "USD",
    "permission_organizations": [
      0
    ],
    "permission_agencies": [
      0
    ]
  }'

Responses

Marketplace response

Bodyapplication/json

dataobject(marketplace_full)

metaobject(single_metadata)

Response

application/json

{
  "data": {
    "id": 0,
    "version": 0,
    "created_on": "2019-08-24T14:15:22Z",
    "updated_on": "2019-08-24T14:15:22Z",
    "name": "string",
    "supply_type": "string",
    "status": true,
    "rtb_enabled": true,
    "strategy_id": 0,
    "code": "string",
    "bidder_exchange_identifier": 0,
    "rtb_type": "string",
    "has_display": true,
    "has_mobile_display": true,
    "has_video": true,
    "has_mobile_video": true,
    "requires_creative_audit": true,
    "has_desktop_video": true,
    "has_connected_tv": true,
    "mma_free": true,
    "private": true,
    "mkt_sell_price": -1,
    "mkt_sell_price_currency_code": "USD",
    "permission_organizations": [ … ],
    "permission_agencies": [ … ]
  },
  "meta": {
    "status": "success"
  }
}

Users

Operations

User Permissions

Operations

Enterprise Controls

Operations

General

Operations

Currency Rates

Operations

Site Lists

Operations

Timezones

Operations

Verticals

Operations

Supply Sources

Operations

Ad Servers

Operations

Segment Groups

Operations

Campaigns API (xx.xx.xx)

Organizations

Agencies

Advertisers

Campaigns

Campaigns Budget Flights

Campaign Plans

Strategies

Strategy Parameters

Strategy Templates

New Strategy Plans

Targeting

Targeting Attachments

Targeting Segments

Targeting Segment Objectives

Vendor Contracts

Contracts

Audience Vendors

Vendors

Atomic Creatives

Concepts

Creatives

Pixel Bundles

Pixel Providers

Marketplaces

Get a Marketplace

Request

Responses

Was this helpful?

Update a Marketplace

Request

Responses

Was this helpful?

List Marketplaces

Request

Responses

Was this helpful?

Create a Marketplace

Request

Responses

Was this helpful?

Users

User Permissions

Enterprise Controls

General

Currency Rates

Site Lists

Timezones

Verticals

Supply Sources

Ad Servers

Segment Groups