| 接口地址： | https://testapi.adbug.cn/api/search/ads |
| 支持格式： | JSON |
| 请求方式： | POST |
| 请求示例： | https://testapi.adbug.cn/api/search/ads?key=立即申请 |
| 名称 | 类型 | 是否必填 | 参数说明 |
|---|---|---|---|
| key | string | 是 | key调用码 |
| wd | string | 否 | 搜索关键词（无其他过滤条件则必填） |
| sem_type | string | 否 | 搜索结果是否包含sem广告,默认为no，不包含no，包含yes |
| brand | string | 否 | 品牌名称 |
| mainpublisher | string | 否 | 媒体名称 |
| advertiser | string | 否 | 落地页域名，支持多选，中间以,隔开 |
| publisher | string | 否 | 媒体域名，支持多选，中间以,隔开 |
| accurate | string | 否 | 关键词匹配模式，默认为0，模糊匹配0，完全匹配2 |
| start_time | timestamp | 否 | 开始时间，10位时间戳 |
| end_time | timestamp | 否 | 截止时间，10位时间戳 |
| negative | string | 否 | 违法广告，不违法为空，违法01,98 |
| platform | string | 否 | 素材平台，PC为1，移动为2，iOS为3，Android为4，OTT为5 |
| type | string | 否 | 素材类型，图片为1,Flash为2，视频为3 |
| shape | string | 否 | 素材尺寸，横幅为1，正方形为2，小横幅为3,中横幅为4，大横幅为5 |
| parent_ad | string | 否 | 素材去重，指为0 |
| wd2 | string | 否 | 搜索结果匹配关键词 |
{
"total": 39127,
"page": 2,
"data": [
{
"creativity_id": 154034500,
"creativity_title": "职业教育报考即将截止",
"creativity_ad_type": "display",
"creativity_class": "image",
"creativity_image_list": [
"https://file.adbug.cn/m/image/3e88397707294a5ba06f5117a41253c8.jpg"
],
"creativity_video_list": [],
"creativity_landing_screenshot": "",
"creativity_company_host": "sogou.com",
"creativity_company_name": "sogou.com 搜狗联盟",
"creativity_media_host": "com.tiexue.mobile.topnews",
"creativity_media_name": "com.tiexue.mobile.topnews 军事头条(APP)",
"creativity_total_showtimes_cnt": [
6,
5,
1,
4
],
"creativity_total_showtimes_list": [
1551812400,
1551816000,
1551866400,
1551880800
],
"creativity_ip": [
"47.97.126.163"
],
"creativity_showdate_first": 1551812400,
"creativity_showdate_last": 1551880800,
"creativity_width": 320,
"creativity_height": 240,
"creativity_tracker_host": "",
"creativity_industry": "教育培训类",
"creativity_landing_url": "https://wap.sogou.com/web/searchList.jsp?keyword=%E8%81%8C%E4%B8%9A%E6%95%99%E8%82%B2&pid=sogou-waps-0777acff7c9ab345&v=5&mfp=YnU9NTExMDAmcGlkPXNvZ291LXdhcHMtMDc3N2FjZmY3YzlhYjM0NSZwcGlkPXRpZXh1ZXRfYXBwXzEmcHZpZD0zMGNhZDgzMjI2ZmI3N2Q5JnRzPTE1NTE4MTg3MTgmaWQ9NjQ3JmRpZD0wJmZpZD0wJnNpZD0wJnNlPTAmZXhkPTE7MTEzOzAmZmc9MTIwMSwxNDAxLDE2MDMsODUwLDMxMTAsMzIwNCwzMzEyLDM2MDIsMjEwNCwyNDAxLDI1MzYsMjcxMiZjaGVhdD0wJmZpcD0xMTEuMTY1LjM5LjIzMSZzPWM3MjFjM2ZjAA==&spec=0",
"creativity_client": "IOS",
"creativity_search_keyword": "",
"creativity_description": "",
"creativity_bottom_description": "",
"creativity_promotion_type": "其他",
"creativity_type": "图片",
"creativity_ad_format": "banner",
"creativity_md5": "997d08b33dcbf6701ee974572800d850"
}
],
"code": 200,
"msg": "success"
}| 字段名称 | 父节点 | 类型&描述 | 格式&备注 |
|---|---|---|---|
| total | int | 总数 | |
| data | List<adinfo> | 实际数据内容，包含多个adinfo的List, 单次最多20个广告信息 | |
| adinfo(字段不显示) | data | OJBECT | ADINFO结构 |
| creativity_id | adinfo | Int64.第三方创意ID | |
| creativity_title | adinfo | String. 创意标题 | |
| creativity_ad_type | adinfo | String. 广告种类 | |
| creativity_class | adinfo | Enum. 创意类型 | ENUM(image【图片】）,flv【视频】) |
| creativity_image_list | adinfo | List<url>. 广告素材图片 | 包含多个图片URL的List结构 |
| url(字段不显示) | creativity_image_list | String. 图片URL | |
| creativity_video_list | adinfo | List<url>. 广告素材视频 | 包含多个视频URL的List结构 |
| url(字段不显示) | creativity_video_list | String. 视频URL | |
| creativity_landing_screenshot | adinfo | String. 图片URL | 落地页截图URL （额外收费） |
| creativity_company_host | adinfo | String. 广告主域名 | |
| creativity_company_name | adinfo | String. 广告主中英文名 | |
| creativity_media_host | adinfo | String. 媒体域名 | |
| creativity_media_name | adinfo | String. 媒体中英文名 | |
| creativity_showdate_first | adinfo | Int32. 首次发现时间戳（整点） | UTC时间戳 |
| creativity_showdate_last | adinfo | Int32. 末次发现时间戳（整点） | UTC时间戳 |
| creativity_width | adinfo | Int32. 创意宽度 | 单位px |
| creativity_height | adinfo | Int32. 创意高度 | 单位px |
| creativity_tracker_host | adinfo | String. 广告投放平台 | 广告投放平台字符串 |
| creativity_total_showtimes_cnt | adinfo | List. 广告发现时间对应次数 | |
| creativity_total_showtimes_list | adinfo | List. 广告发现时间列表（整点） | |
| creativity_ip | adinfo | List. 设备ip | |
| creativity_industry | adinfo | ENUM. 广告所属行业 教育培训类 | |
| creativity_landing_url | adinfo | String. 落地页url | |
| creativity_client | adinfo | Enum. 终端 | ENUM(ott,pc,ios,android) |
| creativity_search_keyword | adinfo | String. 搜索关键词 | SEM广告有该数据 |
| creativity_description | adinfo | String. 广告文字描述 | SEM广告有该数据 |
| creativity_bottom_description | adinfo | String. 底部文字描述 | SEM广告有该数据 |
| creativity_promotion_type | adinfo | Enum. 推广类型 | ENUM(其他,商品销售,应用下载) |
| creativity_type | adinfo | Enum. 素材类型 | ENUM(图片,视频,图组,纯文案) |
| creativity_ad_format | adinfo | Enum. 广告形式 | ENUM(banner【横幅广告】,native【原生广告】,sem【关键字竞价广告】) |
| creativity_md5 | adinfo | String.判别唯一标识 |