IAB API Streamlines Deals and Boosts Transparency

IAB API Streamlines Deals and Boosts Transparency

In the complex and often opaque world of programmatic advertising, operational friction has long been a significant barrier to efficiency, costing both time and money while fostering a climate of uncertainty. The IAB Technology Laboratory has introduced a foundational solution designed to address these systemic issues with the release of its Deals API specification version 1.0. This new technical standard, recently opened for public comment, aims to create a universal, machine-readable language for communicating the high-level terms of programmatic deals. By standardizing the communication between supply-side platforms (SSPs) and demand-side platforms (DSPs), the API is poised to supplant the inconsistent, labor-intensive manual processes that currently dominate deal creation and configuration. Its primary objective is to usher in an era of greater automation, accuracy, and clarity, thereby streamlining the setup and management of programmatic transactions and building a more reliable ecosystem for both buyers and sellers. This initiative represents a critical step toward maturing the programmatic landscape, moving it away from bespoke workflows and toward a more scalable and interoperable future.

Addressing Pervasive Industry Challenges

The release of the Deals API is a direct response to the urgent need for standardization across a highly fragmented programmatic landscape. Currently, each platform employs its own proprietary nomenclature and notation for deals, creating what has been aptly described as a “Tower of Babel” within the industry. Media buyers, who often navigate an average of seventeen different systems including multiple SSPs and DSPs, are forced into a process of “telepathic decoding” to align deal parameters between platforms. This lack of a common language is not merely an inconvenience; it is a significant source of operational friction, leading to costly errors, delays, and failed auctions. The Deals API directly confronts this chaos by establishing a single, standardized set of fields and object structures. This ensures that all parties can interpret deal parameters uniformly, eliminating ambiguity and creating a common ground for communication. By providing a universal lexicon for programmatic deals, the specification lays the groundwork for a more cohesive and efficient ecosystem where systems can interact seamlessly.

Beyond establishing a common language, a central theme of the new specification is the pursuit of operational efficiency through robust automation. The API’s core function is to replace error-prone manual data entry with an automated, system-to-system communication protocol. By offering a standardized method for the terms of a deal to be electronically transmitted from its origin system to the receiving system that will execute it, the API dramatically reduces the risk of human error. This automation shortens setup times, minimizes instances of mismatched deals, and frees up valuable human resources to focus on strategy rather than tedious administrative tasks. This shift from manual to automated configuration is a crucial evolutionary step for the programmatic deal ecosystem, enabling more scalable and dependable operations. As programmatic investment continues to grow, with a significant majority of marketers planning to increase their spending, the need for a robust and scalable infrastructure to support this growth has become more pressing than ever.

Unlocking Unprecedented Transparency

Perhaps the most transformative aspect of the Deals API is the profound enhancement of transparency it brings to the programmatic supply chain, particularly concerning the often-murky world of curated deals. For years, buyers have operated with limited visibility into the composition and cost structure of curated inventory packages, treating them as a “black box.” This information asymmetry has made it difficult to assess the true value of these deals and understand the various intermediaries involved. The Deals API introduces specific objects and attributes designed to demystify this process and provide buyers with unprecedented clarity. The newly introduced Curation object, for example, directly addresses this long-standing issue by explicitly identifying the domain of the entity that packaged the deal. Furthermore, it details the fee structure applied for their services, whether it be a CPM, a flat fee, or a percentage of spend. This level of disclosure empowers buyers with critical information about who is involved in a transaction, how they are being compensated, and the precise nature of the inventory and data being provided.

The framework’s dedication to transparency is further exemplified by a suite of well-defined objects and attributes that provide a granular view of a deal’s structure. Three critical domain attributes—origin, seller, and curator—offer unparalleled clarity into the roles of different participants, identifying the system hosting the API, the business entity that sold the deal, and the entity that packaged the inventory, respectively. The ability to clearly distinguish these three parties, which are often separate entities in complex scenarios, marks a significant leap forward. The Curation object builds on this foundation with auxiliary attributes that provide even deeper insight. The auxdata attribute indicates if third-party data layers are applied, pubcount clarifies whether the deal spans a single publisher or aggregates inventory from multiple sources, and dinventory signals if the underlying inventory set may change dynamically. Together, these attributes allow a buyer to distinguish between a simple, single-publisher deal and a complex, multi-publisher package that uses dynamic optimization, enabling more informed and strategic investment decisions.

Technical Framework and Implementation Realities

The Deals API specification v1.0 establishes a technical framework built upon a straightforward, one-way communication model. In this model, an origin system, which is typically an SSP where a deal is first created, implements an HTTP POST endpoint to push structured deal information to a receiving system, usually a DSP. While the initial version is intentionally limited in scope to facilitate easier and faster adoption—focusing on solving the most immediate pain points of deal setup—it lays the essential groundwork for future enhancements like bi-directional communication, revisions, and negotiations. The information itself is structured through a series of well-defined objects. The primary Deal object serves as the main container, holding a unique identifier, a human-readable name, and a status indicator. Complementing this are the Terms object, which codifies commercial parameters like dates, pricing, and geography, and the Inventory object, which provides a high-level description of the media included, such as ad formats, device types, and domains or app bundles.

Despite its powerful capabilities, the specification repeatedly emphasizes that the API operates as a “sidecar” to the core OpenRTB transaction and is not a complete validation system in itself. It provides high-level, static information about a deal but does not guarantee that every bid request associated with that deal ID will perfectly adhere to its terms in real time. Therefore, a key tenet of the framework is that buyers retain the responsibility for diligent validation. The documentation explicitly instructs buyers to cross-reference the data received via the API with the live data present in OpenRTB bid requests to ensure compliance. Moreover, it is considered a crucial best practice for buyers to apply targeting on their DSPs that mirrors the deal’s terms, such as geographic or device restrictions, as a necessary failsafe. Supply chain validation should always rely on the Supply Chain object from OpenRTB, and any deals lacking the necessary information for ads.txt verification should be treated with extreme caution, underscoring that technical standards must work in concert with vigilant operational practices.

A New Foundation for Programmatic Trust

The introduction of the Deals API specification represented a pragmatic and powerful step toward mitigating systemic friction in programmatic deal management. The standard successfully established a common language for deal metadata, which was expected to reduce setup times, decrease costly errors, and enable faster debugging across the ecosystem. Its most significant contribution was the new layer of transparency it brought to the curation process, which empowered buyers with critical information about deal participants and fee structures that had previously been unavailable in the bid stream. By demystifying the supply chain, the API provided the tools needed for more informed decision-making and greater accountability. The framework, however, came with the important understanding that technology alone was not a silver bullet. Its successful adoption depended on a shared industry commitment to not only implementing the technical standard but also adhering to vital best practices for supply chain integrity. It ultimately laid a new foundation where automation and human diligence could work in tandem to build a more trustworthy and efficient programmatic marketplace for all participants.

Subscribe to our weekly news digest.

Join now and become a part of our fast-growing community.

Invalid Email Address
Thanks for Subscribing!
We'll be sending you our best soon!
Something went wrong, please try again later