关联关系挖掘接口文档

更新日志

版本	修改描述	修订人	修订时间
1.0.0	初版
2.0.0	统一 filters 格式		2026-07-07

安全说明

所有请求必须携带有效的 access_token 参数。
access_token 应通过登录接口获取，且具有时效性和权限限制。
未授权访问将返回错误码并拒绝请求。

Header 参数

参数名	类型	必填	说明
Authorization	string	是	请求令牌，Bearer [access_token]

接口列表

域名根路径: https://eagleinsight.cn/data

接口	请求方法	URL	接口说明
关联排查 - 群组查询	POST	`/relation/api/query/group`	发现群组企业之间的关联关系
关联排查 - 一对多查询	POST	`/relation/api/one2many`	发现一个指定企业/个人与多个企业之间的关联关系
关联排查 - 关联详情	POST	`/relation/api/detail/advanced`	返回两个关联企业的所有关联路径
疑似关联企业	POST	`/relation/api/suspected`	返回指定入参企业的所有疑似关联企业
疑似关联评分	POST	`/relation/api/score`	返回两个疑似关联企业的关联得分

1. 关联排查 - 群组查询

请求方式： POST（HTTPS）

请求地址： https://eagleinsight.cn/data/relation/api/query/group

Content-Type： application/json;charset=UTF-8

接口说明： 发现群组企业之间的关联关系

请求参数

参数名称	类型	必选	参数说明
nodeIds	JSONArray<String>	是	起始企业名称或者统一社会信用代码，支持混合传入
filters	JSONObject	否	过滤条件（统一格式，详见 filters 格式说明）

请求示例

json

{
  "nodeIds": [
    "914404001927878256N",
    "xxxx有限公司",
    "xxxx科技发展公司",
    "xxxx集团",
    "xxxxx传媒有限公司",
    "xxxx科技有限公司"
  ],
  "filters": {
    "degree": 1,
    "rules": [
      {
        "logic": "and",
        "type": "sh",
        "conditions": [
          {
            "name": "stock_ratio",
            "computation": {
              "type": "number",
              "value": 0.001,
              "operator": "gte"
            }
          }
        ]
      },
      {
        "type": "tm"
      }
    ]
  }
}

返回结果说明

参数名	类型	备注
suggestedMatches	Array	返回的是库里匹配不到的企业，一般是企业名称错误导致的
relatedParties	Array	返回有关系的多方企业名称
notExist	Object	不在用例库中的数据

`suggestedMatches` 数据项结构

参数名	类型	备注
inputName	string	用户输入的企业名称
matchedName	string	系统能匹配到的类似的企业名称
matchedId	string	类似企业的唯一标识

`notExist` 数据项结构

参数名	类型	备注
nodeIds	Array	不在库中企业数据

返回结果示例

json

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "suggestedMatches": [
      {
        "matchedName": "xxxx有限公司北京分公司",
        "matchedId": "123123123123123123",
        "inputName": "xxxx有限公司"
      }
    ],
    "relatedParties": [
      {
        "relations": [
          "xxxx集团",
          "xxxx科技有限公司"
        ]
      }
    ],
    "notExist": {
      "nodeIds": [
        "xxxx科技发展公司",
        "xxxxx传媒有限公司"
      ]
    }
  }
}

2. 关联排查 - 一对多查询

请求方式： POST（HTTPS）

请求地址： https://eagleinsight.cn/data/relation/api/one2many

Content-Type： application/json;charset=UTF-8

接口说明： 发现一个指定企业/个人与多个企业之间的关联关系

请求参数

参数名称	类型	必选	参数说明
startId	string	是	起点企业名称或统一社会信用代码
endIds	JSONArray	是	目标主体名称列表，最多支持 50 个
filters	JSONObject	否	关联关系过滤规则（统一格式，详见 filters 格式说明）

请求示例

json

{
  "startId": "xxxxx传媒有限公司",
  "endIds": [
    "xxxxx有限责任公司",
    "xxxxx分公司",
    "xxxxx科技发展有限公司"
  ],
  "filters": {
    "degree": 1,
    "rules": [
      {
        "logic": "and",
        "type": "sh",
        "conditions": [
          {
            "name": "stock_ratio",
            "computation": {
              "type": "number",
              "value": 0.001,
              "operator": "gte"
            }
          }
        ]
      },
      {
        "type": "tm"
      }
    ]
  }
}

返回结果说明

参数名	类型	备注
suggestedMatches	Array	返回的是库里匹配不到的企业，一般是企业名称错误导致的
relatedParties	Array	返回有关系的多方企业名称
notExist	Object	不在用例库中的数据

