Dievio Lead Search Api
Overview
Use this skill for end-to-end Dievio API execution: authenticate requests, submit lead searches, enrich LinkedIn profiles, and paginate results.
Prefer the bundled script for deterministic request formatting and response handling.
Core Endpoints
- - Public lead search: INLINECODE0
- LinkedIn lookup: INLINECODE1
Authentication headers (use one):
Workflow
- 1. Validate credentials:
- - Require
DIEVIO_API_KEY for API-key flows. - Never print raw secrets.
- 2. Build request body:
- - Search endpoint uses pagination keys (
_page, _per_page, max_results) plus filters. - LinkedIn lookup requires
linkedinUrls and optional output flags.
- 3. Execute request and parse response:
- - Validate
success, count, has_more, next_page, data arrays. - Respect credit behavior: low credits can return fewer rows than requested.
- 4. Handle errors:
- -
401: missing/invalid credentials - INLINECODE14 : insufficient credits
- INLINECODE15 : upstream lead service issue
- INLINECODE16 : server error
Commands
Show help:
CODEBLOCK0
Search with JSON body:
CODEBLOCK1
By default the CLI prints a safe summary.
Use --raw-output only when you explicitly need full rows (which may contain emails/phones).
LinkedIn lookup from URLs:
CODEBLOCK2
Decision Rules
- - Use
search when query is filter-based lead discovery. - Use
linkedin-lookup when input is explicit LinkedIn profile URLs. - For large pulls, enable pagination and stop on
has_more=false. - Keep outputs structured and include paging fields for traceability.
- If user asks for exact filter values, read references/filters-cheatsheet.md.
References
技能名称：dievio-lead-search-api
详细描述：
Dievio Lead Search Api
概述
使用此技能进行端到端的Dievio API执行：验证请求、提交潜在客户搜索、丰富LinkedIn资料以及分页结果。
建议使用捆绑脚本进行确定性的请求格式化和响应处理。
核心端点
- - 公开潜在客户搜索：POST https://dievio.com/api/public/search
- LinkedIn查询：POST https://dievio.com/api/linkedin/lookup
认证头信息（任选其一）：
- - Authorization: Bearer YOURAPIKEY
- X-API-Key: YOURAPIKEY
工作流程
- 1. 验证凭据：
- - 需要DIEVIOAPIKEY用于API密钥流程。
- 切勿打印原始密钥。
- 2. 构建请求体：
- - 搜索端点使用分页键（page、perpage、maxresults）以及筛选条件。
- LinkedIn查询需要linkedinUrls和可选的输出标志。
- 3. 执行请求并解析响应：
- - 验证success、count、hasmore、nextpage、数据数组。
- 注意积分行为：积分不足时返回的行数可能少于请求数量。
- 4. 处理错误：
- - 401：凭据缺失/无效
- 402：积分不足
- 502：上游潜在客户服务问题
- 500：服务器错误
命令
显示帮助：
bash
python3 scripts/dievio_api.py --help
使用JSON体进行搜索：
bash
export DIEVIOAPIKEY=yourapikey
python3 scripts/dievio_api.py search \
--body-file ./search_body.json \
--auto-paginate
默认情况下，CLI会打印安全摘要。
仅当明确需要完整行（可能包含电子邮件/电话号码）时，才使用--raw-output。
通过URL进行LinkedIn查询：
bash
python3 scripts/dievio_api.py linkedin-lookup \
--linkedin-url https://www.linkedin.com/in/example-1 \
--linkedin-url https://www.linkedin.com/in/example-2 \
--include-work-emails \
--include-personal-emails \
--only-with-emails
决策规则
- - 当查询是基于筛选条件的潜在客户发现时，使用search。
- 当输入是明确的LinkedIn个人资料URL时，使用linkedin-lookup。
- 对于大批量拉取，启用分页并在hasmore=false时停止。
- 保持输出结构化，并包含分页字段以便追溯。
- 如果用户询问具体的筛选值，请阅读references/filters-cheatsheet.md。
参考资料
