Private Marketplace Direct (PMP-E)
URL https://apidocs.mediamath.com
developers@mediamath.com developers@mediamath.com
License Apache 2.0
curl -i -X GET \
https://api.mediamath.com/deals/v1.0/channels \
-H 'Authorization: Bearer $TOKEN'[
{
"created_on": "Mon, 20 Jul 2020 11:13:55 GMT",
"id": 1,
"name": "Display",
"pos": 1,
"updated_on": "Mon, 20 Jul 2020 11:13:55 GMT"
},
{
"created_on": "Mon, 20 Jul 2020 11:13:55 GMT",
"id": 2,
"name": "Mobile Web",
"pos": 2,
"updated_on": "Mon, 20 Jul 2020 11:13:55 GMT"
},
{
"created_on": "Mon, 20 Jul 2020 11:13:55 GMT",
"id": 3,
"name": "Mobile In-app",
"pos": 3,
"updated_on": "Mon, 20 Jul 2020 11:13:55 GMT"
},
{
"created_on": "Mon, 20 Jul 2020 11:13:55 GMT",
"id": 4,
"name": "Video",
"pos": 4,
"updated_on": "Mon, 20 Jul 2020 11:13:55 GMT"
},
{
"created_on": "Mon, 20 Jul 2020 11:13:55 GMT",
"id": 5,
"name": "Audio",
"pos": 5,
"updated_on": "Mon, 20 Jul 2020 11:13:55 GMT"
},
{
"created_on": "Mon, 20 Jul 2020 11:13:55 GMT",
"id": 6,
"name": "CTV",
"pos": 6,
"updated_on": "Mon, 20 Jul 2020 11:13:55 GMT"
},
{
"created_on": "Mon, 20 Jul 2020 11:13:55 GMT",
"id": 7,
"name": "DOOH",
"pos": 7,
"updated_on": "Mon, 20 Jul 2020 11:13:55 GMT"
}
]No response examplecurl -i -X PUT \
'https://api.mediamath.com/deals/v1.0/bulk_update/deals?%3C%3Cany%20other%20attributes%3E%3E=string&description=string&name=string' \
-H 'Authorization: Bearer $TOKEN' \
-H 'Content-Type: application/javascript' \
-d '[object Object]'{
"data": {
"updated_deals": [
{
"updated_on": "2021-07-08T14:02:24+00:00",
"created_on": "2021-07-08T13:57:26+00:00",
"id": 429599,
"name": "some new name",
"description": "something",
"supply_source_id": 246,
"sub_supply_source_id": null,
"deal_identifier": "hello",
"start_datetime": "2020-12-31T05:00:00+00:00",
"end_datetime": "2999-12-31T05:00:00+00:00",
"price_type": "FLOOR",
"price_method": "CPM",
"status": false,
"bill_type": "EXCHANGE",
"deal_type": "STANDARD",
"impressions": 22,
"channels": [
{
"id": 1,
"name": "Display",
"pos": 1,
"created_on": "2020-07-20T11:13:55.015407+00:00",
"updated_on": "2020-07-20T11:13:55.015407+00:00"
},
{
"id": 2,
"name": "Mobile Web",
"pos": 2,
"created_on": "2020-07-20T11:13:55.015407+00:00",
"updated_on": "2020-07-20T11:13:55.015407+00:00"
}
],
"publisher_id": null,
"organization_id": 100315,
"permissions": {
"all_organizations": false,
"organization_ids": [
100315
],
"agency_ids": [],
"advertiser_ids": []
},
"owner": {
"type": "ORGANIZATION",
"id": 100315
},
"price": {
"value": "1.3000",
"currency_code": "EUR"
},
"entity_type": "deal",
"deal_groups": [],
"strategies_count": 0
}
],
"invalid_deals": []
},
"meta": {
"status": "ok"
}
}No response exampleBulk Create Deal endpoint is /deals/v1.0/bulk_create/deals
For more insight into deal creation (inside T1), read here. You may find it useful for exploring input values.
{
"data": [
{
"updated_on": "2021-06-09T14:29:27+00:00",
"created_on": "2021-04-12T13:22:35+00:00",
"id": 422839,
"name": "UIA_Inventory_Test",
"description": null,
"supply_source_id": 159,
"sub_supply_source_id": null,
"deal_identifier": "2718951",
"start_datetime": "2021-04-12T13:22:15+00:00",
"end_datetime": "2999-12-31T05:00:00+00:00",
"price_type": "FIXED",
"price_method": "CPM",
"status": true,
"bill_type": "EXCHANGE",
"deal_type": "STANDARD",
"impressions": null,
"channels": [],
"publisher_id": null,
"organization_id": 100048,
"permissions": {
"all_organizations": false,
"organization_ids": [
100048
],
"agency_ids": [],
"advertiser_ids": []
},
"owner": {
"type": "ORGANIZATION",
"id": 100048
},
"price": {
"value": "0.0073",
"currency_code": "USD"
},
"entity_type": "deal",
"deal_groups": [],
"strategies_count": 0
},
{
"updated_on": "2018-03-01T21:43:46+00:00",
"created_on": "2017-04-10T06:31:51+00:00",
"id": 177130,
"name": "pmp test",
"description": "",
"supply_source_id": 218,
"sub_supply_source_id": null,
"deal_identifier": "MM2-8G3-K3D4",
"start_datetime": "2017-04-10T07:31:28+00:00",
"end_datetime": "2999-12-31T00:00:00+00:00",
"price_type": "FLOOR",
"price_method": "CPM",
"status": true,
"bill_type": "EXCHANGE",
"deal_type": "STANDARD",
"impressions": null,
"channels": null,
"publisher_id": null,
"organization_id": 100048,
"permissions": {
"all_organizations": false,
"organization_ids": [],
"agency_ids": [],
"advertiser_ids": [
176789
]
},
"owner": {
"type": "ADVERTISER",
"id": 176789
},
"price": {
"value": "8.0000",
"currency_code": "USD"
},
"entity_type": "deal",
"deal_groups": [],
"strategies_count": 0
}
]
}curl -i -X POST \
https://api.mediamath.com/deals/v1.0/bulk_create/deals \
-H 'Authorization: Bearer $TOKEN' \
-H 'Content-Type: application/javascript' \
-d '[object Object]'{
"data": {
"created_deals": [
{
"updated_on": "2021-07-08T13:57:26+00:00",
"created_on": "2021-07-08T13:57:26+00:00",
"id": 429599,
"name": "hello",
"description": "hello",
"supply_source_id": 246,
"sub_supply_source_id": null,
"deal_identifier": "hello",
"start_datetime": "2020-12-31T05:00:00+00:00",
"end_datetime": "2999-12-31T05:00:00+00:00",
"price_type": "FLOOR",
"price_method": "CPM",
"status": false,
"bill_type": "EXCHANGE",
"deal_type": "STANDARD",
"impressions": 22,
"channels": [
{
"id": 1,
"name": "Display",
"pos": 1,
"created_on": "2020-07-20T11:13:55.015407+00:00",
"updated_on": "2020-07-20T11:13:55.015407+00:00"
},
{
"id": 2,
"name": "Mobile Web",
"pos": 2,
"created_on": "2020-07-20T11:13:55.015407+00:00",
"updated_on": "2020-07-20T11:13:55.015407+00:00"
}
],
"publisher_id": null,
"organization_id": 100315,
"permissions": {
"all_organizations": false,
"organization_ids": [
100315
],
"agency_ids": [],
"advertiser_ids": []
},
"owner": {
"type": "ORGANIZATION",
"id": 100315
},
"price": {
"value": "1.3000",
"currency_code": "EUR"
},
"entity_type": "deal",
"deal_groups": [],
"strategies_count": 0
}
],
"invalid_deals": []
},
"meta": {
"status": "ok"
}
}No response example