学者搜索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 替换为控制台签发的密钥。完整字段与响应约定见 统一查询。