icon

合同信息搜索

tender-contractPOST
POSThttps://v1.apizero.cn/api/tender-contract
获取 API Key工作台购买 / 调试

概述

按时间、关键词、地区、行业、合同期限、金额搜索合同公告，不是招标/中标列表。 怎么用： 1）控制台复制 API Key； 2）POST https://v1.apizero.cn/api/tender-contract ，JSON 传参； 3）请求头写 Authorization: Bearer 你的Key。 成功时 data 保留业务字段，并多 fetched_at、api。品牌与调用地址为极数本源。 pageNumber 最大 100。searchType 默认 1。

调用约定

  • 网关 · https://v1.apizero.cn
  • 鉴权 · Authorization: Bearer <API Key>
  • 回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。
/aidocs/tender-contract/raw.md
打开 Markdown

鉴权

必须带 API Key。无匿名、无登录免费、无会员日免、无试用次数。按 0.085 元/次计费。套餐按各档标价，不随按次价变动。

获取 API Key

请求头

Authorizationstring必填

必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。

按时间检索

POSTJSON / FORM / QUERY·APPLICATION/JSON

搜合同公告，不是招标/中标列表。必须带 API Key。成功时 data 保留全部业务字段，并多 fetched_at、api。

https://v1.apizero.cn/api/tender-contract?startDate=2026-09-01+00%3A00%3A00&endDate=2026-09-10+23%3A59%3A59&pageId=1&pageNumber=20

startDatestring必填

发布开始时间，yyyy-MM-dd 或带时分秒

例2026-09-01 00:00:00

endDatestring必填

发布结束时间

例2026-09-10 23:59:59

pageIdint选填

页码，默认 1

例1

pageNumberint选填

每页条数，最大 50；0 只返回总数

例20

{
  "startDate": "2026-09-01 00:00:00",
  "endDate": "2026-09-10 23:59:59",
  "pageId": "1",
  "pageNumber": "20"
}

返回结果

codeinteger

接口响应状态码（200=成功）

msgstring

解析响应信息

subCodestring

业务侧 code（0000000000=成功）

subMsgstring

业务侧 msg

dataobject
costTimestring

搜索耗费时长（单位：毫秒），null表示未统计

totalinteger

符合条件的搜索结果总数

pageIdinteger

当前页码（与请求参数一致）

pageNumberinteger

每页记录数（与请求参数一致）

startDatestring

实际搜索开始时间（格式：YYYY-MM-DD HH:mm:ss）

endDatestring

实际搜索结束时间（格式：YYYY-MM-DD HH:mm:ss）

hasNextboolean

是否还有下一页：true=有，false=无

seKeyWordsstring

UI标红用的关键词（匹配搜索关键词）

dataarray

搜索结果数据集合（数组形式，按dataSetType返回对应结构）

idinteger

信息ID

titlestring

信息标题（含HTML高亮标签，用于关键词标红）

publishTimestring

发布时间（格式：YYYY-MM-DD HH:mm:ss）

contentstring

内容（含HTML高亮标签）

proviceCodestring

省代码

cityCodestring

市代码

countyCodestring

区/县代码（null表示无）

hasFileinteger

是否有附件：0=无，1=有

projectMoneystring

项目金额（带单位，如”16.8万”）

projectClassIDstring

项目子分类ID-新版

purchaseTypeIDstring

采购类别ID

industryCodeListarray

行业分类code数组

data.data[].industryCodeList[]string

data.data[].industryCodeList 的一项

projectCyclearray

项目周期，有多个标段时，可能会有多个项目周期，一般一个值

data.data[].projectCycle[]string

data.data[].projectCycle 的一项

partAInfoarray

甲方(公司)信息集合

namestring

名称

contactPhonearray

contactPhone

data.data[].partAInfo[].contactPhone[]string

data.data[].partAInfo[].contactPhone 的一项

emailarray

email

data.data[].partAInfo[].email[]string

data.data[].partAInfo[].email 的一项

partBInfoarray

乙方(公司)信息集合

namestring

名称

contactPhonearray

contactPhone

data.data[].partBInfo[].contactPhone[]string

data.data[].partBInfo[].contactPhone 的一项

emailstring

email

contractStartDatestring

合同开始时间（格式：YYYY-MM-DD）

contractEndDatestring

合同到期时间（格式：YYYY-MM-DD）

fetched_atstring

本次查询时间

apistring

