Skip to end of metadata
Go to start of metadata

Brand Service

The read-only Brand Service allows you to see what advertiser brands are registered in the AppNexus system, the urls associated to each brand, the number of active creatives assigned to each brand, and more. You can also use the Brand Service to obtain the ID assigned to a specific brand. This ID is used in the Ad Profile Service and as an optional input for the Creative Service.

Brands are categorized by company and category. See the Brand Company Service and Category Service for more information.

On This Page

REST API

View all brands:
GET https://api.appnexus.com/brand

It can take a while to receive all brands because, by default, the response tells you the number of active creatives assigned to each brand. To remove num_creatives from the response, and speed up the call significantly, you can pass simple=true in the query string, i.e., https://api.appnexus.com/brand?simple=true.

The license could not be verified: License Certificate has expired!

View all brands with names containing certain characters:
GET https://api.appnexus.com/brand?search=BRAND_NAME

View all brands with URLs containing complete words:
GET https://api.appnexus.com/brand?url_search=BRAND_URL

View a particular brand:
GET https://api.appnexus.com/brand?id=BRAND_ID

The license could not be verified: License Certificate has expired!

JSON Fields

Field

Type

Description

id

int

The ID of the brand.

name

string

The name of the brand.

urls

array of strings

URLs associated with the brand. The format is ["brandurl.com", "brandurl.net", ...]

is_premium

boolean

If true, the brand is a premium brand.

category_id

int

The ID of the category associated with the brand.

company_id

int

The ID of the company associated with the brand.

num_creatives

int

Deprecated. Currently returns 0.

last_modified

string

When the brand was last modified.

The license could not be verified: License Certificate has expired!

Examples

View all brands
View brand 10