Explore our Marketplace to buy and sell APIs, services, and social media solutions. Connect with a vibrant community of developers, businesses, and creators!

获取广告百分位数据/Get ad percentile data

GET

https://api.tikhub.io/api/v1/tiktok/ads/get_ad_percentile

TikTok-Ads-API

Last modified:2026-03-21 03:26:24

OperationId:get_ad_percentile_api_v1_tiktok_ads_get_ad_percentile_get

[中文]

用途:

获取广告在同行业中的百分位排名数据

了解广告在各项指标上相对于同行的表现水平

帮助评估广告效果并制定优化策略

参数:

material_id: 广告素材ID，必填参数

metric: 分析指标，可选值：

ctr_percentile: 点击率百分位（默认）

time_attr_conversion_rate_percentile: 时间归因转化率百分位

click_cnt_percentile: 点击次数百分位

time_attr_convert_cnt_percentile: 时间归因转化次数百分位

show_cnt_percentile: 展示次数百分位

period_type: 时间范围(天)，默认180天

返回内容说明:

percentile_data: 百分位数据

ctr_percentile: 点击率百分位（0-100）

cvr_percentile: 转化率百分位

engagement_percentile: 互动率百分位

view_percentile: 观看量百分位

industry_average: 行业平均值对比

示例响应:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_ad_percentile",
  "params": {
    "material_id": "7213258221116751874"
  },
  "data": {
    "percentile_data": {
      "ctr_percentile": 85,
      "cvr_percentile": 72,
      "engagement_percentile": 90,
      "view_percentile": 88,
      "industry_average": {
        "ctr": 2.5,
        "cvr": 1.2,
        "engagement": 5.8
      }
    }
  }
}

[English]

Purpose:

Get ad percentile ranking data within the industry

Understand ad performance levels relative to peers across various metrics

Help evaluate ad effectiveness and develop optimization strategies

Parameters:

material_id: Ad material ID, required parameter

metric: Analysis metric, options:

ctr_percentile: CTR percentile (default)

time_attr_conversion_rate_percentile: Time-attributed conversion rate percentile

click_cnt_percentile: Click count percentile

time_attr_convert_cnt_percentile: Time-attributed conversion count percentile

show_cnt_percentile: Impression count percentile

period_type: Time period in days, default 180

Return Description:

percentile_data: Percentile data

ctr_percentile: Click-through rate percentile (0-100)

cvr_percentile: Conversion rate percentile

engagement_percentile: Engagement rate percentile

view_percentile: View count percentile

industry_average: Industry average comparison

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_ad_percentile",
  "params": {
    "material_id": "7213258221116751874"
  },
  "data": {
    "percentile_data": {
      "ctr_percentile": 85,
      "cvr_percentile": 72,
      "engagement_percentile": 90,
      "view_percentile": 88,
      "industry_average": {
        "ctr": 2.5,
        "cvr": 1.2,
        "engagement": 5.8
      }
    }
  }
}

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200OK

application/json

Successful Response

Body

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.tikhub.io/api/v1/tiktok/ads/get_ad_percentile?material_id=7213258221116751874&metric&period_type' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "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
}

Modified at 2026-03-21 03:26:24

获取广告关键帧分析/Get ad keyframe analysis

获取广告互动分析/Get ad interactive analysis

获取广告百分位数据/Get ad percentile data

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#