`relatedParties` 数据项结构

参数名	类型	备注
relations	Array	返回有关系的多方企业名称

返回结果示例

json

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "suggestedMatches": [
      {
        "matchedName": "xxxxx有限责任公司北京分公司",
        "matchedId": "202367312jk234hg123kh",
        "inputName": "xxxxx有限责任公司"
      }
    ],
    "notExist": {
      "sourceId": "3736125jdhawgqwjqgh",
      "sourceType": "org",
      "targetNames": [
        {
          "id": "123712613256218hdgeqwqweq",
          "type": "org"
        },
        {
          "id": "2025837363623jhsgsfgssggf",
          "type": "org"
        }
      ]
    },
    "relatedParties": [
      "xxxxx科技发展有限公司"
    ]
  }
}

3. 关联排查 - 关联详情

请求方式： POST（HTTPS）

请求地址： https://eagleinsight.cn/data/relation/api/detail/advanced

Content-Type： application/json;charset=UTF-8

接口说明： 返回两个关联企业的所有关联路径

请求参数

参数名称	类型	必选	参数说明
startId	string	是	起始企业，企业全称或统一社会信用代码
endId	string	是	目标企业，企业全称或统一社会信用代码
filters	JSONObject	否	过滤条件（统一格式，详见 filters 格式说明）

请求示例

json

{
  "startId": "xxxxxxx有限公司",
  "endId": "xxxxxx有限公司",
  "filters": {
    "degree": 1,
    "rules": [
      {
        "logic": "and",
        "type": "sh",
        "conditions": [
          {
            "name": "invest_rate",
            "computation": {
              "type": "string",
              "operator": "gte",
              "value": "0.01"
            }
          }
        ]
      },
      {
        "type": "tm"
      }
    ]
  }
}

注意：所有接口的 filters 使用统一格式，包含 degree（搜索深度）和 rules（过滤规则数组）。后端会自动转换为第三方接口要求的格式，调用方无需关心内部差异。

使用说明

filters 为统一过滤条件格式，所有接口共用。degree 和 rules 均为可选字段。
rules 是数组，每个元素是对一种边类型（type）条件的描述，同一个边类型在数组里只能出现一次。
logic 属性表示 conditions 里的条件的判断逻辑，可取值 and 或 or。默认为 and。
- 对于 weak 弱关联类型，可以用 or 来查询地址、邮箱、电话、疑似
- 对于 sh 股东关联类型可以用 and 来查询持股比例 > xx值且持股比例 < xx值
conditions 下每个条件的 computation.operator 表示比较符号，取值如下：

操作符	含义
eq	等于
gte	大于等于
lte	小于等于
gt	大于
lt	小于

关联条件表

关联类型	type	过滤字段	边属性名	取值 (value)	type (值类型)
股东	sh	持股比例	invest_rate	[0.0, 1.0]	string
历史股东	sh_his	离职时间	end_date	yyyy-MM-dd	string
		持股比例	invest_rate	[0.0, 1.0]	string
高管	tm	—	—	—	—
历史高管	tm_his	离职时间	end_date	yyyy-MM-dd	string
法人	lp	—	—	—	—
历史法人	lp_his	离职时间	end_date	yyyy-MM-dd	string
实际受控人	act	持股比例	invest_rate	[0.0, 1.0]	string
分支机构	branches	—	—	—	—
年报披露关联企业	annual_related	开始时间	pub_date	yyyy-MM-dd	string
应收关系	receive	—	—	—	—
应付关系	pay	—	—	—	—
担保	assure	—	—	—	—
客户	cu	结束时间	end_date	yyyy-MM-dd	string
供应商	su	结束时间	end_date	yyyy-MM-dd	string
司法诉讼	lawsuit	—	—	—	—
招投标	bidding	—	—	—	—
疑似关联	weak	弱关联	weak_type	susp	string
邮箱关联	weak	弱关联	weak_type	email	string
电话关联	weak	弱关联	weak_type	tel	string
地址关联	weak	弱关联	weak_type	addr	string

返回结果说明

参数名	类型	备注
maxPathCount	Integer	最大返回路径数
returnedPathCount	Integer	实际返回路径数
deduplicatedPathCount	Integer	去重后路径数
totalPathCount	Integer	符合条件的总路径数
maxPathHops	Integer	最大跳数
minPathHops	Integer	最小跳数
paths	JSONArray	关联路径列表
graphData	JSONObject	图数据结构

`paths` 数据项结构

