Creative API (1.5)
Download OpenAPI specification:
SSP Creative API for creative submission and status queries
Minor, non-breaking API changes will occur on the same path. For example v1.0 and future 1.x versions will all be accessible on https://creative.api.adscale.de/v1/
| Creative API Version | Date | Description |
|---|---|---|
| v1.5 | 24-04-2026 | Support for targetPublishers field on creative submission and query parameter on approval status request |
| v1.4 | 29-10-2024 | Support for publicVideoImageURL property to enable iURL submission for Public Video creatives |
| v1.3 | 17-06-2021 | Support for querying ssl approval status of all active creatives |
| v1.2 | 12-08-2020 | Support for querying statistics for all active creatives |
| v1.1 | 06-08-2020 | Support for querying a list of active creatives and their approval statuses |
| v1.0 | 15-04-2020 | Support for submission of a creative for pre-approval and querying the approval status of individual creatives |
Each API key will have requests rate limited to 100 requests per second. This may be subject to change depending on usage patterns.
Creatives can be submitted to Stroeer SSP for pre-approval prior to DSP bidding.
For creatives which require manual approval, such as public video, the creative will be available within 24 hours.
For all other creatives, approval status will be available within 40 minutes.
Note: Agency/Advertiser may be substituted for Seat/Adomain for DSPs configured appropriately.
In both cases we expect exactly the same strings that you will be sending in the bid response (Check out our OpenRTB specification for that).
If you are unsure how your DSP is integrated please reach out to your technical contact.
Submit a creative
Authorizations:
Request Body schema: application/json
| dspId required | integer The Stroeer SSP ID for a DSP. This will be provided along with the API keys. The DSP id must match the API key. |
| creativeId required | string DSP creative ID. Creative ID's must be unique per DSP |
| landingPageDomain required | string Second-level landing page domain: e.g. stroeer.de |
| width required | integer Width of the creative in pixels e.g. 480 |
| height required | integer Width of the creative in pixels e.g. 160 |
| advertiser required | string DSP string representation of an advertiser or brand of the creative. May be substituted for adomain with applicable configuration |
| agency required | string DSP string representation of an agency. May be substituted for seat with applicable configuration |
| htmlSnippet | string Required for banner style creatives. If provided, then videoURL, videoVastXML, publicVideoURL, publicVideoImageURL, publicVideoVastXML must not be provided |
| videoURL | string Used for providing a URL link to VAST. If provided, then htmlSnippet, videoVastXML, publicVideoURL, publicVideoImageURL, publicVideoVastXML must not be provided |
| videoVastXML | string VAST XML of a video creative. If provided, then htmlSnippet, videoURL, publicVideoURL, publicVideoImageURL, publicVideoVastXML must not be provided |
| publicVideoURL | string Used for providing a URL link to VAST for Public Video creatives (out of home advertising). If provided, then htmlSnippet, videoURL, videoVastXML, publicVideoImageURL, publicVideoVastXML must not be provided |
| publicVideoImageURL | string Used for providing a URL link to an image (iURL) for Public Video creatives (out of home advertising) in case providing VAST is not a feasible option. If provided, then htmlSnippet, videoURL, videoVastXML, publicVideoURL, publicVideoVastXML must not be provided |
| publicVideoVastXML | string Used for providing VAST for Public Video creatives (out of home advertising). If provided, then htmlSnippet, videoURL, videoVastXML, publicVideoURL, publicVideoImageURL must not be provided |
| targetPublishers | Array of strings (TargetPublisher) Items Enum: "BIGMEDIA" "STROEER_CORE" "NEOBV" Optional list of publishers this creative is intended to bid on. If not provided, this will default to STROEER_CORE |