Platform API Reference
Last updated on August 10, 2020
The table below lists the objects and services included in the OpenX Platform API. Click on the object or service name to consult its reference page.
Objects
The Platform API includes the following objects which support CRUD (create, read, update, and delete) operations:
| Object | Description |
|---|---|
account | A business unit or business relationship as it is represented in OpenX, such as an ad network, advertiser, publisher, or agency. |
ad | The functional unit that displays in the ad space and which represents the message that an advertiser wants an end-user to view. |
adunit | Specific areas on your site where you want to display ads. |
adunitgroup | Collections of ad units used for inventory to be filled with companion ads or to map items in a CMS to inventory items |
comment | Supports the logging of comments for any API object, such as via its Description field in the OpenX UI. |
creative | The media asset to use in your ad (such as an image or video file) that you can upload to the OpenX CDN. The creative references a local or remote file. |
deal | A prearranged agreement to sell specific inventory, such as a direct deal between a publisher and a demand partner. |
floorrule | Allows you to manage selling rules regarding the minimum price you are willing to accept for ad space and related details. |
lineitem | Provides line item details associated with orders, such as pricing, goals, and targeting. |
optimization | Represents real-time selling rules with fields for targeting criteria, minimum prices, advertiser and content filters. |
order | Provides calls to manage direct demand for ad space. Depending on your OpenX configuration, use it to manage demand for third-party networks or exchanges. |
package | Allows you to group inventory that can be reused for different deals or pricing controls without having to be defined again. |
paymenthistory | Provides payment details for a specified account. |
site | Represents a collection of ad unit inventory. |
sitesection | Represents a grouping of ad space in a site. |
user | Represents an individual who logs in to OpenX and performs tasks on behalf of the accounts to which they have access. |
Services
The Platform API includes the following services, which support read GET operations:
| Service | Description |
|---|---|
audittrail | Logs changes to data (creation, modification, or deletion) and allows a system administrator to review historical changes to several objects. |
geo | Provides geolocation values you can use for targeting. |
market | Retrieves information about advertisers, brands, and market operators. |
options | Retrieves data for the specified options key. |
session | Allows communication between OpenX and a user when the user logs in, interacts with, and logs out of the system. |
subtypes | Retrieves the subtypes that can be created for the various object, such as subtypes of the account, lineitem, order, and site objects. |
UI Only Services
These UI only services have no reference documentation.
| Service | Description |
|---|---|
adquality | An ad quality service that handles the review and blocking of creatives. |
i18n | Language tools used for localization. |
oxsearch | A service for searching OpenX data used in the UI. |
reports | Supports OpenX reporting services via the UI. |