招投标信息搜索

基本信息

接口地址

https://api.qixin.com/APIService/operation/getBiddingListBySearch

数据格式

JSON

请求方式

GET

请求示例

https://api.qixin.com/APIService/operation/getBiddingListBySearch?keyword=小米

描述

招投标信息搜索，包括招投标ID、标题，招标单位、中标单位、以及其他与招投标项目相关的其他角色列表等

请求参数 (Headers)

参数名	类型	必填	描述
`Auth-Version`	String	是	2.0（参数值），固定传入：2.0
`appkey`	String	是	启信慧眼数据开放平台获取，获取方式：个人中心-安全中心-API 密钥，获取appkey的同时，请完成IP白名单的配置：个人中心-安全中心-API IP白名单设置，如未配置，接口调试会报错“104 未添加IP白名单”
`timestamp`	String	是	UNIX时间戳，精确到毫秒，示例：1656921036000，当前系统时间近10分钟有效
`sign`	String	是	请求认证签名，对appkey+timestamp+secret_key进行md5或者sha256摘要计算的结果，小写字符串（实际加密不带入‘+’）

请求参数 (Query)

参数名	类型	必填	描述
`keyword`	String	是	搜索关键词
`search_scope`	String	否	搜索范围（默认全部），入参值参照附件枚举
`notice_type`	String	否	标讯类型（默认全部），入参值参照枚举
`start_date`	String	否	发布起始日期，格式为YYYY-MM-DD
`end_date`	String	否	发布截至时间，格式为YYYY-MM-DD
`district_code`	String	否	省份地区代码（默认全部），入参值参照枚举
`project_type`	String	否	项目分类（默认全部），入参值参照枚举
`budget_amt_from`	String	否	预算金额下限
`budget_amt_to`	String	否	预算金额上限
`bid_amt_from`	String	否	中标金额下限
`bid_amt_to`	String	否	中标金额上限
`skip`	String	否	跳过条目数（skip默认为0，最大490，每页条数为 10）

响应参数

参数名	类型	长度	描述
`status` data.status	String	10	返回结果状态
`message` data.message	String	255	返回结果消息
`sign` data.sign	String	32	数据签名
`data` data.data	Object	0	返回查询结果，如果没有匹配记录则返回空。具体字段含义见下表
`total` data.data.total	Number	10	返回列表中记录总数
`items` data.data.items	Array	0	数据列表
`title` data.data.items.title	String	255	标题
`id` data.data.items.id	String	20	招投标详情ID
`notice_type` data.data.items.notice_type	String	10	标讯类型
`date` data.data.items.date	String	20	发布日期
`district` data.data.items.district	String	31	省份地区
`project_type` data.data.items.project_type	String	10	项目类型
`budget_amt` data.data.items.budget_amt	String	50	预算金额，单位万
`bid_amt` data.data.items.bid_amt	String	6000	中标金额，单位万
`tender` data.data.items.tender	Array	0	招标单位列表
`name` data.data.items.tender.name	String	255	招标机构名称
`eid` data.data.items.tender.eid	String	36	企业 id
`contacts` data.data.items.tender.contacts	Array	0	联系人
`phones` data.data.items.tender.phones	Array	0	联系手机号
`address` data.data.items.tender.address	Array	0	联系地址
`email` data.data.items.tender.email	Array	0	邮箱
`agency` data.data.items.agency	Array	0	代理单位列表
`name` data.data.items.agency.name	String	255	代理机构名称
`eid` data.data.items.agency.eid	String	36	企业 id
`contacts` data.data.items.agency.contacts	Array	0	联系人
`phones` data.data.items.agency.phones	Array	0	联系手机号
`address` data.data.items.agency.address	Array	0	联系地址
`email` data.data.items.agency.email	Array	0	邮箱
`winner` data.data.items.winner	Array	0	中标单位列表
`name` data.data.items.winner.name	String	255	中标机构名称
`eid` data.data.items.winner.eid	String	36	企业 id
`project_bid_money` data.data.items.winner.project_bid_money	String	0	中标金额
`contacts` data.data.items.winner.contacts	Array	0	联系人
`phones` data.data.items.winner.phones	Array	0	联系手机号
`address` data.data.items.winner.address	Array	0	联系地址
`email` data.data.items.winner.email	Array	0	邮箱
`num` data.data.num	Number	10	当前返回列表的总条数

