Private Marketplace Exchange (PMP-E)
/
Read publisher

Marketplaces API V2.0 API (2.0)

Download OpenAPI description
marketplaces.json
marketplaces.yaml
Overview
URL https://apidocs.mediamath.com
developers@mediamath.com developers@mediamath.com
License Apache 2.0
Languages
Servers
https://api.mediamath.com/deals/v1.0/

Private Marketplace Exchange (PMP-E)

Private Marketplace Direct (PMP-E)

Operations

List publishers

Request

Publishers are associated to an organization. A collection of publishers for an organization can be retrieved using an HTTP GET request containing an organization_id

Example: https://api.mediamath.com/deals/v1.0/publishers?organization_id=100315

The only sort_by parameter allowed is "name", and organization_id is the only required parameter

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

Query
sort_bystring

sort_by

Value"name"
qstring

q

page_offsetinteger

page_offset

page_limitinteger

Maximum list page element count

organization_idintegerrequired

organization_id

Headers
Authorizationstring

Authorization

Default Bearer $TOKEN
curl -i -X GET \
  'https://api.mediamath.com/deals/v1.0/publishers?organization_id=0&page_limit=0&page_offset=0&q=string&sort_by=name' \
  -H 'Authorization: Bearer $TOKEN'

Responses

{
"meta": {
"count": 1,
"status": "ok",
"offset": 0,
"total_count": 1
},
"data": [
{
"name": "testing",
"last_touch_user_id": 4254,
"id": 3,
"updated_on": "2020-10-01T14:21:48+00:00",
"created_on": "2020-10-01T14:21:48+00:00",
"deleted_on": null,
"organization_id": 100315
}
]
}
Body
metaobject
dataArray of objects
Response
No response example

Read publisher

Request

Example: https://api.mediamath.com/deals/v1.0/publishers/3

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

Path
idstringrequired

See below

Headers
Authorizationstring

Authorization

Default Bearer $TOKEN
curl -i -X GET \
  'https://api.mediamath.com/deals/v1.0/publishers/{id}' \
  -H 'Authorization: Bearer $TOKEN'

Responses

{
  "data": {
    "created_on": "2020-10-01T14:21:48+00:00",
    "last_touch_user_id": 4254,
    "id": 3,
    "organization_id": 100315,
    "updated_on": "2020-10-01T14:21:48+00:00",
    "name": "testing",
    "deleted_on": null
  },
  "meta": {
    "status": "ok"
  }
}
Body
dataobject
metaobject
Response
No response example

Update Publisher

Request

Example: POST https://api.mediamath.com/deals/v1.0/publishers/5

where you might want to edit to the following:

{
    "name" : "edited demo publisher 2", 
}

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

Path
idstringrequired

See below

Headers
Authorizationstring

Authorization

Default Bearer $TOKEN
curl -i -X POST \
  'https://api.mediamath.com/deals/v1.0/publishers/{id}' \
  -H 'Authorization: Bearer $TOKEN'

Responses

{ "data": { "created_on": "2020-09-28T20:52:03+00:00", "deleted_on": null, "id": 5, "last_touch_user_id": 1234, "name": "edited demo publisher 2", "organization_id": 100048, "updated_on": "2020-09-28T20:52:03+00:00" }, "meta": { "status": "ok" } }

Body
dataobject
metaobject
Response
No response example