社保信息 - API文档

基本信息

接口地址

https://api.qixin.com/APIService/reports/getSocialSecurityByName

数据格式

JSON

请求方式

GET

请求示例

https://api.qixin.com/APIService/reports/getSocialSecurityByName?keyword=唐山市丰南区众鑫铝业有限公司

描述

企业工商年报披露的社保信息

请求参数 (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	是	企业全名/注册号/统一社会信用代码

响应参数

参数名	类型	长度	描述
`data` data.data	Object	0	返回查询结果，如果没有匹配记录则返回为空。具体字段含义见下表
`total` data.data.total	Number	0	返回列表中记录总数
`items` data.data.items	Array	0	社保信息列表
`social_security` data.data.items.social_security	Array	0	单位参加社保信息
`unenployment_insurance` data.data.items.social_security.unenployment_insurance	String	255	单位参加失业保险缴费基数
`endownment_insurance_amount` data.data.items.social_security.endownment_insurance_amount	String	255	单位参加城镇职工基本养老保险累计欠缴金额
`actual_lost_amount` data.data.items.social_security.actual_lost_amount	String	255	参加失业保险本期实际缴费金额
`base_medical_down_balance` data.data.items.social_security.base_medical_down_balance	String	255	单位参加职工基本医疗保险累计欠缴金额
`unenployment_num` data.data.items.social_security.unenployment_num	String	255	失业保险人数
`endownment_base_amount` data.data.items.social_security.endownment_base_amount	String	255	单位参加城镇职工基本养老保险缴费基数
`injury_insurance_amount` data.data.items.social_security.injury_insurance_amount	String	255	单位参加工伤保险缴费基数
`insurance_num` data.data.items.social_security.insurance_num	String	255	职工基本医疗保险人数
`birth_amount` data.data.items.social_security.birth_amount	String	255	单位参加生育保险累计欠缴金额
`birth_insurance_count` data.data.items.social_security.birth_insurance_count	String	255	单位参加生育保险缴费基数
`actual_medical_amount` data.data.items.social_security.actual_medical_amount	String	255	参加职工基本医疗保险本期实际缴费金额
`actual_injury_amount` data.data.items.social_security.actual_injury_amount	String	255	参加工伤保险本期实际缴费金额
`company_injury_down_balance` data.data.items.social_security.company_injury_down_balance	String	255	单位参加工伤保险累计欠缴金额
`birth_num` data.data.items.social_security.birth_num	String	255	生育保险人数
`birth_actual_amount` data.data.items.social_security.birth_actual_amount	String	255	参加生育保险本期实际缴费金额
`basic_endownment_num` data.data.items.social_security.basic_endownment_num	String	255	城镇职工基本养老保险人数
`injury_insurance_num` data.data.items.social_security.injury_insurance_num	String	255	工伤保险人数
`unenployment_down_balance` data.data.items.social_security.unenployment_down_balance	String	255	单位参加失业保险累计欠缴金额
`actual_endownment_amount` data.data.items.social_security.actual_endownment_amount	String	255	参加城镇职工基本养老保险本期实际缴费金额
`basic_medical_amount` data.data.items.social_security.basic_medical_amount	String	255	单位参加职工基本医疗保险缴费基数
`name` data.data.items.name	String	255	企业名称
`report_year` data.data.items.report_year	String	255	年报年份
`report_date` data.data.items.report_date	String	255	发布日期
`dw_je_display` data.data.items.dw_je_display	String	255	是否展示欠缴金额
`bq_je_display` data.data.items.bq_je_display	String	255	是否展示实际缴费金额
`dw_js_display` data.data.items.dw_js_display	String	255	是否展示单位缴费基数
`sign` data.sign	String	32	数据签名
`status` data.status	String	10	返回结果状态
`message` data.message	String	255	返回结果消息

响应示例

JSON

{
    "status": "200",
    "message": "操作成功",
    "sign": "043d2cfb9ad743a492f27b52250886e2",
    "data": {
        "total": 11,
        "items": [
            {
                "report_year": "2023",
                "report_date": "2024-01-04",
                "name": "唐山市丰南区众鑫铝业有限公司",
                "social_security": {
                    "unenployment_insurance": "企业选择不公示",
                    "endownment_insurance_amount": "企业选择不公示",
                    "actual_lost_amount": "企业选择不公示",
                    "base_medical_down_balance": "企业选择不公示",
                    "unenployment_num": "0人",
                    "endownment_base_amount": "企业选择不公示",
                    "injury_insurance_amount": "企业选择不公示",
                    "insurance_num": "0人",
                    "birth_amount": "企业选择不公示",
                    "birth_insurance_count": "企业选择不公示",
                    "actual_medical_amount": "企业选择不公示",
                    "actual_injury_amount": "企业选择不公示",
                    "company_injury_down_balance": "企业选择不公示",
                    "birth_num": "0人",
                    "birth_actual_amount": "企业选择不公示",
                    "basic_endownment_num": "0人",
                    "injury_insurance_num": "0人",
                    "unenployment_down_balance": "企业选择不公示",
                    "actual_endownment_amount": "企业选择不公示",
                    "basic_medical_amount": "企业选择不公示"
                },
                "dw_je_display": "企业选择不公示",
                "bq_je_display": "企业选择不公示",
                "dw_js_display": "企业选择不公示"
            },
            {
                "report_year": "2022",
                "report_date": "2023-03-02",
                "name": "唐山市丰南区众鑫铝业有限公司",
                "social_security": {
                    "unenployment_insurance": "企业选择不公示",
                    "endownment_insurance_amount": "企业选择不公示",
                    "actual_lost_amount": "企业选择不公示",
                    "base_medical_down_balance": "企业选择不公示",
                    "unenployment_num": "0人",
                    "endownment_base_amount": "企业选择不公示",
                    "injury_insurance_amount": "企业选择不公示",
                    "insurance_num": "0人",
                    "birth_amount": "企业选择不公示",
                    "birth_insurance_count": "企业选择不公示",
                    "actual_medical_amount": "企业选择不公示",
                    "actual_injury_amount": "企业选择不公示",
                    "company_injury_down_balance": "企业选择不公示",
                    "birth_num": "0人",
                    "birth_actual_amount": "企业选择不公示",
                    "basic_endownment_num": "0人",
                    "injury_insurance_num": "0人",
                    "unenployment_down_balance": "企业选择不公示",
                    "actual_endownment_amount": "企业选择不公示",
                    "basic_medical_amount": "企业选择不公示"
                },
                "dw_je_display": "企业选择不公示",
                "bq_je_display": "企业选择不公示",
                "dw_js_display": "企业选择不公示"
            },
            {
                "report_year": "2021",
                "report_date": "2022-03-24",
                "name": "唐山市丰南区众鑫铝业有限公司",
                "social_security": {
                    "unenployment_insurance": "0万元",
                    "endownment_insurance_amount": "0万元",
                    "actual_lost_amount": "0万元",
                    "base_medical_down_balance": "0万元",
                    "unenployment_num": "0人",
                    "endownment_base_amount": "0万元",
                    "injury_insurance_amount": "-",
                    "insurance_num": "0人",
                    "birth_amount": "0万元",
                    "birth_insurance_count": "0万元",
                    "actual_medical_amount": "0万元",
                    "actual_injury_amount": "0万元",
                    "company_injury_down_balance": "0万元",
                    "birth_num": "0人",
                    "birth_actual_amount": "0万元",
                    "basic_endownment_num": "0人",
                    "injury_insurance_num": "0人",
                    "unenployment_down_balance": "0万元",
                    "actual_endownment_amount": "0万元",
                    "basic_medical_amount": "0万元"
                },
                "dw_je_display": "企业选择公示",
                "bq_je_display": "企业选择公示",
                "dw_js_display": "企业选择公示"
            },
            {
                "report_year": "2020",
                "report_date": "2021-05-12",
                "name": "唐山市丰南区众鑫铝业有限公司",
                "social_security": {
                    "unenployment_insurance": "0万元",
                    "endownment_insurance_amount": "0万元",
                    "actual_lost_amount": "0万元",
                    "base_medical_down_balance": "0万元",
                    "unenployment_num": "0人",
                    "endownment_base_amount": "0万元",
                    "injury_insurance_amount": "-",
                    "insurance_num": "0人",
                    "birth_amount": "0万元",
                    "birth_insurance_count": "0万元",
                    "actual_medical_amount": "0万元",
                    "actual_injury_amount": "0万元",
                    "company_injury_down_balance": "0万元",
                    "birth_num": "0人",
                    "birth_actual_amount": "0万元",
                    "basic_endownment_num": "0人",
                    "injury_insurance_num": "0人",
                    "unenployment_down_balance": "0万元",
                    "actual_endownment_amount": "0万元",
                    "basic_medical_amount": "0万元"
                },
                "dw_je_display": "企业选择公示",
                "bq_je_display": "企业选择公示",
                "dw_js_display": "企业选择公示"
            },
            {
                "report_year": "2019",
                "report_date": "2020-05-10",
                "name": "唐山市丰南区众鑫铝业有限公司",
                "social_security": {
                    "unenployment_insurance": "0万元",
                    "endownment_insurance_amount": "0万元",
                    "actual_lost_amount": "0万元",
                    "base_medical_down_balance": "0万元",
                    "unenployment_num": "0人",
                    "endownment_base_amount": "0万元",
                    "injury_insurance_amount": "-",
                    "insurance_num": "0人",
                    "birth_amount": "0万元",
                    "birth_insurance_count": "0万元",
                    "actual_medical_amount": "0万元",
                    "actual_injury_amount": "0万元",
                    "company_injury_down_balance": "0万元",
                    "birth_num": "0人",
                    "birth_actual_amount": "0万元",
                    "basic_endownment_num": "0人",
                    "injury_insurance_num": "0人",
                    "unenployment_down_balance": "0万元",
                    "actual_endownment_amount": "0万元",
                    "basic_medical_amount": "0万元"
                },
                "dw_je_display": "企业选择公示",
                "bq_je_display": "企业选择公示",
                "dw_js_display": "企业选择公示"
            },
            {
                "report_year": "2018",
                "report_date": "2019-04-15",
                "name": "唐山市丰南区众鑫铝业有限公司",
                "social_security": {
                    "unenployment_insurance": "企业选择不公示",
                    "endownment_insurance_amount": "企业选择不公示",
                    "actual_lost_amount": "企业选择不公示",
                    "base_medical_down_balance": "企业选择不公示",
                    "unenployment_num": "0人",
                    "endownment_base_amount": "企业选择不公示",
                    "injury_insurance_amount": "企业选择不公示",
                    "insurance_num": "0人",
                    "birth_amount": "企业选择不公示",
                    "birth_insurance_count": "企业选择不公示",
                    "actual_medical_amount": "企业选择不公示",
                    "actual_injury_amount": "企业选择不公示",
                    "company_injury_down_balance": "企业选择不公示",
                    "birth_num": "0人",
                    "birth_actual_amount": "企业选择不公示",
                    "basic_endownment_num": "0人",
                    "injury_insurance_num": "0人",
                    "unenployment_down_balance": "企业选择不公示",
                    "actual_endownment_amount": "企业选择不公示",
                    "basic_medical_amount": "企业选择不公示"
                },
                "dw_je_display": "企业选择不公示",
                "bq_je_display": "企业选择不公示",
                "dw_js_display": "企业选择不公示"
            },
            {
                "report_year": "2017",
                "report_date": "2018-04-11",
                "name": "唐山市丰南区众鑫铝业有限公司",
                "social_security": {
                    "unenployment_insurance": "企业选择不公示",
                    "endownment_insurance_amount": "企业选择不公示",
                    "actual_lost_amount": "企业选择不公示",
                    "base_medical_down_balance": "企业选择不公示",
                    "unenployment_num": "0人",
                    "endownment_base_amount": "企业选择不公示",
                    "injury_insurance_amount": "企业选择不公示",
                    "insurance_num": "0人",
                    "birth_amount": "企业选择不公示",
                    "birth_insurance_count": "企业选择不公示",
                    "actual_medical_amount": "企业选择不公示",
                    "actual_injury_amount": "企业选择不公示",
                    "company_injury_down_balance": "企业选择不公示",
                    "birth_num": "0人",
                    "birth_actual_amount": "企业选择不公示",
                    "basic_endownment_num": "0人",
                    "injury_insurance_num": "0人",
                    "unenployment_down_balance": "企业选择不公示",
                    "actual_endownment_amount": "企业选择不公示",
                    "basic_medical_amount": "企业选择不公示"
                },
                "dw_je_display": "企业选择不公示",
                "bq_je_display": "企业选择不公示",
                "dw_js_display": "企业选择不公示"
            },
            {
                "report_year": "2016",
                "report_date": "2017-05-25",
                "name": "唐山市丰南区众鑫铝业有限公司",
                "social_security": {
                    "unenployment_insurance": "0万元",
                    "endownment_insurance_amount": "0万元",
                    "actual_lost_amount": "0万元",
                    "base_medical_down_balance": "0万元",
                    "unenployment_num": "0人",
                    "endownment_base_amount": "0万元",
                    "injury_insurance_amount": "-",
                    "insurance_num": "0人",
                    "birth_amount": "0万元",
                    "birth_insurance_count": "0万元",
                    "actual_medical_amount": "0万元",
                    "actual_injury_amount": "0万元",
                    "company_injury_down_balance": "0万元",
                    "birth_num": "0人",
                    "birth_actual_amount": "0万元",
                    "basic_endownment_num": "0人",
                    "injury_insurance_num": "0人",
                    "unenployment_down_balance": "0万元",
                    "actual_endownment_amount": "0万元",
                    "basic_medical_amount": "0万元"
                },
                "dw_je_display": "企业选择公示",
                "bq_je_display": "企业选择公示",
                "dw_js_display": "企业选择公示"
            },
            {
                "report_year": "2015",
                "report_date": "2016-05-25",
                "name": "唐山市丰南区众鑫铝业有限公司",
                "social_security": {
                    "unenployment_insurance": "企业选择不公示",
                    "endownment_insurance_amount": "企业选择不公示",
                    "actual_lost_amount": "企业选择不公示",
                    "base_medical_down_balance": "企业选择不公示",
                    "unenployment_num": "-",
                    "endownment_base_amount": "企业选择不公示",
                    "injury_insurance_amount": "企业选择不公示",
                    "insurance_num": "-",
                    "birth_amount": "企业选择不公示",
                    "birth_insurance_count": "企业选择不公示",
                    "actual_medical_amount": "企业选择不公示",
                    "actual_injury_amount": "企业选择不公示",
                    "company_injury_down_balance": "企业选择不公示",
                    "birth_num": "-",
                    "birth_actual_amount": "企业选择不公示",
                    "basic_endownment_num": "-",
                    "injury_insurance_num": "-",
                    "unenployment_down_balance": "企业选择不公示",
                    "actual_endownment_amount": "企业选择不公示",
                    "basic_medical_amount": "企业选择不公示"
                },
                "dw_je_display": "企业选择不公示",
                "bq_je_display": "企业选择不公示",
                "dw_js_display": "企业选择不公示"
            },
            {
                "report_year": "2014",
                "report_date": "2015-05-19",
                "name": "唐山市丰南区众鑫铝业有限公司",
                "social_security": {
                    "unenployment_insurance": "企业选择不公示",
                    "endownment_insurance_amount": "企业选择不公示",
                    "actual_lost_amount": "企业选择不公示",
                    "base_medical_down_balance": "企业选择不公示",
                    "unenployment_num": "-",
                    "endownment_base_amount": "企业选择不公示",
                    "injury_insurance_amount": "企业选择不公示",
                    "insurance_num": "-",
                    "birth_amount": "企业选择不公示",
                    "birth_insurance_count": "企业选择不公示",
                    "actual_medical_amount": "企业选择不公示",
                    "actual_injury_amount": "企业选择不公示",
                    "company_injury_down_balance": "企业选择不公示",
                    "birth_num": "-",
                    "birth_actual_amount": "企业选择不公示",
                    "basic_endownment_num": "-",
                    "injury_insurance_num": "-",
                    "unenployment_down_balance": "企业选择不公示",
                    "actual_endownment_amount": "企业选择不公示",
                    "basic_medical_amount": "企业选择不公示"
                },
                "dw_je_display": "企业选择不公示",
                "bq_je_display": "企业选择不公示",
                "dw_js_display": "企业选择不公示"
            },
            {
                "report_year": "2013",
                "report_date": "2015-05-18",
                "name": "唐山市丰南区众鑫铝业有限公司",
                "social_security": {
                    "unenployment_insurance": "企业选择不公示",
                    "endownment_insurance_amount": "企业选择不公示",
                    "actual_lost_amount": "企业选择不公示",
                    "base_medical_down_balance": "企业选择不公示",
                    "unenployment_num": "-",
                    "endownment_base_amount": "企业选择不公示",
                    "injury_insurance_amount": "企业选择不公示",
                    "insurance_num": "-",
                    "birth_amount": "企业选择不公示",
                    "birth_insurance_count": "企业选择不公示",
                    "actual_medical_amount": "企业选择不公示",
                    "actual_injury_amount": "企业选择不公示",
                    "company_injury_down_balance": "企业选择不公示",
                    "birth_num": "-",
                    "birth_actual_amount": "企业选择不公示",
                    "basic_endownment_num": "-",
                    "injury_insurance_num": "-",
                    "unenployment_down_balance": "企业选择不公示",
                    "actual_endownment_amount": "企业选择不公示",
                    "basic_medical_amount": "企业选择不公示"
                },
                "dw_je_display": "企业选择不公示",
                "bq_je_display": "企业选择不公示",
                "dw_js_display": "企业选择不公示"
            }
        ]
    }
}

代码示例

javascript

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

let baseUrl = 'https://api.qixin.com/APIService/reports/getSocialSecurityByName';
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的值'
}

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/reports/getSocialSecurityByName";
        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的值");

        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/reports/getSocialSecurityByName";
            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的值");

            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/reports/getSocialSecurityByName'
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的值'
}

# 构造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)

文档下载

3.3-社保信息.pdf

PDF接口文档