Private Marketplaces (PMP D&E)
- Version: 1.0
- Host: api.mediamath.com
- Responds With:
Private Marketplace Exchange (PMP-E) is used to create private auctions within the RTB environment. In contrast to Open Auctions where every strategy is eligible to place a bid, in private marketplaces, only strategies with a specific
deal_id attribute are allowed to bid.
These private marketplace deals are used by publishers and advertisers to create preferential-access inventory.
To set deal targeting on strategies, see the strategy endpoint documentation.
Differences from T1 Execution and Management API
Complex Requests Not Supported
The media deals API does not support the
?full query parameter, as the collection requests always return the full entity properties. The media deals API does not support the
?with query parameter used to include related entities in single-entity or collection responses. Please refer to entity specific API documentation. The media deals API does not support the /limit/ URL component used to filter deals based on an ID of a related entity. Instead, it supports filtering by an ID of a related entity via the
?owner.[entity_type]_id=[entity ID]. Please refer to the Complex Requests Supported section below.
Complex Requests Supported
The media deals API supports other advanced requests that T1 API supports, such as
?q parameters. The
?sort_by parameter can be used for the following properties of deals:
?q parameter can be used for the following properties of deals:
For more information on using these supported parameters, please refer to the Execution and Management_API section of the T1 documentation.
The media deals API supports the use of
?owner.[entity_type]_id=[entity ID] to return a collection of deals that are editable by users of such entity.
Similarly, the media deals API supports the use of
?permissions.[entity_type]_id=[entity ID] to return a collection of deals that are targetable by users of such entity.
Additionally, the media deals API supports the use of
?strategy_id=[strategy ID] to return a collection of deals that are currently targeted by that strategy.
Finally, the media deals API supports
?currency_code parameters. The
?owner.type parameter can be used to limit a collection of deals returned to the specified owner.type (
?status parameter can be used to limit a collection of deals returned to the specified status (
?currency_code parameter can be used to convert the price attribute to be expressed in a specified currency, regarldess of the actual currency codes the deals are saved in.
While T1 API supports URL-encoded parameters in the POST body, the media deals API only supports the JSON format in the POST body. Use
Content-Type: application/json header for the POST request.
(If-None-Match: [Etag]) for conditional GET requests on single deal records.
304 Not Modified will be returned if the Etag matches.