Private Marketplace Direct (PMP-E)
URL https://apidocs.mediamath.com
developers@mediamath.com developers@mediamath.com
License Apache 2.0
List the Deals
You can read more about deals and deal groups (including adding them through T1), deal ownership, and deal best practices here. You may also find it useful for exploring input values.
curl -i -X GET \
'https://api.mediamath.com/deals/v1.0/deals?currency_code=string&deal_type=string&export=string&ids=string&owner.advertiser_id=0&owner.agency_id=0&owner.organization_id=0&owner.type=INTERNAL&page_limit=0&page_offset=string&permissions.advertiser_id=0&q=string&sort_by=true&status=true&strategy_id=0' \
-H 'Authorization: string'{
"data": [
{
"created_on": "2019-08-14T17:23:56+00:00",
"deal_identifier": "MDM-17302-00003",
"deal_type": "STANDARD",
"description": "News",
"end_datetime": "2999-12-31T05:00:00+00:00",
"entity_type": "deal",
"id": 384382,
"name": "Rubicon Project_The Washington Post_EBDA_Private Auction_Standard_Desktop & TabletWeb Display_Display_728x90, 160x600, 300x250_FLOOR_First Price_NAR_13_PREMIUM",
"owner": {
"id": 166628,
"type": "ADVERTISER"
},
"permissions": {
"advertiser_ids": [
166628
],
"agency_ids": [],
"all_organizations": false,
"organization_ids": []
},
"price": {
"currency_code": "USD",
"value": "13.0000"
},
"price_method": "CPM",
"price_type": "FLOOR",
"start_datetime": "2019-08-14T17:23:31+00:00",
"status": true,
"sub_supply_source_id": null,
"supply_source_id": 11,
"updated_on": "2019-08-14T17:23:56+00:00"
}
],
"meta": {
"count": 1,
"offset": 0,
"status": "ok",
"total_count": 1
}
}Create Deal
For more insight into deal creation (inside T1), read here. You may find it useful for exploring input values.
_
the identifier used within a bid request to reference the deal
When creating deal type PG, price_type must be set to FIXED and valid start_datetime and end_datetime must be present.
string / timestamp as full RFC 3339 date strings including timezone offsets: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS-##:##. Default is current time.
level of ownership for the deal (i.e. who can edit the deal) and the id of the ownership entity. for example, if the ownership level is set to ADVERTISER, anyone with access to such advertiser can edit this deal.
List of entities that are allowed to target this deal, which should be either the owner entity or sub-entities of the owner entity. if a higher-level entity is included, then do not include any lower-level entity that is part of the included higher level entity. for example, if an organization X is listed in this parameter, then automatically all agencies and advertisers that are part of the organization X will be included and listing any such agencies and advertisers part of organization X will cause a validation error.
price floor or fixed value to use in auction along with the associated currency code
The deal is a "FLOOR" price deal (bids must be above this floor, and will likely clear above this floor) or "FIXED" price deal (bids must be at this price or above, and will clear at the fixed price)
string / timestamp as full RFC 3339 date strings including timezone offsets: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS-##:##. Default is current time.
the id of the publisher if the supply_source_id is set to 83 (BidSwitch)
curl -i -X POST \
https://api.mediamath.com/deals/v1.0/deals \
-H 'Content-Type: application/javascript' \
-H 'Cookie: adama_session=<<sessionid>>' \
-d '[object Object]'List the Deals
This call returns all information you get with a deal and also the reporting data for a specified time interval (time_window : "yesterday", "last_7_days", "last_30_days", "month_to_date", or a custom range using "start_date" and "end_date"). You should only send time_window or start_date/end_date but not a combination of the both. The filters field allows you to filter the results based on what you need, e.g: "filters": [{"field":"id", "op":"in", "value": [123]}] will look for deals that have 123 in their ID. {"field" :"match_rate", "op":">", "value" :0} will return deals that have a "match_rate" greater than 0. You can also use the "sorting" field to sort the results, eg: "sorting":[{"field":"viewability_rate", "dir":"asc"}] will give the results sorted by the viewability_rate field.
"reporting": {
"organization_id": 100048,
"time_window": "last_7_days",
"start_date": null,
"end_date": null
},
"filters": [
{"field": "id",
"op": "in",
"value" : [447824]},
{"field": "match_rate",
"op": ">",
"value" : 0}
],
"sorting": [
{
"field": "viewability_rate",
"dir": "asc"
}
],
"paging": {
"page_offset": 0
}
}_
the identifier used within a bid request to reference the deal
When creating deal type PG, price_type must be set to FIXED and valid start_datetime and end_datetime must be present.
string / timestamp as full RFC 3339 date strings including timezone offsets: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS-##:##. Default is current time.
level of ownership for the deal (i.e. who can edit the deal) and the id of the ownership entity. for example, if the ownership level is set to ADVERTISER, anyone with access to such advertiser can edit this deal.
List of entities that are allowed to target this deal, which should be either the owner entity or sub-entities of the owner entity. if a higher-level entity is included, then do not include any lower-level entity that is part of the included higher level entity. for example, if an organization X is listed in this parameter, then automatically all agencies and advertisers that are part of the organization X will be included and listing any such agencies and advertisers part of organization X will cause a validation error.
price floor or fixed value to use in auction along with the associated currency code
The deal is a "FLOOR" price deal (bids must be above this floor, and will likely clear above this floor) or "FIXED" price deal (bids must be at this price or above, and will clear at the fixed price)
string / timestamp as full RFC 3339 date strings including timezone offsets: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS-##:##. Default is current time.
the id of the publisher if the supply_source_id is set to 83 (BidSwitch)
curl -i -X POST \
https://api.mediamath.com/deals/v1.0/deal_analytics \
-H 'Content-Type: application/javascript' \
-H 'Cookie: adama_session=<<sessionid>>' \
-d '[object Object]'Get Deal
You can read more about deals and deal groups (including adding them through MediaMath Platform), deal ownership, and deal best practices here. You may also find it useful for exploring input values.