POSTPublicenterprise-search-bid-list

Bidding Information Search V3_Discontinued

Historical Weather Search

Usage Cost

15 coins/call

Try it online

Fire a real request right from your browser, no code required

Documentation

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.
type: Filter type, 1 for tender announcements, 2 for winning bid results, 3 for proposed projects.
searchType: Specifies search fields, 1-title, 2-procurer, 3-supplier, can be combined.
province: Limits by province, use standard abbreviations (e.g., BJ for Beijing, SH for Shanghai).
publishStartTime / publishEndTime: Publication start and end time, format yyyy-mm-dd, interval not exceeding one year.
pageIndex / pageSize: Pagination control, maximum 10 entries per page.

Response Result: Returns a list of bidding and tendering projects that meet the filtering conditions, including basic project information.

Integration Suggestions

Keyword Optimization: Avoid using overly broad generic terms like 'Shanghai' or 'Technology'; it is recommended to use specific project names or full company names to improve accuracy.
Time Range Limit: The time span for a single query cannot exceed one year. If you need to query older historical data, please make multiple requests in segments.
Pagination Handling: The default is 10 entries per page. It is recommended to set pagination logic reasonably based on business needs to avoid frequent full data retrieval.
Status Note: This API version is marked as being under maintenance and no longer updated. Before integration, please confirm the current service availability and future upgrade plans.

Integration Examples

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

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-拟建项目"
}

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.pageSize	object	{...}
properties.pageSize.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-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}'

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())

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)) }

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 $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;

Bidding Information Search V3_Discontinued

Try it online

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