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

Query Params

Header Params

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.artemisads.com/openapi/publisher/v1/tracking-ids?primaryTrackingId=undefined&cursor=undefined&limit=undefined' \
--header 'x-aa-authorization: Bearer aa.oa2.v1.xxx'

Response Example

200 - 成功示例

{
  "trackingIds": [
    {
      "primaryTrackingId": "",
      "productLinkCount": 0,
      "brandLinkCount": 0,
      "subTrackingIds": [
        {
          "primaryTrackingId": "",
          "subTrackingId": "",
          "productLinkCount": 0,
          "brandLinkCount": 0
        }
      ]
    }
  ],
  "cursor": ""
}

Modified at 2025-07-04 01:18:44

Create Sub Tracking ID

List Publisher Sources