POSTPublicenterprise-search-bid-v4

Bidding Information Search V4_Recommended

Documentation

API Introduction

This API provides multi-dimensional bidding and tendering data retrieval services. Via POST requests, developers can query full lifecycle information such as tender announcements, winning bid notices, and contract acceptance, based on conditions like keywords, publication time, project region (province/city code), procurement method, and announcement type. It supports both precise and fuzzy search modes, meeting enterprises' data needs for business opportunity discovery and competitor monitoring.

Use Cases

Business Opportunity Discovery: Sales teams can identify potential tender projects in real-time based on industry keywords and regions.
Competitor Analysis: Monitor specific companies' winning bid records and participating projects to analyze market share.
Supply Chain Risk Control: Query suppliers' historical bidding and performance records to assist with qualification reviews.
Market Intelligence: Compile procurement trends and capital flows in specific industries to support decision-making.

Request and Response Description

Core Request Parameters:

keyword (Required): Search keyword, length must be greater than 2 characters, avoid using overly broad terms.
searchMode (Required): 1 for precise search, 2 for fuzzy search.
publishStartTime / publishEndTime: Time range format is yyyy-mm-dd, the interval must not exceed one year.
announcementType: Differentiates between tender announcements (1) or tender results (2).
projectRegionProvinceCode / projectRegionCityCode: Use standard administrative division codes to filter by region.
pageSize / pageIndex: Pagination parameters, maximum 10 entries per page.

Response Result: Returns a list of matching bidding and tendering data, including key fields such as project name, number, procuring entity, winning bid amount, and publication time (specific fields are subject to the actual response).

Integration Suggestions

Keyword Optimization: It is recommended to combine 'entity name + project type' for queries to improve accuracy.
Time Window Control: Due to the large volume of data, it is recommended to limit the time span to within 3-6 months to avoid single request timeouts.
Caching Strategy: For historical data queries that do not require extremely high real-time performance, it is recommended to establish short-term caching on the business side to reduce API call frequency.
Error Handling: Please properly handle parameter validation errors caused by keywords being too short or time intervals exceeding limits.

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "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-中标企业。 如传..."
}

Response Example

{}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
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

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
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;

Bidding Information Search V4_Recommended

Documentation

API Introduction

Use Cases

Request and Response Description

Integration Suggestions

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online