Skip to main content
GET
/2027-01/retail-media/catalog/merchants/{merchant-id}/brands

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

merchant-id
string
required

Identifies the retail media merchant whose catalog brands are listed.

Query Parameters

include-inactive
boolean
default:false

Also return the brands that disappeared from the last extraction (status = inactive).

limit
integer<int32>
default:2000

Maximum number of brands returned in the page.

Required range: 1 <= x <= 2000
offset
integer<int32>
default:0

Index of the first brand of the page, used to page through the collection.

Response

200 - application/json
object | null

The page of brands extracted from the catalogs of the merchant.

Paginated response holding the brands extracted from the catalogs of a merchant.

data
(object | null)[] | null
required

Resource holding a brand extracted from the catalogs of a merchant.

errors
object[] | null
read-only
meta
object | null

Pagination applied to the returned collection.

warnings
object[] | null
read-only