参数名	类型	备注
relationTypes	Array<String>	关系类型列表
nodeIds	Array<String>	节点 ID 列表
pathLength	Integer	路径长度
pathRelevanceScore	Float	路径相关性得分
pathDescription	String	路径可读描述
relations	Array<Object>	路径中的关系

`graphData` 数据项结构

参数名	类型	备注
entities	Array<Object>	实体节点列表
relations	Array<Object>	关系边列表

`entities` 子项

参数名	类型	备注
entityName	String	实体名称
entityType	String	实体类型
entityId	String	实体 ID

`relations` 数据项结构

参数名	类型	备注
fromNodeId	String	关系起点
toNodeId	String	关系终点
relationName	String	关系显示名称
relationType	String	关系类型
equityRatio	BigDecimal	持股比例
relevanceScore	BigDecimal	该关系的权重
holderCategory	String	股东类别
weakRelationType	String	弱关联类型（仅 weak 有效）
weakRelationName	String	弱关联名称（仅 weak 有效）
direction	Integer	方向标识：1 表示 from → to

返回结果示例

json

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "maxPathCount": 10,
    "returnedPathCount": 2,
    "deduplicatedPathCount": 2,
    "totalPathCount": 2,
    "maxPathHops": 1,
    "minPathHops": 1,
    "paths": [
      {
        "relationTypes": ["sh"],
        "nodeIds": ["2011d8ad4b84c0103644870526342079", "201116c92c5942327840210512822797"],
        "pathLength": 1,
        "relations": [
          {
            "fromNodeId": "201116c92c5942327840210512822797",
            "relationName": "股东(持股33.33%)",
            "relationType": "sh",
            "equityRatio": 0.33333301544189453,
            "relevanceScore": 0.33333301544189453,
            "toNodeId": "2011d8ad4b84c0103644870526342079",
            "holderCategory": "企业",
            "direction": 1
          }
        ],
        "pathRelevanceScore": 0.8,
        "pathDescription": "xxxx计算有限公司<-xxxx（北京）有限公司"
      }
    ],
    "graphData": {
      "entities": [
        {
          "entityName": "xxxxxx（北京）有限公司",
          "entityType": "org",
          "entityId": "201116c92c5942327840210512822797"
        },
        {
          "entityName": "xxxxx计算有限公司",
          "entityType": "org",
          "entityId": "2011d8ad4b84c0103644870526342079"
        }
      ],
      "relations": [
        {
          "fromNodeId": "201116c92c5942327840210512822797",
          "relationName": "股东(持股33.33%)",
          "relationType": "sh",
          "equityRatio": 0.33333301544189453,
          "relevanceScore": 0.33333301544189453,
          "toNodeId": "2011d8ad4b84c0103644870526342079",
          "holderCategory": "企业",
          "direction": 1
        }
      ]
    }
  }
}

4. 疑似关联企业

请求方式： POST（HTTPS）

请求地址： https://eagleinsight.cn/data/relation/api/suspected

Content-Type： application/json;charset=UTF-8

接口说明： 返回指定入参企业的所有疑似关联企业

请求参数

参数名称	类型	必选	参数说明
orgName	string	是	企业名称
ucCode	string	是	企业的统一社会信用代码

请求示例

json

{
  "orgName": "xxxxxx有限公司",
  "ucCode": ""
}

返回结果说明

参数名	类型	备注
industryName	string	行业
legalRepresentative	string	法定代表人
companyType	string	企业类型
establishmentDate	string	成立日期
companyStatus	string	企业经营状态
suspectedRelatedCompanies	Array	疑似关联的公司列表

`suspectedRelatedCompanies` 数据项结构

参数名	类型	备注
companyName	string	关联公司名称
relationType	string	关联类型
creditCode	string	统一社会信用代码
relationEvidence	string	关联依据

返回结果示例

json

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "industryName": "其他互联网平台",
    "legalRepresentative": "刘xx",
    "suspectedRelatedCompanies": [
      {
        "relationType": "疑似关联",
        "creditCode": "111011DSfdsfsdf",
        "relationEvidence": "电话",
        "companyName": "xxxxxxxx文化传媒有限公司"
      },
      {
        "relationType": "疑似关联",
        "creditCode": "9111011dsaqwdads",
        "relationEvidence": "电话",
        "companyName": "xxxxxx科技有限公司"
      }
    ],
    "companyType": "其他有限责任公司",
    "establishmentDate": "2014-07-01",
    "companyStatus": "存续"
  }
}

5. 疑似关联评分

请求方式： POST（HTTPS）

请求地址： https://eagleinsight.cn/data/relation/api/score

Content-Type： application/json;charset=UTF-8

