Private Marketplace Exchange (PMP-E)
/
List publishers

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

Create publisher

Request

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

Body

_

organization_idintegerrequired

ID of the organization to associate the publisher with

namestring<= 64 charactersrequired

Name of the publisher (64 character maximum)

curl -i -X POST \
  https://api.mediamath.com/deals/v1.0/publishers \
  -H 'Content-Type: application/javascript' \
  -d '[object Object]'

Responses

Body
metaobject
dataobject
Response
No response example

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