Bidding Information Search V4_Recommended
Bidding Information Search V4_Recommended
20 coins/call
We use cookies.This website uses essential cookies to operate core features. With your consent, we also use analytics cookies to understand traffic and improve the service. For more details, see our .
Bidding Information Search V4_Recommended
20 coins/call
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.
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).
Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.
{
"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-中标企业。 如传..."
}{}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 |
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))
}| string |
| properties.searchMode.description | string | 搜索模式,1-精准搜索、2-模糊搜索 |
| properties.pageSize | object | {...} |
| properties.pageSize.type | string | string |
| properties.pageSize.description | string | 每页条数(默认10条,最大10条) |
| properties.pageIndex | object | {...} |
| properties.pageIndex.type | string | string |
| properties.pageIndex.description | string | 当前页数(默认第1页) |
| properties.publishStartTime | object | {...} |
| properties.publishStartTime.type | string | string |
| properties.publishStartTime.description | string | 发布开始时间(yyyy-mm-dd格式:如2023-01-01),开始、结束时间间隔不能超过一年 |
| properties.publishEndTime | object | {...} |
| properties.publishEndTime.type | string | string |
| properties.publishEndTime.description | string | 发布结束时间(yyyy-mm-dd格式:如2023-02-01),开始、结束时间间隔不能超过一年 |
| properties.announcementType | object | {...} |
| properties.announcementType.type | string | string |
| properties.announcementType.description | string | 招投标公告类型(默认不限制,单选): 1-招标公告(预告、招标、澄清补遗、变更); 2-招标结果(开标、中标成交、澄清答疑、变更、候选公示、废标流标终止、合同、验收) |
| properties.targetItemType | object | {...} |
| properties.targetItemType.type | string | string |
| properties.targetItemType.description | string | 招投标阶段(默认不限制,可以多选,通过英文逗号分隔): 1-预告(招标公告); 2-变更(招标公告); 3-澄清补遗(招标公告); 4-招标(招标公告); 5-变更(招标结果); 6-候选公示(招标结果); 7-中标成交(招标结果); 8-澄清答疑(招标结果); 9-合同(招标结果); 10-验收(招标结果); 11-废标流标终止(招标结果); 12-开标(招标结果) |
| properties.procurementMethod | object | {...} |
| properties.procurementMethod.type | string | string |
| properties.procurementMethod.description | string | 采购方式(默认不限制,单选): 1-单一来源; 2-框架协议; 3-邀请招标; 4-询价采购; 5-竞争性谈判; 6-竞争性磋商; 7-竞价; 8-公开招标 |
| properties.projectRegionProvinceCode | object | {...} |
| properties.projectRegionProvinceCode.type | string | string |
| properties.projectRegionProvinceCode.description | string | 项目区域-省份:使用行政区划代码 |
| properties.projectRegionCityCode | object | {...} |
| properties.projectRegionCityCode.type | string | string |
| properties.projectRegionCityCode.description | string | 项目区域-城市:使用行政区划代码 |
| properties.searchType | object | {...} |
| properties.searchType.type | string | string |
| properties.searchType.description | string | 查找范围(默认不限制,可以多选,通过英文逗号分隔),支持如下维度的筛选: 1-标题;2-项目编号;3-采购单位;4-代理机构;5-候选企业;6-中标企业。 如传参不在以上范围内,按照默认维度返回 |
| required | array | "keyword" |
| required[] | string | keyword |
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;