API

通过 API 将 DINQ 的人才搜索能力接入你的系统和工具。

通过 DINQ 的 API，你的团队可以用代码直接调用人才搜索和候选人信息补全功能。将 DINQ 直接接入你现有的招聘系统、ATS 或内部工具。

API Playground 示例 — 图：真实组件中的示例参数和无效占位密钥，未发送 API 请求。

你可以做什么

ATS 集成： 将补全后的候选人数据直接拉入你的招聘管理系统。
内部招聘工具： 将 DINQ 的人才搜索能力嵌入你自己的招聘流程和工作面板。
市场调研： 程序化地调查人才池和工程人才密度，为招聘计划提供数据支持。

API 端点

POST https://api.dinq.me/v2/people/search

搜索参数

参数	是否必填	说明
`query`	必填	自然语言搜索词，描述你要找的人
`limit`	可选	返回结果数量，默认 10，最大 100
`time.active.from`、`time.active.to`	可选	活跃时间范围，使用 ISO 日期时间；Playground 的 30 天、180 天、1 年选项会转换为具体日期
`sources`	可选	来源数组：`github`、`huggingface`、`company`、`scholar`、`linkedin`

界面中的“职业 / Professional”来源在请求里使用 linkedin，不是 professional。活跃时间也不是顶层 active_time 字段。

请求示例

curl -X POST https://api.dinq.me/v2/people/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "AI infrastructure founders in San Francisco",
  "limit": 10
}'

DINQ 还提供 Python SDK（dinq-people-search）和 TypeScript SDK（@dinq-labs/people-search），可以在 API Playground 中查看完整代码示例。

活跃时间和工作空间

例如，只检索指定来源且有较新活动的人，可以提交：

{
  "query": "AI infrastructure engineers",
  "limit": 10,
  "sources": ["github", "linkedin"],
  "time": {
    "active": {
      "from": "2026-10-01T00:00:00.000Z",
      "to": "2026-10-27T00:00:00.000Z"
    }
  }
}

日期只是示例，请换成实际范围。团队调用还需要发送 X-Workspace-ID: YOUR_WORKSPACE_ID 请求头；它不能替代 API Key，也不能授予你本来没有的工作空间权限。

Playground 会根据当前空间生成请求示例。切换空间后重新复制代码，避免将团队操作计入错误的空间。

邮箱查询 API

在 Playground 的 API 类型中选择 邮箱查找 / Profile Email。它不同于人员搜索接口，用来为已经明确身份的一位候选人查找邮箱。

POST https://api.dinq.me/api/v1/scholar/deep-search/profile-email

常用请求字段：

字段	说明
`name`	候选人姓名，必填
`session_id`	会话标识；独立调用示例可传空字符串
`company`、`current_employer`	公司和当前雇主等身份线索
`text`、`useful_info`	职位、背景和公开证据上下文
`sources`	包含 `url` 和可选 `description` 的来源列表
`personal_homepage`、`urls`	个人主页或其他公开链接

curl -X POST https://api.dinq.me/api/v1/scholar/deep-search/profile-email \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Alex Example",
    "session_id": "",
    "company": "Example Company",
    "sources": [
      {"url": "https://example.com/team/alex", "description": "homepage"}
    ]
  }'

这是占位示例，不代表真实候选人或可查询结果。返回的 emails 可能为空或 null，不保证每个人都有公开可用的邮箱。新成功查询按每位候选人 20 Credits 计费，命中可复用结果时以实际扣费记录为准；失败或未找到邮箱不扣费。

API Playground

API Playground 让你在 DINQ 内部直接构造和发送搜索请求，实时查看返回结果，并获取可复制的代码示例。

在浏览器中输入搜索词、调整参数，点击搜索即可测试。
支持卡片式和 JSON 两种结果查看方式。
自动生成 Python、TypeScript 和 Curl 三种语言的代码示例。
在人员搜索与邮箱查询之间切换；API、MCP 和 Skill 是不同的使用模式。

如何使用

在 设置 > API Key 中创建有效密钥，并在请求头中发送 Authorization: Bearer YOUR_API_KEY。能否调用还取决于当前账户或团队的权限与可用额度；请以接口反馈和订阅页面为准，不要把“已创建密钥”当成额度无限或所有接口都已开放。

Playground 发出的是实际请求，不是免费模拟。搜索、邮箱和其他功能有各自的计费规则，不能把搜索页新版档案的 5 Credits 直接当作所有 API 的单价。

继续阅读

MCP

通过 MCP 协议将 DINQ 接入你的 AI 助手。