响应示例

JSON

{
    "status": "200",
    "message": "操作成功",
    "sign": "d943ce89d20683a7fafa2c1ed7732cd0",
    "data": {
        "total": 65914,
        "num": 10,
        "items": [
            {
                "id": "64f8a74db6806fedc6706a50",
                "title": "攸县人民检察院关于毛豆的网上超市采购项目成交公告4",
                "notice_type": "中标-中标",
                "date": "2023-09-07",
                "district": "430223",
                "project_type": "科教文卫",
                "budget_amt": "-",
                "bid_amt": 0.0216,
                "tender": [
                    {
                        "contacts": [],
                        "phones": [],
                        "address": [
                            "攸县东城新区"
                        ],
                        "email": [],
                        "name": "攸县人民检察院",
                        "eid": "61a30826-f801-11ea-81b4-00163e0ca5c5"
                    }
                ],
                "agency": [],
                "winner": [
                    {
                        "contacts": [],
                        "phones": [],
                        "address": [
                            "湖南省株洲市攸县联星街道联星社区万利组5号"
                        ],
                        "email": [],
                        "name": "攸县建兵蔬菜专业合作社",
                        "project_bid_money": "0.0216万元",
                        "eid": "b5470f06-f79c-4854-b7ef-96b7e9d78036"
                    }
                ]
            },
            {
                "id": "64f9462b730ecd2e8765512d",
                "title": "郴州市北湖区工商业联合会关于指纹锁的网上超市采购项目成交公告",
                "notice_type": "中标-中标",
                "date": "2023-09-07",
                "district": "431002",
                "project_type": "科教文卫",
                "budget_amt": "-",
                "bid_amt": 0.174,
                "tender": [
                    {
                        "contacts": [],
                        "phones": [],
                        "address": [
                            "骆仙西路2号"
                        ],
                        "email": [],
                        "name": "郴州市北湖区工商业联合会",
                        "eid": "ee421b42-61bc-11ed-9f5d-7a41866e1fe6"
                    }
                ],
                "agency": [],
                "winner": [
                    {
                        "contacts": [],
                        "phones": [],
                        "address": [
                            "湖南省郴州市湖南省郴州市北湖区燕泉街道青年大道49号五岭新天地二期1栋12层15C08房"
                        ],
                        "email": [],
                        "name": "湖南晟利科技有限公司",
                        "project_bid_money": "0.174万元",
                        "eid": "84b440e6-31ff-4604-8101-77b44cdeae6b"
                    }
                ]
            },
            {
                "id": "64f95a45db9382965009b952",
                "title": "龙山县第一小学关于长卷卫生纸\/无芯卫生纸的网上超市采购项目成交公告1",
                "notice_type": "中标-中标",
                "date": "2023-09-07",
                "district": "433130",
                "project_type": "医疗卫生",
                "budget_amt": "-",
                "bid_amt": 0.14,
                "tender": [
                    {
                        "contacts": [],
                        "phones": [],
                        "address": [
                            "龙山县民安街道光明路19号"
                        ],
                        "email": [],
                        "name": "龙山县第一小学",
                        "eid": "c3dee438-f6d1-11e9-9cb1-00163e0d7703"
                    }
                ],
                "agency": [],
                "winner": [
                    {
                        "contacts": [],
                        "phones": [],
                        "address": [
                            "湖南省湘西土家族苗族自治州湖南省湘西土家族苗族自治州龙山县华塘街道办事处岳麓大道96号"
                        ],
                        "email": [],
                        "name": "龙山县品利商行",
                        "project_bid_money": "0.14万元",
                        "eid": "b548673f-d110-4d69-aed4-a87c41fca27f"
                    }
                ]
            },
            {
                "id": "64f91b663280938d373ce2a9",
                "title": "湖南科技学院关于青豆的网上超市采购项目成交公告",
                "notice_type": "中标-中标",
                "date": "2023-09-07",
                "district": "100000",
                "project_type": "科教文卫",
                "budget_amt": "-",
                "bid_amt": 0.026,
                "tender": [
                    {
                        "contacts": [],
                        "phones": [],
                        "address": [
                            "永州市零陵区杨梓塘路130号"
                        ],
                        "email": [],
                        "name": "湖南科技学院",
                        "eid": "078e0dea-63b6-11e8-b486-00163e104bc8"
                    }
                ],
                "agency": [],
                "winner": [
                    {
                        "contacts": [],
                        "phones": [],
                        "address": [
                            "湖南省永州市湖南省永州市零陵区接履桥街道办事处冶木塘村于禾塘组"
                        ],
                        "email": [],
                        "name": "湖南中天生态农业有限公司",
                        "project_bid_money": "0.026万元",
                        "eid": "df3ddfca-7050-4868-bf8d-68a3a61d2785"
                    }
                ]
            },
            {
                "id": "64f951947a8ee12928521f4a",
                "title": "武冈市迎春亭街道办事处关于其它纸的网上超市采购项目成交公告5",
                "notice_type": "中标-中标",
                "date": "2023-09-07",
                "district": "430581",
                "project_type": "科教文卫",
                "budget_amt": "-",
                "bid_amt": 0.18,
                "tender": [
                    {
                        "contacts": [],
                        "phones": [
                            "15774075319"
                        ],
                        "address": [
                            "武冈市迎春亭街道办事处"
                        ],
                        "email": [],
                        "name": "武冈市迎春亭街道办事处",
                        "eid": "24acf9da-1e6d-11eb-8a6b-00163e121416"
                    }
                ],
                "agency": [],
                "winner": [
                    {
                        "contacts": [],
                        "phones": [],
                        "address": [
                            "湖南省邵阳市湖南省武冈市迎春路108号"
                        ],
                        "email": [],
                        "name": "武冈市迎春亭办事处",
                        "project_bid_money": "0.18万元",
                        "eid": "-"
                    }
                ]
            },
            {
                "id": "64f93ed683528a28deeb6132",
                "title": "关于其他调味品的网上超市合同公告",
                "notice_type": "中标-中标",
                "date": "2023-09-07",
                "district": "100000",
                "project_type": "其他",
                "budget_amt": "-",
                "bid_amt": 0.014,
                "tender": [
                    {
                        "contacts": [
                            "李小昆"
                        ],
                        "phones": [
                            "13899763602"
                        ],
                        "address": [
                            "新疆伊宁市昭苏县七十六团团部"
                        ],
                        "email": [],
                        "name": "新疆生产建设兵团第四师七十六团人民武装部",
                        "eid": "-"
                    }
                ],
                "agency": [],
                "winner": [
                    {
                        "contacts": [],
                        "phones": [],
                        "address": [],
                        "email": [],
                        "name": "昭苏县七十六团小倪蔬菜店",
                        "project_bid_money": "0.014万元",
                        "eid": "4e2d8c73-cc08-461e-841a-8aa19f2514d1"
                    }
                ]
            },
            {
                "id": "64f961e9730ecd2e87655ef0",
                "title": "邵阳市双清区征地和房屋征收工作办公室关于其他葱蒜类的网上超市采购项目成交公告",
                "notice_type": "中标-中标",
                "date": "2023-09-07",
                "district": "430502",
                "project_type": "其他",
                "budget_amt": "-",
                "bid_amt": 0.0077,
                "tender": [
                    {
                        "contacts": [],
                        "phones": [],
                        "address": [
                            "麻子洼社区前进小学往里走团结亭附近双清区征收办2楼"
                        ],
                        "email": [],
                        "name": "邵阳市双清区征地和房屋征收工作办公室",
                        "eid": "6a1a74f7-eb82-4029-b42f-f255f01d1109"
                    }
                ],
                "agency": [],
                "winner": [
                    {
                        "contacts": [],
                        "phones": [],
                        "address": [
                            "湖南省邵阳市湖南省邵阳市双清区三眼井2号综合楼1层12号门面"
                        ],
                        "email": [],
                        "name": "邵阳市双清区乐源餐食配送服务中心",
                        "project_bid_money": "0.0077万元",
                        "eid": "84987186-a2e6-42ac-bb03-82b68c54e2dd"
                    }
                ]
            },
            {
                "id": "64f943bf730ecd2e87654fc0",
                "title": "江西省、中国科学院庐山植物园溪霞分园关于小米空气净化器Ultra分解式除甲醛空气净化器竞价采购",
                "notice_type": "招标-招标",
                "date": "2023-09-07",
                "district": "360100",
                "project_type": "房屋建筑",
                "budget_amt": "-",
                "bid_amt": "-",
                "tender": [
                    {
                        "contacts": [],
                        "phones": [],
                        "address": [],
                        "email": [],
                        "name": "江西省中国科学院庐山植物园",
                        "eid": "ce416935-e349-4094-bb29-aed5ab2f9759"
                    }
                ],
                "agency": [],
                "winner": []
            },
            {
                "id": "64f9453bd0ca7470aaf06faf",
                "title": "庐山市（庐山风景名胜区管理局）自然资源保护处关于断路器辅助1件的竞价采购",
                "notice_type": "招标-招标",
                "date": "2023-09-07",
                "district": "360483",
                "project_type": "服务采购",
                "budget_amt": "-",
                "bid_amt": "-",
                "tender": [
                    {
                        "name": "庐山风景名胜区管理局",
                        "eid": "-",
                        "contacts": [],
                        "phones": [],
                        "address": [],
                        "email": []
                    }
                ],
                "agency": [],
                "winner": []
            },
            {
                "id": "64f922dc730ecd2e87653ed7",
                "title": "关于盆的网上超市合同公告",
                "notice_type": "中标-中标",
                "date": "2023-09-07",
                "district": "450481",
                "project_type": "科教文卫",
                "budget_amt": "-",
                "bid_amt": 0.008,
                "tender": [
                    {
                        "contacts": [
                            "廖莉"
                        ],
                        "phones": [
                            "13517743625"
                        ],
                        "address": [
                            "岑溪市南渡镇南安街179号"
                        ],
                        "email": [],
                        "name": "岑溪市南渡中心卫生院",
                        "eid": "a44221e0-f167-11e9-b443-00163e0d7703"
                    }
                ],
                "agency": [],
                "winner": [
                    {
                        "contacts": [],
                        "phones": [],
                        "address": [],
                        "email": [],
                        "name": "广西亚冉智能科技有限公司",
                        "project_bid_money": "0.008万元",
                        "eid": "2b0364eb-9172-4809-b5b7-1fec6647b48a"
                    }
                ]
            }
        ]
    }
}

