POST公開中enterprise-search-bid-v4

入札情報検索V4_おすすめ

導入ドキュメント

インターフェースの紹介

このインターフェースは、多次元の入札データ検索サービスを提供します。開発者は、POST リクエストを通じて、キーワード、リリース時期、プロジェクト地域 (県および市コード)、調達方法、発表の種類などの条件に基づいて、入札発表、落札発表、契約承諾などの完全なライフサイクル情報をクエリできます。正確な検索モードとあいまいな検索モードの両方をサポートし、ビジネスチャンスの発掘と競合製品の監視のための企業のデータニーズを満たします。

該当するシナリオ

ビジネス機会マイニング: 営業チームは、業界のキーワードと地域に基づいて潜在的な入札プロジェクトをリアルタイムで発見します。
競合製品分析: 特定企業の落札実績や参加プロジェクトを監視し、市場シェアを分析します。
サプライチェーンのリスク管理: サプライヤーの過去の入札とパフォーマンスの状況を調査し、資格審査を支援します。
マーケットインテリジェンス: 意思決定をサポートする、特定の業界における調達傾向と資本の流れに関する統計。

リクエストと返品の手順

コア入力パラメータ:

keyword (必須): 検索キーワード。長さは 2 文字以上にする必要があります。広すぎる単語の使用は避けてください。
searchMode (必須): 正確な検索の場合は 1、あいまい検索の場合は 2。
publishStartTime / publishEndTime: 時間範囲の形式は yyyy-mm-dd で、間隔は 1 年を超えることはできません。
paymentType: 入札公告 (1) または入札結果 (2) を区別します。
projectRegionProvinceCode / projectRegionCityCode: 標準の行政区画コードを使用して地域をフィルタリングします。
pageSize / pageIndex: ページングパラメータ、ページごとに最大 10 個。

返される結果: プロジェクト名、番号、購入単位、落札金額、リリース時刻などのキーフィールドを含む、一致する入札リストデータを返します (特定のフィールドは実際の応答の対象となります)。

提案へのアクセス

キーワードの最適化: 精度を向上させるために、クエリを「ユニット名 + プロジェクトタイプ」と組み合わせることが推奨されます。
時間枠の制御: データ量が膨大であるため、単一のリクエストのタイムアウトを避けるために、期間を 3 ～ 6 か月以内に制御することをお勧めします。
キャッシュ戦略: 非リアルタイム要件が非常に高い履歴データクエリの場合は、ビジネス側で短期キャッシュを確立して API 呼び出しの頻度を減らすことをお勧めします。
エラー処理: キーワードが短すぎる、または時間間隔が長すぎることが原因で発生するパラメータ検証エラーを適切に処理してください。

実装サンプルコード

Shell、Python、Go、Java、PHP の呼び出し例をまとめ、既存プロジェクトに組み込みやすくしています。

リクエスト例

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

レスポンス例

{}

リクエスト項目

以下の項目はサンプル JSON から自動抽出した参考情報です。

パス	型	サンプル値
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	string

レスポンス項目

以下の項目はサンプル JSON から自動抽出した参考情報です。

パス	型	サンプル値
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;

入札情報検索V4_おすすめ

導入ドキュメント

インターフェースの紹介

該当するシナリオ

リクエストと返品の手順

提案へのアクセス

実装サンプルコード

リクエスト例

レスポンス例

リクエスト項目

レスポンス項目

Shell 例

Python 例

Go 例

Java 例

PHP 例

オンライン試用