Submit a request
PRODUCT
Privacy Policy  |  Terms of Use
Follow
Last Update:
  viewable by end users
  editable by agents

Overview

You can use the brand resource to retrieve a set of brands, retrieve a specific brand, and create a brand.

Resource URL

https://adapi.sizmek.com/sas/brands

Objects Used by This Resource

HTTP Method and URI List

HTTP Method

URI

Description

GET

/brands

Retrieves multiple brands.

GET

/brands/{Id}

Retrieves a specific brand.

POST

/brands

Create a brand.

Method Examples and Request Parameters

Important

Important:

  • For PUT calls, do the following:

    • We recommend that for any PUT method that updates an object, you include the entire "result": object from the GET response in the request body. If there is missing information, even if it is read-only, the request might fail.

    • You must also change the "result": to "entities": and make the entities contents into an array. For example, here is the output from the GET request:

       { "result": { "type": "Advertiser", ... } }

      You should make the following modifications, including your specific modifications, to the json object that you submit for the request.

       { "entities": [{ "type": "Advertiser", ... }] }   

  • For POST calls, do the following:

    • Include the fields marked as Required, as indicated in the corresponding Object article.

    • Format the JSON object as follows:

       { "entities": [{ "type": "Advertiser", ... }] }   

Get Multiple Brands

Retrieves multiple Brands.

Request Query Parameters

Name

Description

Type

Required

Notes

advertiserId

Retrieves all brands under the specific advertiser.

Long

Optional

from

Starting index by which to fetch new brands for paging purposes.

Long

Required

Getting multiple entities requires using from and max query parameters.

max

Maximum number of brands to fetch for each page.

Long

Required

accountId

ID of account.

Long

Optional

sort

Sort by field name (see here).

String

Optional

order

Sort order ASC or DESC, required if sort field name is specified (see here).

String

Optional

Note

Note: Required if a sort field name is specified.

By default, the API response is ascending.

q

Filtering options for the request (see here).

String

Optional

Example of query string: q={"1":{"RECENT":["1519203216427-1526889216427"]},"2":{"NAME":["smith"]}}

Note

Note: The date is according to the Unix epoch timestamp.

View values

Name

Description

Type

ID

ID of brand.

Integer

NAME

Name of brand.

String

VERTICAL

Brand's related industry.

String

CREATEDBYNAME

Name of the user that created the account.

String

ACCOUNTNAME

Name of the account.

String

ADVERTISERNAME

Name of the advertiser.

String

UPDATEDBYNAME

Name of the user that was last to update the entity.

String

CREATEDON

Date advertiser was created.

Long

UPDATEDON

Date of last update (Date epoch).

Long

advertiserId

ID of advertiser.

Long

Optional

Request Format

GET https://adapi.sizmek.com/sas/brands?from=0&max=250

Response Format

A successful request returns the HTTP 200 OK status code and a JSON response body that shows the brands' details filtered by data ownership.

