POST已开放enterprise-search-bid-v4

招投标信息查询V4_推荐

接入文档

接口简介

本接口提供多维度的招投标数据检索服务。通过 POST 请求，开发者可依据关键词、发布时间、项目区域（省市代码）、采购方式及公告类型等条件，查询招标公告、中标公示、合同验收等全生命周期信息。支持精准与模糊两种搜索模式，满足企业对商机挖掘与竞品监控的数据需求。

适用场景

商机挖掘：销售团队根据行业关键词与地域，实时发现潜在招标项目。
竞品分析：监控特定企业的中标记录与参与项目，分析市场占有率。
供应链风控：查询供应商的历史投标与履约情况，辅助资质审核。
市场情报：统计特定行业的采购趋势与资金流向，支持决策制定。

请求与返回说明

核心入参：

keyword（必填）：搜索关键词，长度需大于2字符，避免使用过于宽泛的词汇。
searchMode（必填）：1为精准搜索，2为模糊搜索。
publishStartTime / publishEndTime：时间范围格式为 yyyy-mm-dd，间隔不得超过一年。
announcementType：区分招标公告（1）或招标结果（2）。
projectRegionProvinceCode / projectRegionCityCode：使用标准行政区划代码筛选地域。
pageSize / pageIndex：分页参数，每页最大10条。

返回结果： 返回匹配的招投标列表数据，包含项目名称、编号、采购单位、中标金额、发布时间等关键字段（具体字段以实际响应为准）。

接入建议

关键词优化：建议结合“单位名称+项目类型”组合查询，以提高精准度。
时间窗口控制：由于数据量庞大，建议将时间跨度控制在3-6个月内，避免单次请求超时。
缓存策略：对于非实时性要求极高的历史数据查询，建议在业务侧建立短期缓存，减少API调用频次。
错误处理：请妥善处理因关键词过短或时间间隔超限导致的参数校验错误。

接入示例代码

提供 Shell、Python、Go、Java、PHP 等常见接入示例，便于直接接到现有项目里。

请求示例

{
  "keyword": "关键词，字符长度大于2，部分通用查询关键词做限制，如上海、科技等。",
  "searchMode": "搜索模式，1-精准搜索、2-模糊搜索",
  "pageSize": "每页条数（默认10条，最大10条）",
  "pageIndex": "当前页数（默认第1页）",
  "publishStartTime": "发布开始时间（yyyy-mm-dd格式：如2023-01-01），开始、结束时间间隔不能超过一年",
  "publishEndTime": "发布结束时间（yyyy-mm-dd格式：如2023-02-01），开始、结束时间间隔不能超过一年",
  "announcementType": "招投标公告类型（默认不限制，单选）： 1-招标公告（预告、招标、澄清补遗、变更）； 2-招标结果（开标、中标成交、澄清答疑、变更、候选公示、废标流标终止、合同、...",
  "targetItemType": "招投标阶段(默认不限制，可以多选，通过英文逗号分隔)： 1-预告（招标公告）； 2-变更（招标公告）； 3-澄清补遗（招标公告）； 4-招标（招标公告）； 5-...",
  "procurementMethod": "采购方式（默认不限制，单选）： 1-单一来源； 2-框架协议； 3-邀请招标； 4-询价采购； 5-竞争性谈判； 6-竞争性磋商； 7-竞价； 8-公开招标",
  "projectRegionProvinceCode": "项目区域-省份：使用行政区划代码",
  "projectRegionCityCode": "项目区域-城市：使用行政区划代码",
  "searchType": "查找范围（默认不限制，可以多选，通过英文逗号分隔），支持如下维度的筛选： 1-标题；2-项目编号；3-采购单位；4-代理机构；5-候选企业；6-中标企业。 如传..."
}

响应示例

{}

请求字段

以下字段根据示例 JSON 自动提取，仅作接入参考。

字段路径	类型	示例值
type	string	object
properties	object	{...}
properties.keyword	object	{...}
properties.keyword.type	string	string
properties.keyword.description	string	关键词，字符长度大于2，部分通用查询关键词做限制，如上海、科技等。
properties.searchMode	object	{...}
properties.searchMode.type	string	string

响应字段

以下字段根据示例 JSON 自动提取，仅作接入参考。

字段路径	类型	示例值
type	string	object

