Available values
Value | Description |
| APP_AND_WEB_UNLIMITED | All NewsBreak first-party surfaces (app + web) plus premium-partner inventory, no category restriction. This is the default if platforms is omitted. |
| NEWSBREAK | NewsBreak app + NewsBreak web. |
| SCOOPZ | Scoopz. |
| PREMIUM_PARTNERS_ALL | All premium-partner inventory across categories. |
| PREMIUM_PARTNERS_GAMING | Premium-partner inventory restricted to the gaming category. |
| PREMIUM_PARTNERS_NON_GAMING | Premium-partner inventory excluding the gaming category. |
Rules
APP_AND_WEB_UNLIMITEDis exclusive — it must appear alone. Combining it with any other platform returns a validation error.- At most one
PREMIUM_PARTNERS_*value may appear in the list. You cannot combine, for example,PREMIUM_PARTNERS_GAMINGandPREMIUM_PARTNERS_NON_GAMINGin the same request. - Duplicate entries are rejected.
- Other combinations are allowed, e.g.
["NEWSBREAK", "SCOOPZ"],["NEWSBREAK", "PREMIUM_PARTNERS_GAMING"],["NEWSBREAK", "SCOOPZ", "PREMIUM_PARTNERS_GAMING"]. - If
platformsis omitted from the request, it defaults to["APP_AND_WEB_UNLIMITED"]— same behavior as before this field was introduced.
Validation errors
Invalid platforms values return HTTP 400 with one of the following messages (the exact Details: text comes from the validator):
Input | Error message |
| ["APP_AND_WEB_UNLIMITED", "NEWSBREAK"] | APP_AND_WEB_UNLIMITED must be the only platform |
| ["PREMIUM_PARTNERS_GAMING", "PREMIUM_PARTNERS_NON_GAMING"] | at most one PREMIUM_PARTNERS_* platform allowed |
| ["NEWSBREAK", "NEWSBREAK"] | duplicate platforms |
| ["NEWSBREAK", "x"] (or any unrecognized string) | platforms[<idx>] is invalid. Valid values are: APP_AND_WEB_UNLIMITED, NEWSBREAK, SCOOPZ, PREMIUM_PARTNERS_ALL, PREMIUM_PARTNERS_GAMING, PREMIUM_PARTNERS_NON_GAMING |