[中文]

用途:

获取特定行业的创意模式排行榜，了解哪些创意模式效果最好

分析不同创意模式的点击率、完播率等关键指标

为广告创意制作提供数据支持的最佳实践

参数:

first_industry_id: 行业ID，如游戏行业：25000000000

period_type: 时间类型，"week"=周数据，"month"=月数据

order_field: 排序字段，"ctr"=点击率，"play_over_rate"=播放完成率

order_type: 排序方式，desc（降序）或asc（升序）

week: 查看特定周的数据，格式：YYYY-MM-DD（可选）

返回内容说明:

list: 创意模式列表

label_info: 模式标签信息

value: 模式名称

description: 模式描述

ctr: 点击率（百分比）

play_over_rate: 播放完成率（百分比）

avg_watch_time: 平均观看时长

example_count: 示例数量

示例响应:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_creative_patterns",
  "params": {
    "first_industry_id": "25000000000",
    "period_type": "week",
    "order_field": "ctr"
  },
  "data": {
    "list": [
      {
        "label_info": {
          "value": "Problem-Solution",
          "description": "Present a problem and show the solution"
        },
        "ctr": 4.5,
        "play_over_rate": 68.2,
        "avg_watch_time": 12.3,
        "example_count": 234
      }
    ]
  }
}

[English]

Purpose:

Get creative pattern rankings for specific industries to understand which patterns perform best

Analyze key metrics like CTR and completion rate for different creative patterns

Provide data-driven best practices for ad creative production

Parameters:

first_industry_id: Industry ID, e.g., Games: 25000000000

period_type: Period type, "week"=Weekly data, "month"=Monthly data

order_field: Sort field, "ctr"=Click-through rate, "play_over_rate"=Completion rate

order_type: Sort order, desc (descending) or asc (ascending)

week: View data for specific week, format: YYYY-MM-DD (optional)

Return Description:

list: Creative pattern list

label_info: Pattern label information

value: Pattern name

description: Pattern description

ctr: Click-through rate (percentage)

play_over_rate: Play completion rate (percentage)

avg_watch_time: Average watch time

example_count: Number of examples

Example Response:

{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_creative_patterns",
  "params": {
    "first_industry_id": "25000000000",
    "period_type": "week",
    "order_field": "ctr"
  },
  "data": {
    "list": [
      {
        "label_info": {
          "value": "Problem-Solution",
          "description": "Present a problem and show the solution"
        },
        "ctr": 4.5,
        "play_over_rate": 68.2,
        "avg_watch_time": 12.3,
        "example_count": 234
      }
    ]
  }
}

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 creative pattern rankings

[中文]#

用途:#

参数:#

返回内容说明:#

示例响应:#

[English]#

Purpose:#

Parameters:#

Return Description:#

Example Response:#

Request