本接口 id

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "data": {
      "costTime": null,
      "total": 29,
      "pageId": 1,
      "pageNumber": 1,
      "startDate": "2025-07-20 23:00:00",
      "endDate": "2025-07-25 23:59:59",
      "hasNext": true,
      "data": [
        {
          "id": 275985695,
          "title": "云南农业职业技术学院新农电商直播实训室及茭菱校区体育训练区改造<span style='color:red;'>工程</span>项目合同",
          "publishTime": "2025-07-25 23:21:51",
          "content": "五、合同主体 采购人（甲方）: 云南农<span style='color:red;'>业</span><span style='color:red;'>职业</span><span style='color:red;'>技术学院</span>,25 九、其他补充事宜: 附件: 云南农<span style='color:red;'>业</span><span style='color:red;'>职业</span><span style='color:red;'>技术学院</span>新农电商直播实训室及茭菱校区体育训练区改造<span style='color:red;'>工程</span>项目合同",
          "proviceCode": "530000",
          "cityCode": "530100",
          "countyCode": null,
          "hasFile": 1,
          "score": 38.91352,
          "projectMoney": "54.68万",
          "projectClassID": "3",
          "purchaseTypeID": "2",
          "industryCodeList": [
            "E501",
            "I649",
            "R882"
          ],
          "projectCycle": [
            "30天"
          ],
          "partAInfo": [
            {
              "name": "云南农业职业技术学院",
              "contactPhone": [
                "0871-68875284"
              ],
              "email": []
            }
          ],
          "partBInfo": [
            {
              "name": "金狐建筑装饰工程有限公司",
              "contactPhone": [
                "15125247808"
              ],
              "email": null
            }
          ],
          "contractStartDate": "2025-07-25",
          "contractEndDate": "2025-08-25"
        }
      ],
      "seKeyWords": "工程,空调"
    },
    "msg": "ok",
    "count": 0,
    "returnValue": null,
    "returnvalue": null,
    "subCode": "0000000000",
    "subMsg": "成功",
    "code": 200,
    "fetched_at": "2026-09-20T08:50:00+08:00",
    "api": "tender-contract"
  },
  "tips": "极数本源 · https://apizero.cn"
}

关键词检索

POSTJSON / FORM / QUERY·APPLICATION/JSON

时间范围 + 关键词。必须带 API Key。成功时 data 保留全部业务字段，并多 fetched_at、api。

https://v1.apizero.cn/api/tender-contract?startDate=2026-09-01+00%3A00%3A00&endDate=2026-09-10+23%3A59%3A59&pageId=1&pageNumber=20&keyword=%E5%B7%A5%E7%A8%8B%7C%E7%A9%BA%E8%B0%83&excludeKW=%E4%B8%AD%E6%A0%87%E5%80%99%E9%80%89%E4%BA%BA&inCludeKW=%E9%87%87%E8%B4%AD&searchType=3&searchMode=1

startDatestring必填

发布开始时间，yyyy-MM-dd 或带时分秒

例2026-09-01 00:00:00

endDatestring必填

发布结束时间

例2026-09-10 23:59:59

pageIdint选填

页码，默认 1

例1

pageNumberint选填

每页条数，最大 50；0 只返回总数

例20

keyword（关键词）string选填

关键词：空格/逗号=同时出现，竖线=或，最长 300

例工程|空调

excludeKWstring选填

排除词，竖线分隔，总长不超过 150

例中标候选人

inCludeKWstring选填

结果必含词，不要与 keyword 重复，总长不超过 150

例采购

searchTypeint选填

1 智能模糊 / 2 精准 / 3 高级，默认 3

例3

searchModeint选填

1 标题+正文 / 2 仅标题 / 3 仅正文，默认 1

例1

{
  "startDate": "2026-09-01 00:00:00",
  "endDate": "2026-09-10 23:59:59",
  "pageId": "1",
  "pageNumber": "20",
  "keyword": "工程|空调",
  "excludeKW": "中标候选人",
  "inCludeKW": "采购",
  "searchType": "3",
  "searchMode": "1"
}

返回结果

codeinteger

接口响应状态码（200=成功）

msgstring

解析响应信息

subCodestring

业务侧 code（0000000000=成功）

subMsgstring

业务侧 msg

dataobject
costTimestring

搜索耗费时长（单位：毫秒），null表示未统计

totalinteger

符合条件的搜索结果总数

pageIdinteger

当前页码（与请求参数一致）

pageNumberinteger

每页记录数（与请求参数一致）

startDatestring

实际搜索开始时间（格式：YYYY-MM-DD HH:mm:ss）

endDatestring

实际搜索结束时间（格式：YYYY-MM-DD HH:mm:ss）

hasNextboolean

是否还有下一页：true=有，false=无

seKeyWordsstring

UI标红用的关键词（匹配搜索关键词）

dataarray

