1. Tracking IDs
ArtemisAds Open API
  • Get Started
    • Authentication
    • Pagination
    • Rate Limiting
  • Publisher API
    • Atttibution Program
      • Products
        • List Products
        • List Product Variations
        • List Deals
      • Brands
        • List Brands
      • Tracking IDs
        • Create Primary Tracking ID
          POST
        • Create Sub Tracking ID
          POST
        • List Tracking IDs
          GET
      • Publisher Sources
        • List Publisher Sources
      • Product Links
        • Create Product Link
        • List Product Link
        • Get Product Link by ID
      • Brand Links
        • Create Default Brand Storefront Link
        • List Brand Storefront Links
      • Reports
        • List Per-Product Attribution Reports
    • Associate Program
      • Products
        • List Associate Products
      • Brands
        • List Associate Brands
      • Associate Tags
        • Create Associate Tags
        • List Associate Tags
      • Product Links
        • List Associate Links
        • Create Associate Link
      • Reports
        • List Associate Reports
  • Seller API
    • Attribution Program
      • Brand
        • List Brands
      • Report
        • List Product Attribution Reports
  • Schemas
    • Schemas
      • Publisher Product List
      • PublisherProductLinkList
      • publisher 发布链接的渠道信息.
      • publisher 商品的报告.
      • Publisher Product
      • Publisher Product Deal
    • PublisherSource
    • PublisherProductReport
    • SellerBrand
    • PublisherDeal
    • PublisherBrand
    • PublisherBrandLink
    • PublisherSubTrackingId
    • PublisherAssociateBrand
    • PublisherAssociateTagsResult
    • PublisherAssociateTag
    • PublisherAssociateLink
    • PublisherAssociateReport
    • SellerReportPerProduct
    • PublisherProductLink
    • PublisherSourceList
    • PublisherCreateLinkRequest
    • PublisherProductReportList
    • SellerBrandList
    • PublisherReportPerProduct
    • PublisherDealList
    • PublisherBrandList
    • PublisherCreateBrandLinkRequest
    • PublisherBrandLinkList
    • PublisherPrimaryTrackingId
    • PublisherCreateSubTrackingIdRequest
    • PublisherProductDeal
    • PublisherAssociateBrandList
    • PublisherAssociateTagsRequest
    • PublisherAssociateTagList
    • PublisherCreateAssociateLinkRequest
    • PublisherAssociateReportList
    • PublisherAssociateLinkList
    • ResultVoid
    • SellerReportList
    • PublisherCpcProduct
    • PublisherReportList
    • PublisherCreatePrimaryTrackingIdRequest
    • PublisherTrackingIdList
    • PublisherProduct
    • PublisherCpcBrand
    • ProductPrice
    • PublisherProductVariationList
    • PublisherProductList
    • PublisherCpcCampaign
    • PublisherCpcCampaignList
    • PublisherCpcJoinResult
    • PublisherCpcLink
    • PublisherCpcLinkList
    • PublisherCpcReport
    • PublisherCpcReportList
  1. Tracking IDs

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 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 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
Previous
Create Sub Tracking ID
Next
List Publisher Sources
Built with