接入文档
接口简介
本接口提供招投标数据的检索服务,支持查询招标公告、中标结果及拟建项目。用户可通过关键词(标题、采购人或供应商)、省份地区、发布时间范围等条件进行精准筛选,获取结构化的招投标列表信息。
适用场景
- 销售线索挖掘:通过监测特定行业的招标公告,发现潜在采购需求。
- 竞品分析:追踪竞争对手的中标记录,分析其市场布局与客户群体。
- 市场调研:统计特定区域或领域的拟建项目数量,评估市场热度。
- 企业风控:核查合作伙伴的历史投标与中标情况,辅助信用评估。
请求与返回说明
请求方式:POST 核心参数:
keyword(必填):搜索关键词,支持标题、采购人或供应商名称,长度需大于2字符。type:筛选类型,1为招标公告,2为中标结果,3为拟建项目。searchType:指定搜索字段,1-标题,2-采购人,3-供应商,可组合使用。province:限定省份,使用标准缩写(如BJ代表北京,SH代表上海)。publishStartTime/publishEndTime:发布起止时间,格式yyyy-mm-dd,间隔不超过一年。pageIndex/pageSize:分页控制,每页最大10条。
返回结果:返回符合筛选条件的招投标项目列表,包含项目基本信息。
接入建议
- 关键词优化:避免使用“上海”、“科技”等过于宽泛的通用词,建议使用具体项目名称或公司全称以提高准确率。
- 时间范围限制:单次查询的时间跨度不能超过一年,若需查询更久历史数据,请分段多次请求。
- 分页处理:默认每页10条,建议结合业务需求合理设置分页逻辑,避免频繁全量拉取。
- 状态注意:本接口版本标记为停更维护中,接入前请确认当前服务的可用性及后续升级计划。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"keyword": "关键词(标题,采购人,供应商) 字符长度大于2,部分通用查询关键词做限制,如上海、科技等。",
"pageSize": "每页条数(默认10条,最大10条)",
"pageIndex": "当前页数(默认第1页)",
"publishStartTime": "发布开始时间(yyyy-mm-dd格式:如2023-01-01),开始、结束时间间隔不能超过一年",
"publishEndTime": "发布结束时间(yyyy-mm-dd格式:如2023-01-01),开始、结束时间间隔不能超过一年",
"province": "省份地区,BJ:北京,TJ:天津,HB:河北,SX:山西,NMG:内蒙古,LN:辽宁,JL:吉林,HLJ:黑龙江,SH:上海,JS:江苏,ZJ:浙江,AH:安徽...",
"searchType": "1-标题 2-采购人 3-供应商。默认全部,多个按逗号分隔,如1,2",
"type": "1-招标公告 2-中标结果 3-拟建项目"
}响应示例
{}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.keyword | object | {...} |
| properties.keyword.type | string | string |
| properties.keyword.description | string | 关键词(标题,采购人,供应商) 字符长度大于2,部分通用查询关键词做限制,如上海、科技等。 |
| properties.pageSize | object | {...} |
| properties.pageSize.type | string | string |
响应字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |