抖音获取活动页物料列表
需要授权
204人使用

该接口用于获取活动页物料列表,需要获取抖客授权

接口地址: http://api.tbk.dingdanxia.com/douyin/doukeActivityList 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 GET/POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

page

Number

1

分页(从1开始)

page_size

Number

20

每页的数量(小于等于20)

activity_status

Number

2

活动状态(不填默认返回进行中活动,1:待开始,2:进行中,3: 已结束)

返回参数说明

标记

类型

例子

说明

activity_main_cover

String

活动主图

activity_promotion_cover

String

活动推广配图

activity_preview_cover

String

活动预览图

activity_promotion_asset

String

活动推广素材

activity_type

String

活动类型,0:频道活动,1:营销活动

activity_id

String

活动ID

material_id

Int64

活动页物料ID

activity_name

String

活动名称

activity_validity_type

Int32

活动有效类型(0:短期(限时)活动,1:长期活动)

start_time

Int64

短期(限时)活动开始时间

end_time

Int64

短期(限时)活动结束时间

activity_rule

String

推广规则

activity_rule_link

String

活动推广规则详情链接

activity_status

Int32

活动状态(1:待开始,2:进行中,3: 已结束)

返回示例

{
    "code":200,
    "msg":"请求成功【success】",
    "total_results":11,
    "data":[
        {
            "activity_id":"1004",
            "activity_main_cover":"https://sf3-ttcdn-tos.pstatp.com/obj/cmp-ecom-alliance/ab_39437d329a8495727430fa3df264662a",
            "activity_name":"超市频道",
            "activity_preview_cover":"https://sf6-ttcdn-tos.pstatp.com/obj/cmp-ecom-alliance/ab_2a38bfdd5e5228e34f51f98d855c81b9",
            "activity_promotion_asset":null,
            "activity_promotion_cover":"https://sf3-ttcdn-tos.pstatp.com/obj/cmp-ecom-alliance/ab_97681109a780c8ec588646a0a750e61d",
            "activity_rule":"",
            "activity_rule_link":"",
            "activity_status":2,
            "activity_type":"0",
            "activity_validity_type":1,
            "end_time":0,
            "material_id":"7218134412955746618",
            "start_time":0
        }
    ]
}

			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。