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

List Tracking IDs

GET
/openapi/publisher/v1/tracking-ids
Retrieves the hierarchical tracking ID structure for a specified primaryTrackingId under the Publisher account.
This endpoint returns a tree-like structure, where the root node represents the primary tracking ID, and the child nodes represent its associated sub tracking IDs (Sub-IDs). Each node may include metadata such as the number of product links and brand links linked to that tracking ID.
This structure enables Publisher organizations to visualize and manage how tracking IDs are organized and used across their internal distribution networks. Useful for analyzing promotion performance by tracking lineage from primary to sub-level promoters.
Currently, only queries based on primaryTrackingId are supported.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.artemisads.com/openapi/publisher/v1/tracking-ids?primaryTrackingId&cursor&limit' \
--header 'x-aa-authorization: Bearer aa.oa2.v1.xxx'
Response Response Example
200 - ๆˆๅŠŸ็คบไพ‹
{
  "trackingIds": [
    {
      "primaryTrackingId": "",
      "productLinkCount": 0,
      "brandLinkCount": 0,
      "subTrackingIds": [
        {
          "primaryTrackingId": "",
          "subTrackingId": "",
          "productLinkCount": 0,
          "brandLinkCount": 0
        }
      ]
    }
  ],
  "cursor": ""
}

Request

Query Params

Header Params

Responses

๐ŸŸข200Success
application/json
Body

๐ŸŸ 401Unauthorized
๐ŸŸ 403Forbidden
Modified atย 2025-07-04 01:18:44
Previous
Create Sub Tracking ID
Next
List Products
Built with