代码示例

javascript

let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');

let baseUrl = 'https://api.qixin.com/APIService/operation/getBiddingListBySearch';
let appkey = '正式appkey';
let secretKey = '正式secret_key';
let timeStamp = new Date().getTime();
const hash = crypto.createHash('md5');
let sign = hash.update(appkey + timeStamp + secretKey).digest('hex');

let urlParams = {
    keyword: 'keyword的值',
    search_scope: 'search_scope的值',
    notice_type: 'notice_type的值',
    start_date: 'start_date的值',
    end_date: 'end_date的值',
    district_code: 'district_code的值',
    project_type: 'project_type的值',
    budget_amt_from: 'budget_amt_from的值',
    budget_amt_to: 'budget_amt_to的值',
    bid_amt_from: 'bid_amt_from的值',
    bid_amt_to: 'bid_amt_to的值',
    skip: 'skip的值'
}

let concatParams = []
for (let key in urlParams) {
    concatParams.push(key + '=' + urlParams[key]);
}

let options = {
    'method': 'GET',
    'url': baseUrl + '?' + concatParams.join('&'),
    'headers': {
        'Connection': 'keep-alive',
        'Auth-version': '2.0',
        'appkey': appkey,
        'timestamp': timeStamp,
        'sign': sign
    }
};

