企业联系方式（只查关键号码，支持批量查企业）

按返回结果量计费，仅返回有关键号码的企业

接口说明

• 按返回结果量计费，支持批量查企业;
• 仅返回有关键号码的企业，无关键号码返回空数据，则不计费。
• 计费量在参数 usedCharge中查看

API路径

/services/v4/rest/enterprise/batch/getContactWithKeyLabel

请求方法

GET

请求参数

注：pids 和 keywords 只需要传一个就可以，两个一起传会提示参数错误

调用样例

https://${host}/services/v4/rest/enterprise/batch/getContactWithKeyLabel?pids[]=fdd8285fe129444eb1ee70dcbaa7760f&pids[]=fc77408bbdefe6b0341b9a513fad90d2

返回结果

JSON示例

    {
    "error_code": 0,
    "message": "",
    "success": true,
    "usedCharge": 1,
    "data": [
        {
            "pid": "fd72d7c9ae9f2dd8a19b094089dddd", // 企业唯一id
            "keyword": "fd72d7c9ae9f2dd8a19b094089dddd", // 查询关键字（即传入的pid或keyword）
            "contacts": [
                {
                    "contact": "",  // 联系人名字
                    "position": "", // 职位
                    "repeat_amount": 0, // 号码重复数
                    "status": "2000", // 号码状态(状态码说明详见下方状态码说明)
                    "type": 1, // 1=手机 2=固话 3=qq 4=邮箱
                    "content": "150********", // 联系方式
                    "sources": [ // 号码来源
                        {
                            "contact": "", // 渠道联系人名字
                            "source_name": "招投标信息" // 渠道名
                        }
                    ],
                    "labels" : [ "关键" ], // 标签
                }
            ]
        }
    ]
}

传入多个企业，返回对应的关键标签联系方式，如企业没有关键标签联系方式，则返回结果的对应数据结构如下：

{
  "error_code": 0,
  "success": true,
  "message": "",
  "data": [
    {
      "keyword": "你传入的keywords或pids参数",
      "pid": "企业的唯一标识",
      "contacts": []
    },
    {
      "keyword": "xwsfeq32r32tr4",
      "pid": "csaf23t4645",
      "contacts": []
    },
  ],
  "usedCharge": 0
}

contacts 字段为空数组，usedCharge为0，此时费用为0
如果传入的多个企业，有的企业有关键标签，有的企业没有关键标签，则返回的结构如下：

{
  "error_code": 0,
  "success": true,
  "message": "",
  "data": [
    {
      "keyword": "scaqwfqeved",
      "pid": "sxxxxx",
      "contacts": []
    },
    {
      "keyword": "xfwqgew",
      "pid": "fwqfeqcsa",
      "contacts": [
        {
          "type": 1,
          "content": "13880xxxxx",
          "sources": [
            {
              "source_name": "工商企业年报2024",
              "contact": ""
            }
          ],
          "contact": "陈**",
          "position": "高管",
          "repeat_amount": 6,
          "status": "1000",
          "labels": [
            "关键"
          ]
        }
      ]
    }
  ],
  "usedCharge": 1
}

此时，一个企业有关键标签联系方式，一个企业没有关键标签联系方式，只计算有关键联系方式的企业费用，即 usedCharge 值：1

号码状态说明

手机号经过清洗后存在状态码

返回字段说明

data 返回字段说明

contacts 返回字段说明

错误返回值

错误代码参考 错误码定义