Marketplaces API V2.0 API (2.0)

Download OpenAPI description
Overview
Languages
Servers
https://api.mediamath.com/deals/v1.0/

Private Marketplace Exchange (PMP-E)

Private Marketplace Direct (PMP-E)

Operations

Bulk Create Publishers

Request

This allows you to add multiple publishers at one under the same organization id.

Publishers

Information about PMP-D from the T1 side can be found here A video explainer on publisher management through the MediaMath app can be found at: https://academy.mediamath.com/mediamath-beta-courses?next=%2Fmediamath-beta-courses%2F800806

Headers
Authorizationstring

Authorization

Default Bearer $TOKEN
Body

{"organization_id":100315, "names" : ["my name is..","my other name is"]}

organization_idinteger
namesArray of strings
curl -i -X POST \
  https://api.mediamath.com/deals/v1.0/bulk_create/publishers \
  -H 'Authorization: Bearer $TOKEN' \
  -H 'Content-Type: application/javascript' \
  -d '[object Object]'

Responses

{
  "data": [
    {
      "updated_on": "2021-07-08T14:08:06+00:00",
      "created_on": "2021-07-08T14:08:06+00:00",
      "id": 514,
      "name": "my name is..",
      "organization_id": 100315,
      "last_touch_user_id": 4254,
      "deleted_on": null
    },
    {
      "updated_on": "2021-07-08T14:08:06+00:00",
      "created_on": "2021-07-08T14:08:06+00:00",
      "id": 515,
      "name": "my other name is",
      "organization_id": 100315,
      "last_touch_user_id": 4254,
      "deleted_on": null
    }
  ],
  "meta": {
    "status": "ok"
  }
}
Body
metaobject
dataArray of objects
Response
No response example

List Deal Strategies

Request

List Deal Strategies

Example: /deals/v1.0/deals/380882/strategy_deals

you can use the 'with' parameter to get information about the strategies and campaigns using the deal. eg: /deals/v1.0/deals/380882/strategy_deals?with=strategy,campaign,advertiser

Path
idnumberrequired

See below

Query
sort_bystring

sort_by

withstring

with

page_offsetnumber

The list starts from the specified page offset

page_limitnumber

Maximum list page element count

Headers
Authorizationstring

Authorization

Default Bearer $TOKEN
curl -i -X GET \
  'https://api.mediamath.com/deals/v1.0/deals/{id}/strategy_deals?page_limit=0&page_offset=0&sort_by=string&with=string' \
  -H 'Authorization: Bearer $TOKEN'

Responses

{ "data": [ { "id": 852908478, "entity_type": "strategy_deal" }, { "id": 852911871, "entity_type": "strategy_deal" }, { "id": 852908409, "entity_type": "strategy_deal" }, { "id": 852908397, "entity_type": "strategy_deal" } ], "meta": { "count": 4, "total_count": 4, "status": "ok", "offset": 0 } }

Body
dataArray of objects
metaobject
Response
No response example

List Deal Group Strategies

Request

List deal group strategies

Example: /deals/v1.0/deal_groups/980/strategy_deal_groups

you can use the 'with param to vide the details of the strategy's campaign or advertiser eg: deals/v1.0/deal_groups/980/strategy_deal_groups?with=strategy,campaign,advertiser

Path
idnumberrequired

See below

Query
sort_bystring

sort_by

withstring

with

page_offsetnumber

The list starts from the specified page offset

page_limitnumber

Maximum list page element count

Headers
Authorizationstring

Authorization

Default Bearer $TOKEN
curl -i -X GET \
  'https://api.mediamath.com/deals/v1.0/deal_groups/{id}/strategy_deal_groups?page_limit=0&page_offset=0&sort_by=string&with=string' \
  -H 'Authorization: Bearer $TOKEN'

Responses

{
  "data": [
    {
      "id": 19744,
      "entity_type": "strategy_deal_group"
    },
    {
      "id": 19496,
      "entity_type": "strategy_deal_group"
    }
  ],
  "meta": {
    "count": 2,
    "total_count": 2,
    "status": "ok",
    "offset": 0
  }
}
Body
dataArray of objects
metaobject
Response
No response example