/
v3.0.11Get access

getPromotions

Retrieve a paginated list of promotions, optionally filtered by category, platform, and other parameters

Request parameters:

NameDescriptionTypeValuesDefault
country
Country code used for global filteringstring--
useWebp
Whether to return WebP versions of imagesbooleantrue / false-
category
Filter promotions by category slugstring--
platform
Platform namestring"desktop" / "mobile"-

Call example:

getPromotions({
  country: 'AM',
  useWebp: false,
  category: 'sports',
  platform: 'desktop'
})

Response parameters:

NameDescriptionTypeValues
id
Auto-increment unique identifier of the promotionnumber-
show_to
Visibility scope: 0 = all, 1 = authorized users only, 2 = guests onlynumber-
target
Link target attribute: "_blank", "_self", "_parent", or "_top"string-
opt_in
Opt-in identifier or value, or null if not applicablestring | null-
title
Display title of the promotionstring-
content
Full content body of the promotion. Excluded if "content" is passed in the exclude parameterstring-
src_type
Type of the media source (e.g. "image")string-
src
Path to the promotion image assetstring-
href
URL the promotion links to when clickedstring-