国内广告素材OEM API说明文档

本文档说明国内广告素材搜索接口的查询参数。接口参数与 AppGrowing 网页素材搜索（素材列表页）一致，可按关键词、推广物类别、行业、渠道、媒体等条件检索广告素材，并支持多种排序方式。

一、接口地址与鉴权

1.1 调用域名

https://oem-api-alishh.umlife.net/{part}/{endpoint}

• part：合作方标识，由服务方分配
• endpoint：接口名（endpoint），可选 ad_list（广告列表）、material_list（素材列表）
• 请求方式：GET

1.2 鉴权方式

请求需携带以下两个参数：

签名算法：

1. 将除 sign 外的所有请求参数（含 ts）按参数名升序排列
2. 拼接为 key1=value1key2=value2...（值为空的参数跳过）
3. sign = md5(secret + 拼接字符串)，secret 由服务方提供

Python 签名示例：

import hashlib
import time

def get_key_value_str(params):
    pair_array = []
    for k in sorted(params.keys()):
        v = str(params.get(k, "")).strip()
        if v:
            pair_array.append(f"{k}={v}")
    return "".join(pair_array)

def gen_sign(secret, params_str):
    return hashlib.md5((secret + params_str).encode("utf-8")).hexdigest()

params = {
    "dt_start": "2026-08-01",
    "dt_end": "2026-08-07",
    "keyword": "抖音",
    "ts": int(time.time()),
}
params["sign"] = gen_sign("你的secret", get_key_value_str(params))

1.3 响应格式

{
  "c": 0,
  "m": "",
  "data": [],
  "total": 0,
  "total_quota": 1000,
  "remain_quota": 1000
}

total_quota / remain_quota 在成功（c=0）与超限（c=42900，此时 remain_quota=0）响应中返回；其余错误响应不返回额度字段。

常见错误码：

二、调用示例

以 ad_list 为例，多个枚举值用逗号分隔（单值参数 outer_purpose 除外）：

GET https://oem-api-alishh.umlife.net/{part}/{endpoint}
    ?dt_start=2026-08-01
    &dt_end=2026-08-07
    &keyword=抖音
    &sort_first_field=impression
    &sort_first_order=desc
    &outer_purpose=1        # 游戏（广告视图仅支持大类单值）
    &industry_list=101            # 游戏行业
    &platform_list=1,2            # Android + iOS
    &video_time=1                 # <=15s
    &page=0
    &ts=1754287200
    &sign=<签名>

完整 Python 调用示例：

import hashlib
import time
import requests

BASE_URL = "https://oem-api-alishh.umlife.net/{part}/{endpoint}"
SECRET = "服务方提供的secret"

def get_key_value_str(params):
    pair_array = []
    for k in sorted(params.keys()):
        v = str(params.get(k, "")).strip()
        if v:
            pair_array.append(f"{k}={v}")
    return "".join(pair_array)

def gen_sign(secret, params_str):
    return hashlib.md5((secret + params_str).encode("utf-8")).hexdigest()

params = {
    "dt_start": "2026-08-01",
    "dt_end": "2026-08-07",
    "keyword": "抖音",
    "sort_first_field": "impression",
    "sort_first_order": "desc",
    "outer_purpose": "11",
    "industry_list": "101",
    "platform_list": "1,2",
    "video_time": "1",
    "page": "0",
    "ts": int(time.time()),
}
params["sign"] = gen_sign(SECRET, get_key_value_str(params))

resp = requests.get(BASE_URL.format(part="合作方标识", endpoint="ad_list"), params=params, timeout=30)
print(resp.json())

三、参数总览

ad_list 与 material_list 接口参数一致，支持的全部参数如下（枚举明细见对应章节）：

多个枚举值用逗号分隔传参（如 platform_list=1,2）。

四、排序参数

通过 sort_first_field + sort_first_order 两个参数控制排序，与网页排序下拉选项一致：

排序字段取值：

五、推广物类别参数（outer_purpose）

推广物类别分大类与子类两级，与网页「推广物类别」筛选一致。传大类值筛选该大类全部广告，传子类值仅筛选该子类。

使用说明： - 两接口均只允许传单个值，多值（逗号分隔）返回错误码 40310 - 广告视图（ad_list）：支持大类与子类。子类映射为「外层大类 + 投放目的（purpose 位掩码）/ ad_type / is_shop / is_product」组合查询（如 11 游戏App下载 → outer_purpose=1 + purpose=1 应用下载；52 微信私域留资 → ad_type=7）。平台细分（微信/抖音/快手的小游戏、小程序、账号）在广告索引无对应维度，归入所属大类的投放目的位 - 素材视图（material_list）：支持大类与子类，底层映射为素材筛选参数（如 is_game/is_ec/campaign_type_lst 等）

大类

子类

六、筛选参数

6.1 推广物行业（industry_list）

行业分大类（3 位编码）与子类（5 位编码，前 3 位为大类编码）两级：

大类：

全部子类：

6.2 渠道（channel_list）

自有流量平台（24 个）：

手机厂商（3 个）：

广告网络（4 个）：

应用商店（1 个）：

DSP 平台（3 个）：

6.3 媒体（media_list）

社交媒体（5 个）：

资讯媒体（6 个）：

视频媒体（10 个）：

工具媒体（8 个）：

联盟媒体（11 个）：

手机厂商（13 个）：

6.4 平台（platform_list）

6.5 广告形式（format_list）

6.6 素材类型（material_type_list）

6.7 城市（city_list）

传 area 编码（1=全国，2=北京市，3=天津市…）。广告视图直接按编码查询；素材视图接口内部将编码映射为地区代号（cc）后查询，传值方式一致。

素材视图 1（全国）说明： 全国在 area 表中的地区代号为非数字（CN），无法用于素材视图地区查询，素材视图传 1 时跳过 city 过滤返回全量数据（与不传该参数等价）。

通投地区（1 个）：

核心城市（4 个）：

省会城市（16 个）：

其他城市（4 个）：

6.8 视频时长（video_time）

6.9 分辨率（resolution）

6.10 App 变现方式（app_cash_way_list）

6.11 素材比例（material_ratio_list）

横版（5 个）：

竖版（5 个）：

方形（1 个）：

七、返回字段

广告视图（ad_list）

返回字段：

素材视图（material_list）

返回字段：