One-Click Search: Tender Announcements & Contract Award Data

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 .

Procurement & Bidding Information API - Tenders, Awards & Projects | Toolkk

Shell 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());
    }
}

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

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

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;

Bidding Information Search V3_Discontinued

Documentation

Integration Examples