展示类广告:
腾讯广告
巨量引擎
猎豹广告
阿里汇川
网易易效
百度信息流
微博粉丝通
百度百青藤
新浪扶翼
360点睛
一点资讯
凤凰凤羽
搜狐汇算
搜狗星耀
美柚女人通
百度百通
WiFi 万能钥匙
知乎
汽车之家
趣头条
懂球帝
虎扑
小红书
优酷睿视
奇麟神算
芒果 TV
Bilibili 必选
快手
小米
搜索竞价广告:
接口地址: | 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.判别唯一标识 |
status | 参数说明 |
---|---|
200 | 获取成功 |
201 | 暂无数据 |
311 | 接口验证失败 |
4011 | 今日的搜索次数已达上限 |
4012 | 今日的搜索翻页数已达上限 |
4013 | 今日的微信朋友圈广告搜索翻页数已达上限 |
4014 | 今日的SEM广告搜索翻页数已达上限 |