Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.dropcv.work/llms.txt

Use this file to discover all available pages before exploring further.

candidate_list 是人才库的结构化查询 —— 纯数据库查询，不走向量语义。和 candidate_search 互补：
  • candidate_search —— 给一段 JD 或人选画像，语义召回相似的人
  • candidate_list —— 翻页浏览整库、或按姓名 / 公司 / 职位关键词精确找人
所有参数都可选；全不传就是按更新时间倒序翻人才库第一页。

​
参数

字段类型必填说明
keywordstring否对姓名 / 当前公司 / 当前职位做大小写不敏感子串匹配
current_citystring否按当前城市过滤（精确匹配）
industriesstring[]否行业标签过滤（命中任一即可）
functionsstring[]否职能标签过滤（命中任一即可）
skillsstring[]否技能标签过滤（命中任一即可）
profile_statusstring否档案状态，如 draft / active
limitint否返回条数，默认 20，最多 200
offsetint否分页偏移，默认 0

​
返回

{
  "total": 128,
  "limit": 20,
  "offset": 0,
  "items": [
    {
      "candidate_id": "uuid",
      "full_name": "张三",
      "current_title": "高级后端工程师",
      "current_company": "某科技公司",
      "current_city": "上海",
      "profile_status": "active"
    }
  ]
}
total 是该过滤条件下的总数（不受 limit 影响），用来做分页。

​
示例

# 按关键词找人
curl -X POST https://api.dropcv.work/api/external/v1/skills/candidate_list/invoke \
  -H "Authorization: Bearer $DROPCV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "params": { "keyword": "腾讯", "limit": 20 } }'

# 翻页浏览 + 过滤
curl -X POST https://api.dropcv.work/api/external/v1/skills/candidate_list/invoke \
  -H "Authorization: Bearer $DROPCV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "params": { "current_city": "上海", "industries": ["互联网"], "limit": 50, "offset": 0 } }'

​
权限

只读 —— 任意 API Key 都能调用，不需要 write 权限。