学者搜索API接口查询

按姓名和/或机构检索公开学者画像候选。返回学者 ID、中英姓名、所属机构、研究兴趣与被引次数。分页对齐统一查询:条数用 top_k(最大 10),翻页用 filters.offset。

已开放 调用入口:POST /v1/data/query

请求体字段

字段类型说明示例
domain string 数据域(必填) research
type string 数据类型(必填) scholar_search
query string 自然语言检索词 Andrew Ng
filters object 结构化过滤条件,见下方「常用 filters」
top_k integer 分页参数:每页条数,取值范围 1–100,本能力默认 5 5

常用 filters

字段类型说明示例
name string 学者姓名(也可用 query) Andrew Ng
org string 机构名称 Stanford
org_id string 机构实体 ID(可传数组) 62331e330a6eb147dca8a6e8
offset integer 分页参数:偏移量(默认 0;配合顶层 top_k 翻页,建议为 top_k 的整数倍) 0

返回字段(hits[])

字段类型说明
id string 学者 ID
name string 姓名(英)
name_zh string 姓名(中)
org string 机构(英)
org_zh string 机构(中)
org_id string 机构 ID
interests list 研究兴趣
n_citation number 被引次数
nation string 国家/地区
source string 数据来源标识
disclaimer string 来源说明

curl 请求示例

curl -sS -X POST https://data.devnors.com/v1/data/query \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain":"research", "type":"scholar_search", "query":"Andrew Ng", "filters":{ "name":"Andrew Ng", "org":"Stanford", "org_id":"62331e330a6eb147dca8a6e8", "offset":0 }, "top_k":5 }'

YOUR_API_KEY 替换为控制台签发的密钥。完整字段与响应约定见 统一查询