接口说明： 返回两个疑似关联企业的关联得分

请求参数

参数名称	类型	必选	参数说明
keyWord1	string	是	企业名称
keyWord2	string	是	企业名称

请求示例

json

{
  "keyWord1": "xxxxxx集团有限公司",
  "keyWord2": "xxxxxxx有限公司"
}

返回结果说明

参数名	类型	备注
score	string	关联分数
company1	Object	企业信息 1
company2	Object	企业信息 2

`company1/company2` 数据项结构

参数名	类型	备注
entName	string	企业名称
creditNo	string	统一社会信用代码

返回结果示例

json

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "score": "0.0",
    "company1": {
      "entName": "xxxxxx集团有限公司",
      "creditNo": null
    },
    "company2": {
      "entName": "xxxxxxx有限公司",
      "creditNo": null
    }
  }
}

6. filters 格式说明

所有关联排查接口（群组查询、一对多查询、关联详情）统一使用以下 filters 格式：

json

{
  "degree": 1,
  "rules": [
    {
      "type": "sh",
      "logic": "and",
      "conditions": [
        {
          "name": "stock_ratio",
          "computation": {
            "type": "number",
            "operator": "gte",
            "value": 0.001
          }
        }
      ]
    },
    {
      "type": "tm"
    },
    {
      "type": "weak",
      "logic": "or",
      "conditions": [
        {
          "name": "weak_type",
          "computation": {
            "type": "string",
            "operator": "eq",
            "value": "tel"
          }
        }
      ]
    }
  ]
}

filters 字段说明

字段	类型	必选	说明
degree	Integer	否	搜索深度，取值范围 1～15，默认 6
rules	Array	否	过滤规则数组，每个元素描述一种边类型的条件

rules 元素结构

字段	类型	必选	说明
type	String	是	边类型（如 sh、tm、weak 等），同一类型只能出现一次
logic	String	否	条件逻辑：`and` / `or`，默认 `and`
conditions	Array	否	条件列表，无条件的边类型可省略

conditions 元素结构

字段	类型	必选	说明
name	String	是	边属性名（如 invest_rate、weak_type 等）
computation	Object	是	比较条件

computation 结构

字段	类型	必选	说明
type	String	是	值类型：`number` / `string`
operator	String	是	比较符：`eq` / `gte` / `lte` / `gt` / `lt`
value	Object	是	比较值

关联关系挖掘接口文档 ​

更新日志 ​

安全说明 ​

接口列表 ​

1. 关联排查 - 群组查询 ​

请求参数 ​

请求示例 ​

返回结果说明 ​

suggestedMatches 数据项结构 ​

notExist 数据项结构 ​

返回结果示例 ​

2. 关联排查 - 一对多查询 ​

请求参数 ​

请求示例 ​

返回结果说明 ​

relatedParties 数据项结构 ​

返回结果示例 ​

3. 关联排查 - 关联详情 ​

请求参数 ​

请求示例 ​

使用说明 ​

关联条件表 ​

返回结果说明 ​

paths 数据项结构 ​

graphData 数据项结构 ​

entities 子项 ​

relations 数据项结构 ​

返回结果示例 ​

4. 疑似关联企业 ​

请求参数 ​

请求示例 ​

返回结果说明 ​

suspectedRelatedCompanies 数据项结构 ​

返回结果示例 ​

5. 疑似关联评分 ​

请求参数 ​

请求示例 ​

返回结果说明 ​

company1/company2 数据项结构 ​

返回结果示例 ​

6. filters 格式说明 ​

filters 字段说明 ​

rules 元素结构 ​

conditions 元素结构 ​

computation 结构 ​

关联关系挖掘接口文档

更新日志

安全说明

接口列表

1. 关联排查 - 群组查询

请求参数

请求示例

返回结果说明

`suggestedMatches` 数据项结构

`notExist` 数据项结构

返回结果示例

2. 关联排查 - 一对多查询

请求参数

请求示例

返回结果说明

`relatedParties` 数据项结构

返回结果示例

3. 关联排查 - 关联详情

请求参数

请求示例

使用说明

关联条件表

返回结果说明

`paths` 数据项结构

`graphData` 数据项结构

`entities` 子项

`relations` 数据项结构

返回结果示例

4. 疑似关联企业

请求参数

请求示例

返回结果说明

`suspectedRelatedCompanies` 数据项结构

返回结果示例

5. 疑似关联评分

请求参数

请求示例

返回结果说明

`company1/company2` 数据项结构

返回结果示例

6. filters 格式说明

filters 字段说明

rules 元素结构

conditions 元素结构

computation 结构