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 助手。