Example
{
  "result": [
    {
      "type": "Brand",
      "id": 1073751122,
      "relationsBag": {
        "parents": {
          "account": {
            "id": 1073746545,
            "name": "Testing Account",
            "internal": true
          },
          "advertiser": {
            "id": 1073747395,
            "name": "Advertiser110"
          },
          "brand": null,
          "campaign": null,
          "site": null
        },
        "children": {
          "advertisers": {
            "count": 0
          },
          "brands": {
            "count": 0
          },
          "campaigns": {
            "count": 4
          },
          "users": {
            "count": 0
          }
        },
        "creativeAccountContact": false
      },
      "version": 1545746566196166700,
      "createdBy": 1073741831,
      "createdByName": "QaAdminUser",
      "createdByAccount": 1073741826,
      "createdByAccountName": "QaAdminAccount",
      "createdOn": 1499779870595,
      "lastUpdatedBy": 1073741831,
      "lastUpdatedByName": "QaAdminUser",
      "lastUpdatedByAccount": 1073741826,
      "lastUpdatedByAccountName": "QaAdminAccount",
      "lastUpdateOn": 1499779870595,
      "name": "Advertiser110",
      "advertiserId": 1073747395,
      "vertical": "Apparel",
      "status": "Enabled",
      "adminSettings": {
        "type": "AdminSettings",
        "regionalSettings": {
          "type": "RegionalSettings",
          "defaultTimeZone": "GMT_Plus_12",
          "market": null,
          "geoVendor": "DigitalElement"
        },
        "defaultContacts": {
          "type": "DefaultContacts",
          "relationsBag": null,
          "sizmekContacts": [
            {
              "type": "DefaultSizmekContact",
              "id": 16739089973270,
              "clientRefId": "ad21d99f-bffd-9329-7118-463e2768e911",
              "relationsBag": null,
              "contactId": 1073741830,
              "name": "FirstSizmekUser",
              "campaignRole": "ClientServicesManager"
            },
            {
              "type": "DefaultSizmekContact",
              "id": 16739089973271,
              "clientRefId": "5cc95754-46b3-87df-e286-f7e97a3c14bc",
              "relationsBag": null,
              "contactId": 1073741830,
              "name": "FirstSizmekUser",
              "campaignRole": "SalesManager"
            }
          ],
          "campaignManagerContacts": [],
          "creativeManagerContacts": [],
          "creativeAccounts": [],
          "siteContacts": []
        },
        "thirdPartyTracking": "CustomParameters",
        "servingSettings": {
          "type": "ServingSettings",
          "collectBelowTheFold": true,
          "dfCollectionID": -1218887573,
          "pathLength": 0,
          "visibilityMinimumSurface": 2114154122,
          "visibilityMinimumDuration": -1574293070,
          "agencyVisibilityMinimumDuration": -1869715209,
          "agencyVisibilityMinimumSurface": 631413290,
          "adChoicesCertificationProgramID": 368396905,
          "adChoicesClickthroughURL": "zy59PinJvq",
          "disableCookie": true,
          "saveAdCookie": true,
          "retargetingCookieWindow": -435353679,
          "deviceIntelligenceTypeId": 1679125328
        },
        "campaignSettings": {
          "type": "CampaignSettings",
          "hardStopMethod": "KEEP_SERVING_AS_USUAL",
          "creativeManagerAccess": true,
          "traffickingMode": "AdvancedMode",
          "targetAudiencePriorityPolicy": "Server"
        },
        "privacy": {
          "type": "Privacy",
          "adMarker": {
            "includeInAllAds": false,
            "regulationProgram": "IAB_EU",
            "markerClickthroughURL": null
          },
          "disableCookies": false
        },
        "video": {
          "type": "Video",
          "autoTranscode": true
        }
      },
      "customFields": null,
      "accessLevel": "Full"
    },
    {
      "type": "Brand",
      "id": 1083771252,
      "relationsBag": {
        "parents": {
          "account": {
            "id": 1073746545,
            "name": "Testing Account",
            "internal": true
          },
          "advertiser": {
            "id": 1073747395,
            "name": "Advertiser110"
          },
          "brand": null,
          "campaign": null,
          "site": null
        },
        "children": {
          "advertisers": {
            "count": 0
          },
          "brands": {
            "count": 0
          },
          "campaigns": {
            "count": 0
          },
          "users": {
            "count": 0
          }
        },
        "creativeAccountContact": false
      },
      "version": 1550563426984788000,
      "createdBy": 1073741831,
      "createdByName": "QaAdminUser",
      "createdByAccount": 1073741826,
      "createdByAccountName": "QaAdminAccount",
      "createdOn": 1550563426984,
      "lastUpdatedBy": 1073741831,
      "lastUpdatedByName": "QaAdminUser",
      "lastUpdatedByAccount": 1073741826,
      "lastUpdatedByAccountName": "QaAdminAccount",
      "lastUpdateOn": 1550563426984,
      "name": "L-Test",
      "advertiserId": 1073747395,
      "vertical": "Apparel",
      "status": "Enabled",
      "adminSettings": {
        "type": "AdminSettings",
        "regionalSettings": {
          "type": "RegionalSettings",
          "defaultTimeZone": "GMT_Plus_12",
          "market": null,
          "geoVendor": "DigitalElement"
        },
        "defaultContacts": {
          "type": "DefaultContacts",
          "relationsBag": null,
          "sizmekContacts": [
            {
              "type": "DefaultSizmekContact",
              "id": 16739089973270,
              "clientRefId": "ad21d99f-bffd-9329-7118-463e2768e911",
              "relationsBag": null,
              "contactId": 1073741830,
              "name": "FirstSizmekUser",
              "campaignRole": "ClientServicesManager"
            },
            {
              "type": "DefaultSizmekContact",
              "id": 16739089973271,
              "clientRefId": "5cc95754-46b3-87df-e286-f7e97a3c14bc",
              "relationsBag": null,
              "contactId": 1073741830,
              "name": "FirstSizmekUser",
              "campaignRole": "SalesManager"
            }
          ],
          "campaignManagerContacts": [],
          "creativeManagerContacts": [],
          "creativeAccounts": [],
          "siteContacts": []
        },
        "thirdPartyTracking": "CustomParameters",
        "servingSettings": {
          "type": "ServingSettings",
          "collectBelowTheFold": true,
          "dfCollectionID": -1218887573,
          "pathLength": 0,
          "visibilityMinimumSurface": 2114154122,
          "visibilityMinimumDuration": -1574293070,
          "agencyVisibilityMinimumDuration": -1869715209,
          "agencyVisibilityMinimumSurface": 631413290,
          "adChoicesCertificationProgramID": 368396905,
          "adChoicesClickthroughURL": "zy59PinJvq",
          "disableCookie": true,
          "saveAdCookie": true,
          "retargetingCookieWindow": -435353679,
          "deviceIntelligenceTypeId": 1679125328
        },
        "campaignSettings": {
          "type": "CampaignSettings",
          "hardStopMethod": "KEEP_SERVING_AS_USUAL",
          "creativeManagerAccess": true,
          "traffickingMode": "AdvancedMode",
          "targetAudiencePriorityPolicy": "Server"
        },
        "privacy": {
          "type": "Privacy",
          "adMarker": {
            "includeInAllAds": false,
            "regulationProgram": "IAB_EU",
            "markerClickthroughURL": null
          },
          "disableCookies": false
        },
        "video": {
          "type": "Video",
          "autoTranscode": true
        }
      },
      "customFields": null,
      "accessLevel": "Full"
    }
  ]
}