搜索结果数据集合（数组形式，按dataSetType返回对应结构）

idinteger

信息ID

titlestring

信息标题（含HTML高亮标签，用于关键词标红）

publishTimestring

发布时间（格式：YYYY-MM-DD HH:mm:ss）

contentstring

内容（含HTML高亮标签）

proviceCodestring

省代码

cityCodestring

市代码

countyCodestring

区/县代码（null表示无）

hasFileinteger

是否有附件：0=无，1=有

projectMoneystring

项目金额（带单位，如”16.8万”）

projectClassIDstring

项目子分类ID-新版

purchaseTypeIDstring

采购类别ID

industryCodeListarray

行业分类code数组

data.data[].industryCodeList[]string

data.data[].industryCodeList 的一项

projectCyclearray

项目周期，有多个标段时，可能会有多个项目周期，一般一个值

data.data[].projectCycle[]string

data.data[].projectCycle 的一项

partAInfoarray

甲方(公司)信息集合

namestring

名称

contactPhonearray

contactPhone

data.data[].partAInfo[].contactPhone[]string

data.data[].partAInfo[].contactPhone 的一项

emailarray

email

data.data[].partAInfo[].email[]string

data.data[].partAInfo[].email 的一项

partBInfoarray

乙方(公司)信息集合

namestring

名称

contactPhonearray

contactPhone

data.data[].partBInfo[].contactPhone[]string

data.data[].partBInfo[].contactPhone 的一项

emailstring

email

contractStartDatestring

合同开始时间（格式：YYYY-MM-DD）

contractEndDatestring

合同到期时间（格式：YYYY-MM-DD）

fetched_atstring

本次查询时间

apistring

本接口 id

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "data": {
      "costTime": null,
      "total": 29,
      "pageId": 1,
      "pageNumber": 1,
      "startDate": "2025-07-20 23:00:00",
      "endDate": "2025-07-25 23:59:59",
      "hasNext": true,
      "data": [
        {
          "id": 275985695,
          "title": "云南农业职业技术学院新农电商直播实训室及茭菱校区体育训练区改造<span style='color:red;'>工程</span>项目合同",
          "publishTime": "2025-07-25 23:21:51",
          "content": "五、合同主体 采购人（甲方）: 云南农<span style='color:red;'>业</span><span style='color:red;'>职业</span><span style='color:red;'>技术学院</span>,25 九、其他补充事宜: 附件: 云南农<span style='color:red;'>业</span><span style='color:red;'>职业</span><span style='color:red;'>技术学院</span>新农电商直播实训室及茭菱校区体育训练区改造<span style='color:red;'>工程</span>项目合同",
          "proviceCode": "530000",
          "cityCode": "530100",
          "countyCode": null,
          "hasFile": 1,
          "score": 38.91352,
          "projectMoney": "54.68万",
          "projectClassID": "3",
          "purchaseTypeID": "2",
          "industryCodeList": [
            "E501",
            "I649",
            "R882"
          ],
          "projectCycle": [
            "30天"
          ],
          "partAInfo": [
            {
              "name": "云南农业职业技术学院",
              "contactPhone": [
                "0871-68875284"
              ],
              "email": []
            }
          ],
          "partBInfo": [
            {
              "name": "金狐建筑装饰工程有限公司",
              "contactPhone": [
                "15125247808"
              ],
              "email": null
            }
          ],
          "contractStartDate": "2025-07-25",
          "contractEndDate": "2025-08-25"
        }
      ],
      "seKeyWords": "工程,空调"
    },
    "msg": "ok",
    "count": 0,
    "returnValue": null,
    "returnvalue": null,
    "subCode": "0000000000",
    "subMsg": "成功",
    "code": 200,
    "fetched_at": "2026-09-20T08:50:00+08:00",
    "api": "tender-contract"
  },
  "tips": "极数本源 · https://apizero.cn"
}

全部条件

POSTJSON / FORM / QUERY·APPLICATION/JSON

时间、关键词、地区、企业、金额、合同期限可一起传。pageNumber 最大 100。必须带 API Key。成功时 data 保留全部业务字段，并多 fetched_at、api。

https://v1.apizero.cn/api/tender-contract?startDate=2026-09-01+00%3A00%3A00&endDate=2026-09-10+23%3A59%3A59&pageId=1&pageNumber=20&keyword=%E5%B7%A5%E7%A8%8B%7C%E7%A9%BA%E8%B0%83&excludeKW=%E4%B8%AD%E6%A0%87%E5%80%99%E9%80%89%E4%BA%BA&inCludeKW=%E9%87%87%E8%B4%AD&searchType=3&searchMode=1&areaCode=%7B%22proviceCodeList%22%3A%5B%220%22%5D%7D&companyName=%E7%A4%BA%E4%BE%8B%E5%BB%BA%E8%AE%BE%E9%9B%86%E5%9B%A2&projectMoneyMin=100000&projectMoneyMax=5000000&industryCode=%7B%22firstCodeList%22%3A%5B%22Q%22%5D%7D&purchaseTypeID=-100&fileFlag=-1&contractEndMin=2026-01-01&contractEndMax=2026-12-31

