enterprise-search-bid-list
Bidding Information Search V3_Discontinued
Historical Weather Search
Usage Cost
15 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/enterprise-search-bid-listcURL Example
curl --request POST \
--url 'https://openapi.toolkk.com/v1/enterprise-search-bid-list' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "keyword": "关键词(标题,采购人,供应商) 字符长度大于2,部分通用查询关键词做限制,如上海、科技等。",\n "pageSize": "每页条数(默认10条,最大10条)",\n "pageIndex": "当前页数(默认第1页)",\n "publishStartTime": "发布开始时间(yyyy-mm-dd格式:如2023-01-01),开始、结束时间间隔不能超过一年",\n "publishEndTime": "发布结束时间(yyyy-mm-dd格式:如2023-01-01),开始、结束时间间隔不能超过一年",\n "province": "省份地区,BJ:北京,TJ:天津,HB:河北,SX:山西,NMG:内蒙古,LN:辽宁,JL:吉林,HLJ:黑龙江,SH:上海,JS:江苏,ZJ:浙江,AH:安徽...",\n "searchType": "1-标题 2-采购人 3-供应商。默认全部,多个按逗号分隔,如1,2",\n "type": "1-招标公告 2-中标结果 3-拟建项目"\n}'Python Example
import os
import requests
url = "https://openapi.toolkk.com/v1/enterprise-search-bid-list"
payload = {
"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-拟建项目"
}
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())Go Example
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/enterprise-search-bid-list"
payload := []byte("{\n \"keyword\": \"关键词(标题,采购人,供应商) 字符长度大于2,部分通用查询关键词做限制,如上海、科技等。\",\n \"pageSize\": \"每页条数(默认10条,最大10条)\",\n \"pageIndex\": \"当前页数(默认第1页)\",\n \"publishStartTime\": \"发布开始时间(yyyy-mm-dd格式:如2023-01-01),开始、结束时间间隔不能超过一年\",\n \"publishEndTime\": \"发布结束时间(yyyy-mm-dd格式:如2023-01-01),开始、结束时间间隔不能超过一年\",\n \"province\": \"省份地区,BJ:北京,TJ:天津,HB:河北,SX:山西,NMG:内蒙古,LN:辽宁,JL:吉林,HLJ:黑龙江,SH:上海,JS:江苏,ZJ:浙江,AH:安徽...\",\n \"searchType\": \"1-标题 2-采购人 3-供应商。默认全部,多个按逗号分隔,如1,2\",\n \"type\": \"1-招标公告 2-中标结果 3-拟建项目\"\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))
}Java Example
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 \"pageSize\": \"每页条数(默认10条,最大10条)\",\n \"pageIndex\": \"当前页数(默认第1页)\",\n \"publishStartTime\": \"发布开始时间(yyyy-mm-dd格式:如2023-01-01),开始、结束时间间隔不能超过一年\",\n \"publishEndTime\": \"发布结束时间(yyyy-mm-dd格式:如2023-01-01),开始、结束时间间隔不能超过一年\",\n \"province\": \"省份地区,BJ:北京,TJ:天津,HB:河北,SX:山西,NMG:内蒙古,LN:辽宁,JL:吉林,HLJ:黑龙江,SH:上海,JS:江苏,ZJ:浙江,AH:安徽...\",\n \"searchType\": \"1-标题 2-采购人 3-供应商。默认全部,多个按逗号分隔,如1,2\",\n \"type\": \"1-招标公告 2-中标结果 3-拟建项目\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/enterprise-search-bid-list"))
.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 Example
<?php
$endpoint = 'https://openapi.toolkk.com/v1/enterprise-search-bid-list';
$payload = "{\n \"keyword\": \"关键词(标题,采购人,供应商) 字符长度大于2,部分通用查询关键词做限制,如上海、科技等。\",\n \"pageSize\": \"每页条数(默认10条,最大10条)\",\n \"pageIndex\": \"当前页数(默认第1页)\",\n \"publishStartTime\": \"发布开始时间(yyyy-mm-dd格式:如2023-01-01),开始、结束时间间隔不能超过一年\",\n \"publishEndTime\": \"发布结束时间(yyyy-mm-dd格式:如2023-01-01),开始、结束时间间隔不能超过一年\",\n \"province\": \"省份地区,BJ:北京,TJ:天津,HB:河北,SX:山西,NMG:内蒙古,LN:辽宁,JL:吉林,HLJ:黑龙江,SH:上海,JS:江苏,ZJ:浙江,AH:安徽...\",\n \"searchType\": \"1-标题 2-采购人 3-供应商。默认全部,多个按逗号分隔,如1,2\",\n \"type\": \"1-招标公告 2-中标结果 3-拟建项目\"\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;Response Example
{}Examples illustrate the response structure. Actual results depend on the API response.
- Authentication
- Send X-API-Key in request headers
- Rate limit
- 60 req/min
- Timeout
- 5000 ms
Send your API Key in the X-API-Key header from your backend.
Check both HTTP status and business fields before treating a call as successful.
Use retries and backoff together with rate limits in high-frequency scenarios.
Request Fields
Send requests from your server with the key in the X-API-Key header.
Request Fields
Fields are read from the API schema. Missing descriptions and examples are marked as unspecified.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| keyword | string | Yes | 关键词(标题,采购人,供应商) 字符长度大于2,部分通用查询关键词做限制,如上海、科技等。 | Unspecified |
| pageSize | string | No | 每页条数(默认10条,最大10条) | Unspecified |
| pageIndex | string | No | 当前页数(默认第1页) | Unspecified |
| publishStartTime | string | No | 发布开始时间(yyyy-mm-dd格式:如2023-01-01),开始、结束时间间隔不能超过一年 | Unspecified |
| publishEndTime | string | No | 发布结束时间(yyyy-mm-dd格式:如2023-01-01),开始、结束时间间隔不能超过一年 | Unspecified |
| province | string | No | 省份地区,BJ:北京,TJ:天津,HB:河北,SX:山西,NMG:内蒙古,LN:辽宁,JL:吉林,HLJ:黑龙江,SH:上海,JS:江苏,ZJ:浙江,AH:安徽,FJ:福建,JX:江西,SD:山东,HEN:河南,HUB:湖北,HUN:湖南,GD:广东,GX:广西,HAIN:海南,CQ:重庆,SC:四川,GZ:贵州,YN:云南,XZ:西藏,SAX:陕西,GS:甘肃,QH:青海,NX:宁夏,XJ:新疆 | Unspecified |
| searchType | string | No | 1-标题 2-采购人 3-供应商。默认全部,多个按逗号分隔,如1,2 | Unspecified |
| type | string | No | 1-招标公告 2-中标结果 3-拟建项目 | Unspecified |
Request Example
{
"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-拟建项目"
}- Authentication
- Send X-API-Key in request headers
- Rate limit
- 60 req/min
- Timeout
- 5000 ms
Response Fields
Examples illustrate the response structure. Actual results depend on the API response.
No field definitions yet. Refer to the JSON examples and documentation.
Response Example
{}API overview
Capabilities, use cases, limitations, and frequently asked questions.
API Introduction
This API provides bidding and tendering data retrieval services, supporting queries for tender announcements, winning bid results, and proposed projects. Users can perform precise filtering based on conditions such as keywords (title, procurer, or supplier), province/region, and publication time range, to obtain structured bidding and tendering list information.
Use Cases
- Sales Lead Generation: Discover potential procurement needs by monitoring tender announcements in specific industries.
- Competitor Analysis: Track competitors' winning bid records to analyze their market positioning and customer base.
- Market Research: Count the number of proposed projects in specific regions or sectors to assess market activity.
- Enterprise Risk Control: Verify partners' historical bidding and winning bid status to assist with credit evaluation.
Request and Response Description
Request Method: POST Core Parameters:
keyword(Required): Search keyword, supports title, procurer, or supplier name, length must be greater than 2 characters.