curl --request POST \ --url 'https://openapi.toolkk.com/v1/enterprise-search-bid-v4' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "keyword": "关键词，字符长度大于2，部分通用查询关键词做限制，如上海、科技等。",\n "searchMode": "搜索模式，1-精准搜索、2-模糊搜索",\n "pageSize": "每页条数（默认10条，最大10条）",\n "pageIndex": "当前页数（默认第1页）",\n "publishStartTime": "发布开始时间（yyyy-mm-dd格式：如2023-01-01），开始、结束时间间隔不能超过一年",\n "publishEndTime": "发布结束时间（yyyy-mm-dd格式：如2023-02-01），开始、结束时间间隔不能超过一年",\n "announcementType": "招投标公告类型（默认不限制，单选）： 1-招标公告（预告、招标、澄清补遗、变更）； 2-招标结果（开标、中标成交、澄清答疑、变更、候选公示、废标流标终止、合同、...",\n "targetItemType": "招投标阶段(默认不限制，可以多选，通过英文逗号分隔)： 1-预告（招标公告）； 2-变更（招标公告）； 3-澄清补遗（招标公告）； 4-招标（招标公告）； 5-...",\n "procurementMethod": "采购方式（默认不限制，单选）： 1-单一来源； 2-框架协议； 3-邀请招标； 4-询价采购； 5-竞争性谈判； 6-竞争性磋商； 7-竞价； 8-公开招标",\n "projectRegionProvinceCode": "项目区域-省份：使用行政区划代码",\n "projectRegionCityCode": "项目区域-城市：使用行政区划代码",\n "searchType": "查找范围（默认不限制，可以多选，通过英文逗号分隔），支持如下维度的筛选： 1-标题；2-项目编号；3-采购单位；4-代理机构；5-候选企业；6-中标企业。如传..."\n}'