Get a Brand

Retrieves a specific brand.

Request Parameters

Name

Description

Type

Required

Notes

id

ID of the requested brand

Integer

Required

Request Format

GET https://adapi.sizmek.com/sas/brands/1234567890

Response Format

A successful request returns the HTTP 200 OK status code and a JSON response body that shows the brand details filtered by data ownership. If there is no brand or data ownership, the request returns an empty response.

Example
{
  "result": {
    "type": "Brand",
    "id": 1083756754,
    "relationsBag": {
      "parents": {
        "account": {
          "id": 312,
          "name": "Analytics Training",
          "internal": false
        },
        "advertiser": {
          "id": 37721,
          "name": "#[2_LL_advp911"
        },
        "brand": null,
        "campaign": null,
        "site": null
      },
      "children": {
        "advertisers": {
          "count": 0
        },
        "brands": {
          "count": 0
        },
        "campaigns": {
          "count": 0
        },
        "users": {
          "count": 0
        }
      },
      "creativeAccountContact": false
    },
    "version": 1536845374212866000,
    "createdBy": 1073741831,
    "createdByName": "QaAdminUser",
    "createdByAccount": 1073741826,
    "createdByAccountName": "QaAdminAccount",
    "createdOn": 1536844470767,
    "lastUpdatedBy": 1073741831,
    "lastUpdatedByName": "QaAdminUser",
    "lastUpdatedByAccount": 1073741826,
    "lastUpdatedByAccountName": "QaAdminAccount",
    "lastUpdateOn": 1536845374209,
    "name": "Deb Test Brand-1",
    "advertiserId": 37721,
    "vertical": "Gaming",
    "status": "Enabled",
    "adminSettings": {
      "type": "AdminSettings",
      "regionalSettings": {
        "type": "RegionalSettings",
        "defaultTimeZone": "GMT_Plus_02",
        "market": null
      },
      "defaultContacts": {
        "type": "DefaultContacts",
        "relationsBag": null,
        "sizmekContacts": [
          {
            "type": "DefaultSizmekContact",
            "id": 41016402804742,
            "clientRefId": "4f23194a-87e2-5fed-0c57-f25e6e8c7c24",
            "relationsBag": null,
            "contactId": 1073741830,
            "name": "FirstSizmekUser",
            "campaignRole": "ClientServicesManager"
          },
          {
            "type": "DefaultSizmekContact",
            "id": 41016402804743,
            "clientRefId": "783e6026-793b-4469-3259-fc3394475b4f",
            "relationsBag": null,
            "contactId": 1073741830,
            "name": "FirstSizmekUser",
            "campaignRole": "SalesManager"
          }
        ],
        "campaignManagerContacts": [],
        "creativeManagerContacts": [],
        "creativeAccounts": [],
        "siteContacts": []
      },
      "thirdPartyTracking": null,
      "servingSettings": {
        "type": "ServingSettings",
        "collectBelowTheFold": false,
        "dfCollectionID": null,
        "pathLength": null,
        "visibilityMinimumSurface": 0,
        "visibilityMinimumDuration": 0,
        "agencyVisibilityMinimumDuration": 0,
        "agencyVisibilityMinimumSurface": 0,
        "adChoicesCertificationProgramID": 0,
        "adChoicesClickthroughURL": "",
        "disableCookie": false,
        "saveAdCookie": true,
        "retargetingCookieWindow": 0,
        "deviceIntelligenceTypeId": 0
      },
      "campaignSettings": {
        "type": "CampaignSettings",
        "hardStopMethod": "KEEP_SERVING_AS_USUAL",
        "creativeManagerAccess": true,
        "traffickingMode": "AdvancedMode",
        "targetAudiencePriorityPolicy": "Server"
      },
      "privacy": {
        "type": "Privacy",
        "adMarker": {
          "includeInAllAds": false,
          "regulationProgram": "IAB_EU",
          "markerClickthroughURL": null
        },
        "disableCookies": false
      },
      "video": {
        "type": "Video",
        "autoTranscode": true
      }
    },
    "customFields": null,
    "accessLevel": "Full"
  }
}{
        "result": {
                "type": "Brand",
                "id": 1083756754,
                "relationsBag": {
                        "parents": {
                                "account": {
                                        "id": 312,
                                        "name": "Analytics Training",
                                        "internal": false
                                },
                                "advertiser": {
                                        "id": 37721,
                                        "name": "#[2_LL_advp911"
                                },
                                "brand": null,
                                "campaign": null,
                                "site": null
                        },
                        "children": {
                                "advertisers": {
                                        "count": 0
                                },
                                "brands": {
                                        "count": 0
                                },
                                "campaigns": {
                                        "count": 0
                                },
                                "users": {
                                        "count": 0
                                }
                        },
                        "creativeAccountContact": false
                },
                "version": 1536845374212866048,
                "createdBy": 1073741831,
                "createdByName": "QaAdminUser",
                "createdByAccount": 1073741826,
                "createdByAccountName": "QaAdminAccount",
                "createdOn": 1536844470767,
                "lastUpdatedBy": 1073741831,
                "lastUpdatedByName": "QaAdminUser",
                "lastUpdatedByAccount": 1073741826,
                "lastUpdatedByAccountName": "QaAdminAccount",
                "lastUpdateOn": 1536845374209,
                "name": "Deb Test Brand-1",
                "advertiserId": 37721,
                "vertical": "Gaming",
                "status": "Enabled",
                "adminSettings": {
                        "type": "AdminSettings",
                        "regionalSettings": {
                                "type": "RegionalSettings",
                                "defaultTimeZone": "GMT_Plus_02",
                                "market": null
                        },
                        "defaultContacts": {
                                "type": "DefaultContacts",
                                "relationsBag": null,
                                "sizmekContacts": [{
                                        "type": "DefaultSizmekContact",
                                        "id": 41016402804742,
                                        "clientRefId": "4f23194a-87e2-5fed-0c57-f25e6e8c7c24",
                                        "relationsBag": null,
                                        "contactId": 1073741830,
                                        "name": "FirstSizmekUser",
                                        "campaignRole": "ClientServicesManager"
                                },
                                {
                                        "type": "DefaultSizmekContact",
                                        "id": 41016402804743,
                                        "clientRefId": "783e6026-793b-4469-3259-fc3394475b4f",
                                        "relationsBag": null,
                                        "contactId": 1073741830,
                                        "name": "FirstSizmekUser",
                                        "campaignRole": "SalesManager"
                                }],
                                "campaignManagerContacts": [],
                                "creativeManagerContacts": [],
                                "creativeAccounts": [],
                                "siteContacts": []
                        },
                        "thirdPartyTracking": null,
                        "servingSettings": {
                                "type": "ServingSettings",
                                "collectBelowTheFold": false,
                                "dfCollectionID": null,
                                "pathLength": null,
                                "visibilityMinimumSurface": 0,
                                "visibilityMinimumDuration": 0,
                                "agencyVisibilityMinimumDuration": 0,
                                "agencyVisibilityMinimumSurface": 0,
                                "adChoicesCertificationProgramID": 0,
                                "adChoicesClickthroughURL": "",
                                "disableCookie": false,
                                "saveAdCookie": true,
                                "retargetingCookieWindow": 0,
                                "deviceIntelligenceTypeId": 0
                        },
                        "campaignSettings": {
                                "type": "CampaignSettings",
                                "hardStopMethod": "KEEP_SERVING_AS_USUAL",
                                "creativeManagerAccess": true,
                                "traffickingMode": "AdvancedMode",
                                "targetAudiencePriorityPolicy": "Server"
                        },
                        "privacy": {
                                "type": "Privacy",
                                "adMarker": {
                                        "includeInAllAds": false,
                                        "regulationProgram": "IAB_EU",
                                        "markerClickthroughURL": null
                                },
                                "disableCookies": false
                        },
                        "video": {
                                "type": "Video",
                                "autoTranscode": true
                        }
                },
                "customFields": null,
                "accessLevel": "Full"
        }
}

Create a Brand

Adds a new brand.

Request Parameters

Name

Description

Type

Required

Notes

Body

Request containing brand body to create.

JSON

Required

Request Format

POST https://adapi.sizmek.com/sas/brands

Example
{
  "entities": [
    {
      "type": "Brand",
      "name": "TestBrand",
      "vertical": "Apparel",
      "status": "Enabled",
      "advertiserId": 1073747395,
      "clientRefId": null,
      "relationsBag": {
        "creativeAccountContact": false,
        "parents": {
          "account": {
            "id": 1073746545,
            "name": null
          },
          "advertiser": {
            "id": "1073747395",
            "name": "!!!eidanAdvertiser11072017"
          }
        },
        "children": {
          "campaigns": {
            "count": 0
          }
        }
      },
      "adminSettings": {
        "type": "AdminSettings",
        "regionalSettings": {
          "type": "RegionalSettings",
          "defaultTimeZone": "GMT_Plus_12",
          "market": null,
          "geoVendor": "DigitalElement",
          "reqParams": null,
          "fromServer": true,
          "parentResource": null,
          "restangularCollection": false
        },
        "defaultContacts": {
          "type": "DefaultContacts",
          "relationsBag": null,
          "sizmekContacts": [
            {
              "type": "DefaultSizmekContact",
              "id": 16739089973270,
              "clientRefId": "ad21d99f-bffd-9329-7118-463e2768e911",
              "relationsBag": null,
              "contactId": 1073741830,
              "campaignRole": "ClientServicesManager"
            },
            {
              "type": "DefaultSizmekContact",
              "id": 16739089973271,
              "clientRefId": "5cc95754-46b3-87df-e286-f7e97a3c14bc",
              "relationsBag": null,
              "contactId": 1073741830,
              "campaignRole": "SalesManager"
            }
          ],
          "campaignManagerContacts": [],
          "creativeManagerContacts": [],
          "creativeAccounts": [],
          "siteContacts": [],
          "reqParams": null,
          "fromServer": true,
          "parentResource": null,
          "restangularCollection": false
        },
        "thirdPartyTracking": "CustomParameters",
        "servingSettings": {
          "type": "ServingSettings",
          "collectBelowTheFold": true,
          "dfCollectionID": -1218887573,
          "pathLength": 0,
          "visibilityMinimumSurface": 2114154122,
          "visibilityMinimumDuration": -1574293070,
          "agencyVisibilityMinimumDuration": -1869715209,
          "agencyVisibilityMinimumSurface": 631413290,
          "adChoicesCertificationProgramID": 368396905,
          "adChoicesClickthroughURL": "zy59PinJvq",
          "disableCookie": true,
          "saveAdCookie": true,
          "retargetingCookieWindow": -435353679,
          "deviceIntelligenceTypeId": 1679125328,
          "reqParams": null,
          "fromServer": true,
          "parentResource": null,
          "restangularCollection": false
        },
        "campaignSettings": {
          "type": "CampaignSettings",
          "hardStopMethod": "KEEP_SERVING_AS_USUAL",
          "creativeManagerAccess": true,
          "traffickingMode": "AdvancedMode",
          "targetAudiencePriorityPolicy": "Server",
          "reqParams": null,
          "fromServer": true,
          "parentResource": null,
          "restangularCollection": false
        },
        "privacy": {
          "type": "Privacy",
          "adMarker": {
            "includeInAllAds": false,
            "regulationProgram": "IAB_EU",
            "markerClickthroughURL": null
          },
          "disableCookies": false,
          "reqParams": null,
          "fromServer": true,
          "parentResource": null,
          "restangularCollection": false
        }
      },
      "customFields": {
        "type": "CustomFields"
      }
    }
  ]
}

Response Format

A successful request returns the HTTP 200 OK status code and a JSON response body that shows the new brand resource.

Status Codes and Errors

For information about Brand status codes and errors, see Advertiser Resource.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk