ArtemisAds

List Brands

GET

/openapi/publisher/v1/brands

List Brands

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.artemisads.com/openapi/publisher/v1/brands?marketplace=amazon.com&limit=100&cursor=86Rf07xd4ztfA2ztfA' \
--header 'x-aa-authorization: Bearer aa.oa2.v1.xxx'

Response Example

{
  "brands": [
    {
      "brandId": "",
      "brandName": "",
      "marketplace": "",
      "image": "",
      "biography": "",
      "avgCommission": 0.0,
      "activeProductCount": 0,
      "url": ""
    }
  ],
  "cursor": ""
}

Request

Query Params

marketplace

string

required

Represents an Amazon marketplace.Available options: amazon.com, amazon.co.uk, amazon.ca, amazon.de, amazon.fr.

Example:

amazon.com

limit

integer

optional

Maximum number of items to return in the response, default is 100

Example:

100

cursor

string

optional

The cursor returned from the last request, if omitted the first page will be returned

Example:

86Rf07xd4ztfA2ztfA

Header Params

x-aa-authorization

string

required

Bearer

Example:

Bearer aa.oa2.v1.xxx

Responses

🟢200Success

application/json

Body

Publisher Brand List

brands

array[object (PublisherBrand) {8}]

optional

The brand list

brandId

string

required

ArtemisAds Brand Identifier

brandName

string

required

Amazon brand name

marketplace

string

required

Represents an Amazon marketplace

image

string

optional

Brand logo image URL

biography

string

optional

Brand biography

avgCommission

number

optional

Average commission of all active products under this brand

activeProductCount

integer

optional

Number of active products under this brand

url

string

optional

Brand store homepage URL

cursor

string

optional

The cursor to use for the next request, if empty there are no more items to return

🟠400Bad Request

🟠401Unauthorized

Modified at 2025-06-05 10:02:21

List Deals

List Publisher Sources