tiktok/ads/ad-percentile

Get ad percentile data

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

Imported from a validated TikHub OpenAPI document. Pricing must be reviewed before enabling.