brands

The brand is a key piece of information required to create a product. This query allows sellers to retrieve brand reference data from Marketplacer with a view to creating products.

Key Information

Use-Case

The brands query can return a list of brands (created by the marketplace operator) so that you can use that information to create and update products as described here.

Availability

  • Operator API: Yes
  • Seller API: Yes

query BrandsQuery {
  brands(first: 10, after: null) {
    totalCount
    pageInfo {
      hasNextPage
      endCursor
    }
    edges {
      node {
        id
        name
      }
    }
  }
}

Arguments

NameTypeDescription
showOnlineOnlyBooleanReturn brands that are related only to online Products
afterStringPagination cursor for moving through result set - more on pagination here
beforeStringNot in use - backwards pagination not supported
firstIntPagination page size - more on pagination here
lastIntNot in use - backwards pagination not supported

Response

Returns BrandsConnection


Error Responses

HTTP ErrorError MessageMeaning
401UnauthorizedYou don’t have access to the endpoint, likely Basic Authentication credentials are missing
401API Token has expiredYou don’t have access to the endpoint, likely that you are either not supplying an API Key, or the key you are supplying is invalid

Further Reading