startDatestring必填

发布开始时间，yyyy-MM-dd 或带时分秒

例2026-09-01 00:00:00

endDatestring必填

发布结束时间

例2026-09-10 23:59:59

pageIdint选填

页码，默认 1

例1

pageNumberint选填

每页条数，最大 100；0 只返回总数

例20

keyword（关键词）string选填

关键词：空格/逗号=同时出现，竖线=或，最长 300

例工程|空调

excludeKWstring选填

排除词，竖线分隔，总长不超过 150

例中标候选人

inCludeKWstring选填

结果必含词，不要与 keyword 重复，总长不超过 150

例采购

searchTypeint选填

1 智能模糊 / 2 精准 / 3 高级，默认 3

例3

searchModeint选填

1 标题+正文 / 2 仅标题 / 3 仅正文，默认 1

例1

areaCodeobject选填

地区编码，省市区 6 位；省传 ["0"] 为全国

例{"proviceCodeList":["0"]}

companyNamestring选填

企业名（角色不限），逗号分隔

例示例建设集团

projectMoneyMinstring选填

金额下限，元；不传不限

例100000

projectMoneyMaxstring选填

金额上限，元

例5000000

industryCodeobject选填

甲方行业。firstCodeList / secondCodeList / thirdCodeList

例{"firstCodeList":["Q"]}

purchaseTypeIDstring选填

采购分类：-100=全部；1=服务，2=工程，3=货物；多个逗号分隔

例-100

partANamestring选填

甲方名称，模糊搜，多个逗号分隔

partBNamestring选填

乙方名称，模糊搜，多个逗号分隔

agentNamestring选填

代理机构名称，模糊搜，多个逗号分隔

fileFlagint选填

附件：-1=不限，0=无附件，1=有附件

例-1

contractEndMinstring选填

合同截止日期下限，yyyy-MM-dd

例2026-01-01

contractEndMaxstring选填

合同截止日期上限，yyyy-MM-dd

例2026-12-31

{
  "startDate": "2026-09-01 00:00:00",
  "endDate": "2026-09-10 23:59:59",
  "pageId": "1",
  "pageNumber": "20",
  "keyword": "工程|空调",
  "excludeKW": "中标候选人",
  "inCludeKW": "采购",
  "searchType": "3",
  "searchMode": "1",
  "areaCode": "{\"proviceCodeList\":[\"0\"]}",
  "companyName": "示例建设集团",
  "projectMoneyMin": "100000",
  "projectMoneyMax": "5000000",
  "industryCode": "{\"firstCodeList\":[\"Q\"]}",
  "purchaseTypeID": "-100",
  "fileFlag": "-1",
  "contractEndMin": "2026-01-01",
  "contractEndMax": "2026-12-31"
}

返回结果

codeinteger

接口响应状态码（200=成功）

msgstring

解析响应信息

subCodestring

业务侧 code（0000000000=成功）

subMsgstring

业务侧 msg

dataobject
costTimestring

搜索耗费时长（单位：毫秒），null表示未统计

totalinteger

符合条件的搜索结果总数

pageIdinteger

当前页码（与请求参数一致）

pageNumberinteger

每页记录数（与请求参数一致）

startDatestring

实际搜索开始时间（格式：YYYY-MM-DD HH:mm:ss）

endDatestring

实际搜索结束时间（格式：YYYY-MM-DD HH:mm:ss）

hasNextboolean

是否还有下一页：true=有，false=无

seKeyWordsstring

UI标红用的关键词（匹配搜索关键词）

dataarray

搜索结果数据集合（数组形式，按dataSetType返回对应结构）

idinteger

信息ID

titlestring

信息标题（含HTML高亮标签，用于关键词标红）

publishTimestring

发布时间（格式：YYYY-MM-DD HH:mm:ss）

contentstring

内容（含HTML高亮标签）

proviceCodestring

省代码

cityCodestring

市代码

countyCodestring

区/县代码（null表示无）

hasFileinteger

是否有附件：0=无，1=有

projectMoneystring

项目金额（带单位，如”16.8万”）

projectClassIDstring

项目子分类ID-新版