request(options, function (error, response) {
    if (error) throw new Error(error);
    console.log(response.body);
});

java

import com.mashape.unirest.http.*;
import java.nio.charset.StandardCharsets;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.security.MessageDigest;
import java.util.Calendar;
import java.net.URLEncoder;

public class main {
    // 获取字符串的md5值
    public static String getMD5Str(String str) {
        byte[] digest = null;
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");
            md.update(str.getBytes(StandardCharsets.UTF_8));
            digest = md.digest();

            StringBuilder sb = new StringBuilder();
            for (byte b : digest) {
                String s = String.format("%02x", b);
                sb.append(s);
            }
            return sb.toString();
        } catch (Exception e) {
            e.printStackTrace();
        }

        return null;
    }

    public static void main(String[] args) throws Exception {
        String baseUrl = "https://api.qixin.com/APIService/operation/getBiddingListBySearch";
        String appkey = "正式appkey";
        String secretKey = "正式secret_key";
        Calendar calendar = Calendar.getInstance();
        Long timestamp = calendar.getTime().getTime();
        String sign = getMD5Str(appkey + timestamp + secretKey);

        // 设置url参数
        Map<String, String> urlParams = new HashMap<String, String>();
        urlParams.put("keyword", "keyword的值");
        urlParams.put("search_scope", "search_scope的值");
        urlParams.put("notice_type", "notice_type的值");
        urlParams.put("start_date", "start_date的值");
        urlParams.put("end_date", "end_date的值");
        urlParams.put("district_code", "district_code的值");
        urlParams.put("project_type", "project_type的值");
        urlParams.put("budget_amt_from", "budget_amt_from的值");
        urlParams.put("budget_amt_to", "budget_amt_to的值");
        urlParams.put("bid_amt_from", "bid_amt_from的值");
        urlParams.put("bid_amt_to", "bid_amt_to的值");
        urlParams.put("skip", "skip的值");

        List<String> concatParams = new ArrayList<String>();
        for (String s : urlParams.keySet()) {
            concatParams.add(s + "=" + URLEncoder.encode(urlParams.get(s), StandardCharsets.UTF_8));
        }

        Unirest.setTimeouts(0, 2000);
        try {
            // 发送get请求，得到响应
            HttpResponse<String> response = Unirest.get(baseUrl + "?" + String.join("&", concatParams))
                    .header("Auth-version", "2.0")
                    .header("appkey", appkey)
                    .header("timestamp", timestamp + "")
                    .header("sign", sign)
                    .header("Content-Type", "application/json")
                    .asString();

            System.out.println(response.getBody());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

csharp

using System;
using System.Net.Http;
using System.Collections.Generic;
using System.Text;
using System.Text.Encodings.Web;
using System.Security.Cryptography;

namespace csharp
{
    class Program
    {
        public static string GetMD5Str(string str)
        {
            MD5 md5 = MD5.Create();
            byte[] buffer = Encoding.Default.GetBytes(str);
            byte[] MD5Buffer = md5.ComputeHash(buffer);

            //将字节数组转换成字符串
            string strResult = "";
            for (int i = 0; i < MD5Buffer.Length; i++)
            {
                strResult += MD5Buffer[i].ToString("x2");
            }

            return strResult;
        }

        static void Main(string[] args)
        {
            var baseUrl = "https://api.qixin.com/APIService/operation/getBiddingListBySearch";
            var appkey = "正式appkey";
            var secretKey = "正式secret_key";
            TimeSpan ts = DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, 0);
            var timeStamp = Convert.ToInt64(ts.TotalMilliseconds).ToString();  // 当前utc时间戳
            var sign = GetMD5Str(appkey + timeStamp + secretKey);              // 请求签名  

            // 设置url参数
            Dictionary<string, string> urlParams = new Dictionary<string, string>();
            urlParams.Add("keyword", "keyword的值");,
    urlParams.Add("search_scope", "search_scope的值");,
    urlParams.Add("notice_type", "notice_type的值");,
    urlParams.Add("start_date", "start_date的值");,
    urlParams.Add("end_date", "end_date的值");,
    urlParams.Add("district_code", "district_code的值");,
    urlParams.Add("project_type", "project_type的值");,
    urlParams.Add("budget_amt_from", "budget_amt_from的值");,
    urlParams.Add("budget_amt_to", "budget_amt_to的值");,
    urlParams.Add("bid_amt_from", "bid_amt_from的值");,
    urlParams.Add("bid_amt_to", "bid_amt_to的值");,
    urlParams.Add("skip", "skip的值");

            UrlEncoder ins = UrlEncoder.Create();
            List<string> concatParams = new List<string>();
            foreach (KeyValuePair<string, string> param in urlParams)
            {
                concatParams.Add(param.Key + "=" + ins.Encode(param.Value));
            }

            // 发送GET请求
            HttpClient httpClient = new HttpClient();
            httpClient.DefaultRequestHeaders.Add("Auth-version", "2.0");
            httpClient.DefaultRequestHeaders.Add("appkey", appkey);
            httpClient.DefaultRequestHeaders.Add("timestamp", timeStamp);
            httpClient.DefaultRequestHeaders.Add("sign", sign);
            httpClient.DefaultRequestHeaders.Add("Connection", "keep-alive");
            var urlWithParams = baseUrl + "?" + string.Join("&", concatParams.ToArray());
            var get = httpClient.GetAsync(urlWithParams);

            // 输出响应
            Console.WriteLine(get.Result.Content.ReadAsStringAsync().Result);
        }
    }
}

python

# -*- coding:utf-8 -*-

import requests
import json
import time
import hashlib
from urllib.parse import urlencode


def md5Encode(srcStr):
    '''计算字符串的md5值'''
    m = hashlib.md5()
    m.update(srcStr.encode('utf-8'))
    return m.hexdigest()


# 接口信息
baseUrl = 'https://api.qixin.com/APIService/operation/getBiddingListBySearch'
appkey = '正式appkey'
secretKey = '正式secret_key'
timeStamp = int(time.time()) * 1000

# 设置请求头部信息
headers = {
    'Auth-version': '2.0',              # 指定接口验证版本
    'appkey': appkey,
    'timestamp': str(timeStamp),
    'sign': md5Encode(appkey + str(timeStamp) + secretKey),
    'Connection': 'keep-alive'
}

# 请求参数
urlParams = {
    'keyword': 'keyword的值',
    'search_scope': 'search_scope的值',
    'notice_type': 'notice_type的值',
    'start_date': 'start_date的值',
    'end_date': 'end_date的值',
    'district_code': 'district_code的值',
    'project_type': 'project_type的值',
    'budget_amt_from': 'budget_amt_from的值',
    'budget_amt_to': 'budget_amt_to的值',
    'bid_amt_from': 'bid_amt_from的值',
    'bid_amt_to': 'bid_amt_to的值',
    'skip': 'skip的值'
}

# 构造url
url = '{}?{}'.format(baseUrl, urlencode(urlParams))
print(url)

# 调用接口
response = requests.get(url, headers=headers)

# 处理响应数据
jsonContent = json.dumps(str(response.content, encoding='utf-8'))
rspResult = jsonContent.encode('utf-8').decode('unicode-escape')
print(rspResult)

文档下载

搜索查询 - 相关接口

企业模糊搜索 1.31 企业高级搜索 1.2 招投标信息搜索 21.92 商标信息搜索 19.91