县域商机情报 API 文档

县域商机情报 API 文档

API控制台返回主页

一、简介

县域商机情报 API 提供全国县域招标公告检索与中标企业电话查询能力，适用于商机挖掘、企业获客、行业研究等场景。

💡 数据接口每日更新，检索公告来自全国公共资源交易平台公开数据，中标企业电话为企业公开联系方式。

基础地址：https://dcbmt.com/county_api/
免费试用：注册即送 50 次/天调用额度
付费套餐：¥99/月 10000 次调用

二、认证方式

所有数据接口均需携带 API Key。两种传法任选其一：

方式一：请求头（推荐）

X-API-Key: ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

方式二：URL 参数

https://dcbmt.com/county_api/search?api_key=ck_xxx&county=郸城

⚠️ 请勿在公开代码仓库或分享的代码中暴露你的 API Key。Key 泄露后请到 API控制台重新生成。

三、接口列表

GET/county_api/search

公告检索（核心接口）：按县名 / 关键词 / 分类 / 时间范围检索招标公告，返回公告标题、日期、原文链接，并关联中标企业名称与电话。

请求参数

参数	必填	说明
`api_key`	是*	API Key（也可用 X-API-Key 头）
`county`	否	县名，如：郸城、鹿邑
`q`	否	标题关键词，如：招标、采购
`cat`	否	公告分类，如：建设工程、政府采购
`days`	否	最近 N 天，如 days=30 表示最近30天
`page`	否	页码，默认 1
`size`	否	每页条数，默认 20，最大 50

* county / q / cat / days 至少提供一项。

返回示例

{
  "page": 1,
  "size": 20,
  "total": 893,
  "items": [
    {
      "id": 12345,
      "title": "郸城县某某工程招标公告",
      "category": "建设工程",
      "date": "2026-08-27",
      "url": "http://ggzy.example.com/...",
      "region": "周口市·郸城县",
      "winners": [
        {"n": "某某建筑有限公司", "t": "13800000000"}
      ]
    }
  ]
}

GET/county_api/winner_tel

中标企业电话库：一次性返回全量中标企业 → 公告链接 → 企业名称+电话的映射数据（较大，约 5MB）。适合本地缓存后自行检索。

参数	必填	说明
`api_key`	是*	API Key（也可用 X-API-Key 头）

返回结构

{
  "http://ggzy.example.com/xxx": [
    {"n": "企业名称", "t": "联系电话"}
  ]
}

GET/county_api/data

基础数据：获取当前统计摘要（公告总量、按县分布等），不消耗 API 套餐配额，但受 IP 限流（120次/分钟）。

四、调用示例

cURL

# 检索郸城县最近30天招标公告（带中标企业电话）
curl "https://dcbmt.com/county_api/search?county=%E9%83%B8%E5%9F%8E&days=30&page=1&size=20" \
  -H "X-API-Key: ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Python

import requests

API_KEY = "ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
url = "https://dcbmt.com/county_api/search"
params = {"county": "郸城", "q": "招标", "page": 1, "size": 20}
headers = {"X-API-Key": API_KEY}

r = requests.get(url, params=params, headers=headers)
data = r.json()
print("共", data["total"], "条")
for it in data["items"]:
    print(it["title"], "→", it.get("winners"))

JavaScript (fetch)

fetch("https://dcbmt.com/county_api/search?county=郸城&days=30", {
  headers: {"X-API-Key": "ck_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}
})
  .then(r => r.json())
  .then(data => console.log("共", data.total, "条", data.items));

五、配额说明

版本	价格	额度	有效期
免费版	¥0	50 次/天	永久
API 月套餐	¥99	10000 次/月	30 天

超额后返回 429，购买套餐后自动恢复。可在 API控制台实时查看用量。

六、错误码

HTTP	说明
400	参数错误（缺少筛选条件、参数格式不正确）
401	API Key 无效或未启用
429	超过配额或请求过于频繁
500	服务器内部错误

所有错误响应均为 JSON 格式：{"error": "错误描述"}

七、使用建议

批量获取：先用 winner_tel 拉全量电话库做本地缓存，再用 search 增量检索，节省配额。
定时任务：建议每天定时调用一次 search?days=1 获取当日新增公告。
合规声明：数据来自公开渠道，仅限合法用途，请勿用于骚扰、诈骗等违法场景。

八、联系我们

遇到问题或需要定制数据？QQ：576245096（商业合作）

购买套餐后如有异常，凭订单号联系处理。