ArtemisAds

List Products

GET

/openapi/publisher/v1/products

Publisher Open API

List active products in ArtemisAds’s product catalogue.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.artemisads.com/openapi/publisher/v1/products?marketplace=amazon.com&asins=B0DGXXWGNQ,B0DGXX66RY&availability=in_stock&brandIds=aa_86Rf07xd4ztfA13R,aa_86Rf07xd4ztfA2Ud&cursor=86Rf07xd4ztfA2ztfA&limit=100' \
--header 'x-aa-authorization: Bearer aa.oa2.v1.xxx'

Response Example

{
    "cursor": "string",
    "products": [
        {
            "aboutProduct": "about product",
            "asin": "B0DGXXWGNQ",
            "brandId": "aa_86Rf07xd4ztfA13R",
            "category": "category of product",
            "commission": 0.2,
            "deals": [
                {
                    "discountPercentage": 30,
                    "endTimestamp": 1734163199999,
                    "finalPrice": 70,
                    "fullPrice": 100,
                    "promoCode": "HK2024",
                    "startTimestamp": 1733385600000,
                    "status": "Active",
                    "type": 29.99
                }
            ],
            "imageUrl": "https://m.media-amazon.com/images/I/311cuH23123BL._SS60_.jpg",
            "marketplace": "amazon.com",
            "pricing": {
                "currency": "USD",
                "price": 123.45
            },
            "productId": "aa_uFNqjbUyGoMAU4FM",
            "status": "active",
            "title": "tile of product"
        }
    ]
}

Request

Query Params

marketplace

string

optional

Marketplace identifier for filtering results based on marketplace. Available options: amazon.com, amazon.co.uk, amazon.ca, amazon.de, amazon.fr.
If left empty, results from all marketplaces will be included.

Example:

amazon.com

asins

string

optional

Comma-delimited list of ASINs representing an array

Example:

B0DGXXWGNQ,B0DGXX66RY

availability

string

optional

Stock status filter. Available options:in_stock, out_of_stock.Specify 'in_stock' to include only in-stock products, 'out_of_stock' for out-of-stock products, or leave blank for all products.

Example:

in_stock

brandIds

string

optional

Comma-delimited list of ArtemisAds Brand Identifier representing an array.

Example:

aa_86Rf07xd4ztfA13R,aa_86Rf07xd4ztfA2Ud

cursor

string

optional

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

Example:

86Rf07xd4ztfA2ztfA

limit

integer <int32>

optional

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

Example:

100

Header Params

x-aa-authorization

string

required

Bearer

Example:

Bearer aa.oa2.v1.xxx

Responses

🟢200OK

application/json

Body

cursor

string

optional

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

products

array[object (Publisher Product) {12}]

optional

The product list

aboutProduct

string

optional

about product

Example:

about product

asin

string

required

Amazon Standard Identifier for an Amazon product.

Example:

B0DGXXWGNQ

brandId

string

required

ArtemisAds Brand Identifier for an product.

Example:

aa_86Rf07xd4ztfA13R