ArtemisAds

List Brand Storefront Links

GET

/openapi/publisher/v1/links/storefronts

List Brand Storefront Links.

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

{
  "links": [
    {
      "marketplace": "",
      "linkId": "",
      "brandId": "",
      "brandName": "",
      "sourceId": "",
      "sourceName": "",
      "trackingLink": "",
      "shortLink": ""
    }
  ],
  "cursor": ""
}

Request

Query Params

marketplace

string

optional

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

Example:

amazon.com

brandIds

string

optional

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

Example:

aa_86Rf07xd4ztfA13R,aa_86Rf07xd4ztfA2Ud

sourceIds

string

optional

Comma-delimited list of ArtemisAds Publisher Source Identifier representing an array.

Example:

aa_86Rf07xd4ztfA13R,aa_86Rf07xd4ztfA2Ud

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 Storefront Link List

links

array[object (PublisherBrandLink) {8}]

optional

The brand storefront link list

marketplace

string

required

Marketplace identifier for filtering results based on marketplace. Available options: amazon.com, amazon.co.uk, amazon.ca, amazon.de, amazon.fr.

linkId

string

required

ArtemisAds Brand Link Identifier

brandId

string

required

ArtemisAds Brand Identifier

brandName

string

required

Brand name

sourceId

string

optional

ArtemisAds Source Identifier

sourceName

string

optional

Source name

trackingLink

string

required

Full tracking link URL

shortLink

string

optional

Short link URL

cursor

string

optional

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

Modified at 2025-06-04 02:37:49

Create Default Brand Storefront Link

List Product reports