Brands

Overview of the Brands resource and associated endpoints.

less than a minute

Sellers building integrations into Marketplacer should only use the current GraphQL-based Seller API, and not this (REST-based) API.

All future developments, including new features will be added to the the GraphQL-based Seller API only, more details on this API can be found here

Brands in Marketplacer represent the brands for adverts.

Listing brands

This endpoint returns all brands.

GET /api/v2/brands

Status: 200 OK

{
  "data": [
    {
      "id": 1,
      "type": "brands",
      "attributes": {
        "name": "Giant",
        "slug": "giant"
      }
    }
  ]
}

This endpoint allows you to search for a brand by its name or by a substring of its name.

If you wish to search for the “Giant” brand, make a query like this:

GET /api/v2/brands/search?name=Giant

If you wish to search by a substring, add the autocomplete parameter, like this:

GET /api/v2/brands/search?name=Gia&autocomplete=1

Status: 200 OK

{
  "data": [
    {
      "id": 1,
      "type": "brands",
      "attributes": {
        "name": "Giant",
        "slug": "giant"
      }
    }
  ]
}