purchaseTypeIDstring

采购类别ID

industryCodeListarray

行业分类code数组

data.data[].industryCodeList[]string

data.data[].industryCodeList 的一项

projectCyclearray

项目周期，有多个标段时，可能会有多个项目周期，一般一个值

data.data[].projectCycle[]string

data.data[].projectCycle 的一项

partAInfoarray

甲方(公司)信息集合

namestring

名称

contactPhonearray

contactPhone

data.data[].partAInfo[].contactPhone[]string

data.data[].partAInfo[].contactPhone 的一项

emailarray

email

data.data[].partAInfo[].email[]string

data.data[].partAInfo[].email 的一项

partBInfoarray

乙方(公司)信息集合

namestring

名称

contactPhonearray

contactPhone

data.data[].partBInfo[].contactPhone[]string

data.data[].partBInfo[].contactPhone 的一项

emailstring

email

contractStartDatestring

合同开始时间（格式：YYYY-MM-DD）

contractEndDatestring

合同到期时间（格式：YYYY-MM-DD）

fetched_atstring

本次查询时间

apistring

本接口 id

tipsstring

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

{
  "code": 0,
  "msg": "成功",
  "data": {
    "data": {
      "costTime": null,
      "total": 29,
      "pageId": 1,
      "pageNumber": 1,
      "startDate": "2025-07-20 23:00:00",
      "endDate": "2025-07-25 23:59:59",
      "hasNext": true,
      "data": [
        {
          "id": 275985695,
          "title": "云南农业职业技术学院新农电商直播实训室及茭菱校区体育训练区改造<span style='color:red;'>工程</span>项目合同",
          "publishTime": "2025-07-25 23:21:51",
          "content": "五、合同主体 采购人（甲方）: 云南农<span style='color:red;'>业</span><span style='color:red;'>职业</span><span style='color:red;'>技术学院</span>,25 九、其他补充事宜: 附件: 云南农<span style='color:red;'>业</span><span style='color:red;'>职业</span><span style='color:red;'>技术学院</span>新农电商直播实训室及茭菱校区体育训练区改造<span style='color:red;'>工程</span>项目合同",
          "proviceCode": "530000",
          "cityCode": "530100",
          "countyCode": null,
          "hasFile": 1,
          "score": 38.91352,
          "projectMoney": "54.68万",
          "projectClassID": "3",
          "purchaseTypeID": "2",
          "industryCodeList": [
            "E501",
            "I649",
            "R882"
          ],
          "projectCycle": [
            "30天"
          ],
          "partAInfo": [
            {
              "name": "云南农业职业技术学院",
              "contactPhone": [
                "0871-68875284"
              ],
              "email": []
            }
          ],
          "partBInfo": [
            {
              "name": "金狐建筑装饰工程有限公司",
              "contactPhone": [
                "15125247808"
              ],
              "email": null
            }
          ],
          "contractStartDate": "2025-07-25",
          "contractEndDate": "2025-08-25"
        }
      ],
      "seKeyWords": "工程,空调"
    },
    "msg": "ok",
    "count": 0,
    "returnValue": null,
    "returnvalue": null,
    "subCode": "0000000000",
    "subMsg": "成功",
    "code": 200,
    "fetched_at": "2026-09-20T08:50:00+08:00",
    "api": "tender-contract"
  },
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。

curl -sS -X POST "https://v1.apizero.cn/api/tender-contract" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "startDate": "2026-09-01 00:00:00",
  "endDate": "2026-09-10 23:59:59",
  "pageId": "1",
  "pageNumber": "20",
  "searchType": "1",
  "keyword": "工程|空调",
  "searchMode": "1",
  "areaCode": "{\"proviceCodeList\":[\"0\"]}",
  "industryCode": "{\"firstCodeList\":[\"Q\"]}",
  "purchaseTypeID": "-100",
  "fileFlag": "-1"
}'

错误码

先看业务 code。HTTP 也可能不是 200。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快（QPS）

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

调用限制

计费模式
按次付费 · 点数包 · 月套餐
QPS 限制
QPS 2
登录免费额度
无
匿名每日额度
无
黄金会员
本档不提供 VIP 额度 · QPS 10
钻石会员
本档不提供 VIP 额度 · QPS 30
企业会员
本档不提供 VIP 额度 · QPS 120

购买套餐、看评价请走商城详情。 购买 / 调试

更新日志

  • 1.0.02026-09-20

    上架，必须 Key，无免费额度，按次 0.08 元；可购月卡 / 年卡

免责声明

返回内容以当时查询结果为准，仅供开发与信息检索。附件链接可能过期。品牌与调用地址为极数本源。