按行业维度查询Query

按行业维度查询搜索广告的Query。调用方指定时间范围与行业层级（一级、二级行业必填，三/四级行业可选），并可按 PV、消费、点击、展现、转化等指标区间进行过滤，接口返回符合条件的行业报表数据。

HTTP请求方式

POST

请求地址

https://api.e.360.cn/dianjing/report/queryReportByIndustry

Headers 请求参数

字段	类型	必须	描述
Content-Type	string	yes	application/x-www-form-urlencoded
apiKey	string	yes	注册时分配到的api key，该参数作为HTTP HEAD字段传递。
accessToken	string	yes	身份认证通过后平台分配的临时token，作为操作对应广告账户的凭证，10小时有效。参数获取方式见接口clientLogin

Body 请求参数

字段	类型	必须	描述
startDate	string	Yes	开始日期，格式 yyyy-MM-dd
endDate	string	Yes	结束日期，格式 yyyy-MM-dd
industry1	string	Yes	一级行业
industry2	string	Yes	二级行业
industry3	string	No	三级行业；传 all（或全部）表示全部三级行业
industry4	string	No	四级行业；填写前必须填写明确的三级行业
rowLimit	int	No	返回条数，默认 50000，取值须 > 0 且 ≤ 50000
pvMin	int	No	PV 下限，非负整数
pvMax	int	No	PV 上限，非负整数
costMin	double	No	消费下限，非负金额
costMax	double	No	消费上限，非负金额
clickMin	int	No	点击下限，非负整数
clickMax	int	No	点击上限，非负整数
viewMin	int	No	展现下限，非负整数
viewMax	int	No	展现上限，非负整数
conversionMin	int	No	转化下限，非负整数

指标参数出现即生效：不传该参数则不参与过滤。同一参数区间的下限不得大于上限。

请求示例

curl -X POST \ 
--header 'apiKey:APIKEY' \ 
--header 'accessToken:ACCESSTOKEN' \ 
--data 'startDate=2026-10-01&endDate=2026-10-07&industry1=IT产品&industry2=实用工具&pvMin=100&costMin=10.5&rowLimit=1000' \ 
'https://api.e.360.cn/dianjing/report/queryReportByIndustry'

返回结果

{
  "data": [
    {
      "click": 341,
      "conversion": 0,
      "cost": "537.94",
      "industry1": "IT产品",
      "industry2": "实用工具",
      "industry3": "系统工具",
      "industry4": "",
      "pv": 19237,
      "queryKeyword": "新版本",
      "view": 16486
    }
  ],
  "totalCount": 1,
  "truncated": false
}

返回结果说明

字段	类型	描述
data	array	行业报表数据行列表，每行为行业报表数据，字段以上游返回为准
totalCount	int	本次返回的记录数
truncated	bool	结果是否被截断（true 表示因 rowLimit 限制未返回全部）

响应头 resultCode 为结果码，成功为 10000，失败为对应错误码。

失败返回结果示例

{
  "failures": [
    {
      "code": 90201,
      "description": "_param.startDate",
      "message": "开始日期最早为当前自然日前30天"
    }
  ]
}

参数校验规则

参数	规则	错误提示
startDate / endDate	不能为空	开始日期不能为空 / 结束日期不能为空
	格式必须为 yyyy-MM-dd	日期格式必须为yyyy-MM-dd
	开始日期最早为当前自然日前 30 天	开始日期最早为当前自然日前30天
	不能为未来日期	开始日期不能是未来日期 / 结束日期不能是未来日期
	结束日期不能早于开始日期	结束日期不能早于开始日期
	起止跨度不超过 7 天	起止日期跨度不能超过7天
industry1 / industry2	不能为空	参数不能为空
industry4	填写时 industry3 必须为明确行业（不能为空或 all）	填写四级行业之前需要填写准确三级行业
指标区间	非负整数 / 合法金额	参数必须为非负整数 / 参数必须为合法金额
	下限不能大于上限	下限不能大于上限
rowLimit	> 0 且 ≤ 50000	填写值必须大于0且不大于50000

错误码

错误码	含义	说明
10000	成功	请求成功
90201	参数错误	参数校验失败，description 指明具体参数，message 为原因
90001	未知错误	系统异常或上游返回异常
限流错误码	超出频率限制	请求频率超过限制，message 含当前 QPS
配额错误码	配额超限	账户配额已超限

注意事项

时间范围：开始日期最早为当前自然日前 30 天，且单次查询的起止跨度不得超过 7 天。
行业层级：industry1、industry2 必填；industry3 可选，传 all/全部表示全部三级行业；industry4 必须在明确三级行业的前提下才可填写。
指标过滤：所有指标区间参数均为可选，传了才生效；同一区间的下限不得大于上限。
返回条数：rowLimit 默认 50000，最大 50000；当结果被截断时 truncated 返回 true。

results matching ""

No results matching ""