[中文]

用途:

获取特定产品类目的详细指标数据和时间趋势

分析产品的发布量、点击率、转化率等核心指标变化

帮助了解产品类目的市场表现和发展趋势

参数:

id: 产品类目ID，如香水：601583

last: 最近天数，如7、30天

metrics: 指标类型，多个用逗号分隔，如"post,ctr,cvr"

ecom_type: 电商类型，默认"l3"

period_type: 时间类型，默认"last"

返回内容说明:

info: 产品指标信息

comment: 评论数

cost: 花费金额

cover_url: 封面图URL（可能为null）

cpa: 每次转化成本

ctr: 点击率

ctr_metrics: 点击率时间序列数据

time: 时间戳

value: 对应时间的点击率

cvr: 转化率

ecom_type: 电商类型

first_ecom_category: 一级电商类目

impression: 展示量

like: 点赞数

play_six_rate: 6秒播放率

post: 发布量

post_change: 发布量变化率

post_metrics: 发布量时间序列数据

time: 时间戳

value: 对应时间的发布量

second_ecom_category: 二级电商类目

share: 分享数

third_ecom_category: 三级电商类目

url_title: URL标题

示例响应:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_product_metrics",
  "params": {
    "id": "601583",
    "last": "30",
    "metrics": "post,ctr",
    "ecom_type": "l3",
    "period_type": "last"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "info": {
        "comment": 13559,
        "cost": 2330000,
        "cover_url": null,
        "cpa": 12.4,
        "ctr": 1.04,
        "ctr_metrics": [
          {
            "time": 1747267200,
            "value": 0.88
          },
          {
            "time": 1747353600,
            "value": 0.99
          }
        ],
        "cvr": 15.2,
        "ecom_type": "l3",
        "post": 52300,
        "post_change": -8.12,
        "post_metrics": [
          {
            "time": 1747267200,
            "value": 1800
          }
        ]
      }
    }
  }
}

[English]

Purpose:

Get detailed metric data and time trends for specific product categories

Analyze changes in core metrics like post volume, CTR, CVR for products

Help understand market performance and development trends of product categories

Parameters:

id: Product category ID, e.g., Perfume: 601583

last: Number of recent days, e.g., 7, 30 days

metrics: Metric types, multiple separated by commas, e.g., "post,ctr,cvr"

ecom_type: E-commerce type, default "l3"

period_type: Period type, default "last"

Return Description:

info: Product metric information

comment: Comment count

cost: Cost amount

cover_url: Cover image URL (may be null)

cpa: Cost per acquisition

ctr: Click-through rate

ctr_metrics: CTR time series data

time: Timestamp

value: CTR at that time

cvr: Conversion rate

ecom_type: E-commerce type

first_ecom_category: First-level e-commerce category

impression: Impression count

like: Like count

play_six_rate: 6-second play rate

post: Post volume

post_change: Post volume change rate

post_metrics: Post volume time series data

time: Timestamp

value: Post volume at that time

second_ecom_category: Second-level e-commerce category

share: Share count

third_ecom_category: Third-level e-commerce category

url_title: URL title

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_product_metrics",
  "params": {
    "id": "601583",
    "last": "30",
    "metrics": "post,ctr",
    "ecom_type": "l3",
    "period_type": "last"
  },
  "data": {
    "code": 0,
    "msg": "OK",
    "data": {
      "info": {
        "comment": 13559,
        "cost": 2330000,
        "cover_url": null,
        "cpa": 12.4,
        "ctr": 1.04,
        "ctr_metrics": [
          {
            "time": 1747267200,
            "value": 0.88
          },
          {
            "time": 1747353600,
            "value": 0.99
          }
        ],
        "cvr": 15.2,
        "ecom_type": "l3",
        "post": 52300,
        "post_change": -8.12,
        "post_metrics": [
          {
            "time": 1747267200,
            "value": 1800
          }
        ]
      }
    }
  }
}

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

获取产品指标数据/Get product metrics

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#

Request