POST已開放enterprise-search-bid-v4

招投標資訊查詢V4_推薦

呼叫價格

20 匠幣/次

線上除錯

無需寫程式，瀏覽器中直接發起真實請求

接入文件

介面簡介

本介面提供多維度的招投標資料檢索服務。透過 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 示例