import os import requests url = "https://openapi.toolkk.com/v1/enterprise-search-bid-v4" payload = { "keyword": "关键词，字符长度大于2，部分通用查询关键词做限制，如上海、科技等。", "searchMode": "搜索模式，1-精准搜索、2-模糊搜索", "pageSize": "每页条数（默认10条，最大10条）", "pageIndex": "当前页数（默认第1页）", "publishStartTime": "发布开始时间（yyyy-mm-dd格式：如2023-01-01），开始、结束时间间隔不能超过一年", "publishEndTime": "发布结束时间（yyyy-mm-dd格式：如2023-02-01），开始、结束时间间隔不能超过一年", "announcementType": "招投标公告类型（默认不限制，单选）： 1-招标公告（预告、招标、澄清补遗、变更）； 2-招标结果（开标、中标成交、澄清答疑、变更、候选公示、废标流标终止、合同、...", "targetItemType": "招投标阶段(默认不限制，可以多选，通过英文逗号分隔)： 1-预告（招标公告）； 2-变更（招标公告）； 3-澄清补遗（招标公告）； 4-招标（招标公告）； 5-...", "procurementMethod": "采购方式（默认不限制，单选）： 1-单一来源； 2-框架协议； 3-邀请招标； 4-询价采购； 5-竞争性谈判； 6-竞争性磋商； 7-竞价； 8-公开招标", "projectRegionProvinceCode": "项目区域-省份：使用行政区划代码", "projectRegionCityCode": "项目区域-城市：使用行政区划代码", "searchType": "查找范围（默认不限制，可以多选，通过英文逗号分隔），支持如下维度的筛选： 1-标题；2-项目编号；3-采购单位；4-代理机构；5-候选企业；6-中标企业。如传..." } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/enterprise-search-bid-v4" payload := []byte("{\n \"keyword\": \"关键词，字符长度大于2，部分通用查询关键词做限制，如上海、科技等。\",\n \"searchMode\": \"搜索模式，1-精准搜索、2-模糊搜索\",\n \"pageSize\": \"每页条数（默认10条，最大10条）\",\n \"pageIndex\": \"当前页数（默认第1页）\",\n \"publishStartTime\": \"发布开始时间（yyyy-mm-dd格式：如2023-01-01），开始、结束时间间隔不能超过一年\",\n \"publishEndTime\": \"发布结束时间（yyyy-mm-dd格式：如2023-02-01），开始、结束时间间隔不能超过一年\",\n \"announcementType\": \"招投标公告类型（默认不限制，单选）： 1-招标公告（预告、招标、澄清补遗、变更）； 2-招标结果（开标、中标成交、澄清答疑、变更、候选公示、废标流标终止、合同、...\",\n \"targetItemType\": \"招投标阶段(默认不限制，可以多选，通过英文逗号分隔)： 1-预告（招标公告）； 2-变更（招标公告）； 3-澄清补遗（招标公告）； 4-招标（招标公告）； 5-...\",\n \"procurementMethod\": \"采购方式（默认不限制，单选）： 1-单一来源； 2-框架协议； 3-邀请招标； 4-询价采购； 5-竞争性谈判； 6-竞争性磋商； 7-竞价； 8-公开招标\",\n \"projectRegionProvinceCode\": \"项目区域-省份：使用行政区划代码\",\n \"projectRegionCityCode\": \"项目区域-城市：使用行政区划代码\",\n \"searchType\": \"查找范围（默认不限制，可以多选，通过英文逗号分隔），支持如下维度的筛选： 1-标题；2-项目编号；3-采购单位；4-代理机构；5-候选企业；6-中标企业。如传...\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"keyword\": \"关键词，字符长度大于2，部分通用查询关键词做限制，如上海、科技等。\",\n \"searchMode\": \"搜索模式，1-精准搜索、2-模糊搜索\",\n \"pageSize\": \"每页条数（默认10条，最大10条）\",\n \"pageIndex\": \"当前页数（默认第1页）\",\n \"publishStartTime\": \"发布开始时间（yyyy-mm-dd格式：如2023-01-01），开始、结束时间间隔不能超过一年\",\n \"publishEndTime\": \"发布结束时间（yyyy-mm-dd格式：如2023-02-01），开始、结束时间间隔不能超过一年\",\n \"announcementType\": \"招投标公告类型（默认不限制，单选）： 1-招标公告（预告、招标、澄清补遗、变更）； 2-招标结果（开标、中标成交、澄清答疑、变更、候选公示、废标流标终止、合同、...\",\n \"targetItemType\": \"招投标阶段(默认不限制，可以多选，通过英文逗号分隔)： 1-预告（招标公告）； 2-变更（招标公告）； 3-澄清补遗（招标公告）； 4-招标（招标公告）； 5-...\",\n \"procurementMethod\": \"采购方式（默认不限制，单选）： 1-单一来源； 2-框架协议； 3-邀请招标； 4-询价采购； 5-竞争性谈判； 6-竞争性磋商； 7-竞价； 8-公开招标\",\n \"projectRegionProvinceCode\": \"项目区域-省份：使用行政区划代码\",\n \"projectRegionCityCode\": \"项目区域-城市：使用行政区划代码\",\n \"searchType\": \"查找范围（默认不限制，可以多选，通过英文逗号分隔），支持如下维度的筛选： 1-标题；2-项目编号；3-采购单位；4-代理机构；5-候选企业；6-中标企业。如传...\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/enterprise-search-bid-v4")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/enterprise-search-bid-v4'; $payload = "{\n \"keyword\": \"关键词，字符长度大于2，部分通用查询关键词做限制，如上海、科技等。\",\n \"searchMode\": \"搜索模式，1-精准搜索、2-模糊搜索\",\n \"pageSize\": \"每页条数（默认10条，最大10条）\",\n \"pageIndex\": \"当前页数（默认第1页）\",\n \"publishStartTime\": \"发布开始时间（yyyy-mm-dd格式：如2023-01-01），开始、结束时间间隔不能超过一年\",\n \"publishEndTime\": \"发布结束时间（yyyy-mm-dd格式：如2023-02-01），开始、结束时间间隔不能超过一年\",\n \"announcementType\": \"招投标公告类型（默认不限制，单选）： 1-招标公告（预告、招标、澄清补遗、变更）； 2-招标结果（开标、中标成交、澄清答疑、变更、候选公示、废标流标终止、合同、...\",\n \"targetItemType\": \"招投标阶段(默认不限制，可以多选，通过英文逗号分隔)： 1-预告（招标公告）； 2-变更（招标公告）； 3-澄清补遗（招标公告）； 4-招标（招标公告）； 5-...\",\n \"procurementMethod\": \"采购方式（默认不限制，单选）： 1-单一来源； 2-框架协议； 3-邀请招标； 4-询价采购； 5-竞争性谈判； 6-竞争性磋商； 7-竞价； 8-公开招标\",\n \"projectRegionProvinceCode\": \"项目区域-省份：使用行政区划代码\",\n \"projectRegionCityCode\": \"项目区域-城市：使用行政区划代码\",\n \"searchType\": \"查找范围（默认不限制，可以多选，通过英文逗号分隔），支持如下维度的筛选： 1-标题；2-项目编号；3-采购单位；4-代理机构；5-候选企业；6-中标企业。如传...\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

招投标信息查询V4_推荐

接入文档

接口简介

适用场景

请求与返回说明

接入建议

接入示例代码

请求示例

响应示例

请求字段

响应字段

Shell 示例

Python 示例

Go 示例

Java 示例

PHP 示例

在线调试