Branding

Branding

Branding allows SEEK hirers to promote their company brand on their job ads. Not all SEEK ad products include branding; you can query the ad product’s features to determine if branding is available.
A brand has four components:
  1. An opaque object identifier used to specify the brand when posting a job ad.
  2. A mandatory logo displayed on the hirer’s job ads and on SEEK’s native apply form. This is represented as an AdvertisementBrandingImage with a type code of OriginalLogo.
  3. An optional cover image displayed at the top of the hirer’s job ads. This is represented as an AdvertisementBrandingImage with a type code of CoverImage.
  4. A display name used for the hirer’s reference when selecting and managing brands.
Brands on the SEEK employer website are identified visually using their logo & cover image. The brand’s name is rarely descriptive enough to uniquely identify the brand. SEEK recommends that your software presents hirers with a paginated list of brands that incorporates their logo, cover image & name.
Loading brands
The SEEK API only supports listing and querying brands. Hirers must use the Logos & Brands section of the SEEK employer website to manage their brands.
When hirers create, update or delete a brand they expect the change to be reflected the next time they post a job ad. To support this, you should query the hirer’s current brands as part of your software’s job posting flow. If this isn’t possible you should provide a way for the hirer to manually refresh their brands from the SEEK API.

Before you begin

  • SEEK recommends using a browser token to query brands directly from a hirer’s browser. For the browser token to work, you will need to include the query:advertisement-brandings scope in your request.
  • You can also query brands from your backend using a partner token.

Operations

The SEEK API provides two queries for retrieving brands:
  1. advertisementBrandings returns a paginated list of brands for a given hirer.
  2. advertisementBranding returns a brand for a given brand object identifier.

advertisementBrandings

The advertisementBrandings query returns a paginated list of brands for a given hirer.
QueryVariablesResult
query ($after: String, $first: Int, $hirerId: String!) {
  advertisementBrandings(after: $after, first: $first, hirerId: $hirerId) {
    edges {
      node {
        id {
          value
        }
        name
        images {
          typeCode
          url
        }
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}
For subsequent queries you pass the previous page’s endCursor as the after argument. Once hasNextPage is false there are no more brands to page through.

advertisementBranding

The advertisementBranding query returns the brand for a given brand object identifier.
QueryVariablesResult
query ($id: String!) {
  advertisementBranding(id: $id) {
    id {
      value
    }
    name
    images {
      typeCode
      url
    }
  }
}