ArtemisAds
  1. Links
ArtemisAds
  • Get Started
    • Authentication
    • Pagination
  • Publisher API
    • Products
      • List Products
    • Deals
      • List Deals
    • Brands
      • List Brands
    • Links
      • List Publisher Sources
        GET
      • Create Product Link
        POST
      • List Product Link
        GET
      • Get Product Link by ID
        GET
      • Create Default Brand Storefront Link
        POST
      • List Brand Storefront Links
        GET
    • Reports
      • List Product reports
      • List Per-Product reports
  1. Links

List Product Link

GET
/openapi/publisher/v1/links
Publisher Open API
List product links.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.artemisads.com/openapi/publisher/v1/links?marketplace=amazon.com&asins=B0DGXXWGNQ,B0DGXX66RY&cursor=86Rf07xd4ztfA2ztfA&limit=100&productIds=aa_86Rf07xd4ztfA13R,aa_86Rf07xd4ztfA2Ud&sourceIds=aa_86Rf07xd4ztfA13R,aa_86Rf07xd4ztfA2Ud' \
--header 'x-aa-authorization: Bearer aa.oa2.v1.xxx'
Response Response Example
200 - Example 1
{
    "cursor": "string",
    "links": [
        {
            "linkId": "string",
            "productId": "string",
            "asin": "string",
            "sourceId": "string",
            "sourceName": "string",
            "marketplace": "string",
            "productStatus": "string",
            "trackingLink": "string",
            "shortTrackingLink": "string"
        }
    ]
}

Request

Query Params
marketplace
string 
optional
Represents an Amazon 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
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
productIds
string 
optional
Comma-delimited list of ArtemisAds Product 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
Header Params
x-aa-authorization
string 
required

Bearer

Example:
Bearer aa.oa2.v1.xxx

Responses

🟢200OK
*/*
OK
Body
cursor
string 
optional
The cursor to use for the next request, if empty there are no more items to return
links
array[object (PublisherProductLink) {9}] 
optional
The product link list
linkId
string 
required
ArtemisAds Identifier for an product link.
productId
string 
required
ArtemisAds Identifier for an product.
asin
string 
required
Amazon Standard Identifier for an Amazon product.
sourceId
string 
required
ArtemisAds identifier for the source where the created link will be used.
sourceName
string 
required
Name of the source where the created link will be used.
marketplace
string 
required
Represents an Amazon marketplace.
productStatus
string 
required
ArtemisAds Product status, inactive product do not earn commissions.
trackingLink
string 
optional
Full tracking link generated for the product.
shortTrackingLink
string 
optional
Shortened version of the tracking link for easier sharing.
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
Modified at 2025-06-04 02:14:41
Previous
Create Product Link
Next
Get Product Link by ID
Built with