瀑布式电话号码查找 API
通过 AI 助手、无代码 workflow 或您自己的代码,从 LinkedIn 个人资料 URL 查找电话号码。
- 每个电话号码低至 $0.34
- 从 LinkedIn URL 获取电话号码
- 每个任务最多处理 10,000 个电话号码
| LinkedIn 个人资料 URL |
|---|
| linkedin.com/in/maya-lindqvist |
| linkedin.com/in/tom-okafor |
| linkedin.com/in/lea-moreau |
深受初创公司和《财富》500 强团队的 38,000+ 名用户信赖
适用于任何能够发送 HTTP 请求的工具
Claude
Cursor
Codex
Make
n8n
Zapier
- 您自己的代码
选择您的接入方式
让 AI 助手或自动化工具完成设置,也可以通过您自己的代码调用 REST API。
粘贴设置 prompt
复制适用于 Claude Code、Codex、Cursor、Make、n8n 或 Zapier 的 prompt,然后粘贴进去。AI 会在您的计算机上创建一个 Datablist 文件夹并完成所有设置。
粘贴您的 API 密钥
当 AI 询问时,从 Datablist 应用复制 API 密钥,并将其粘贴到 AI 已打开的 .env 文件中。切勿将其粘贴到聊天中。
获取结果
发送 LinkedIn 个人资料 URL 列表,每个个人资料将返回一行结果:采用国际格式的电话号码及其国家/地区,可直接用于您的拨号工具或 CRM。
查看结果示例正在使用 Make、n8n 或 Zapier?以下是 HTTP 请求所需的全部字段
使用您的工具提供的 HTTP 请求模块或节点。您需要三个步骤:发送列表、等待,然后读取结果。
1. 发送您的列表(HTTP 请求)
- 方法
POST- URL
https://api.datablist.com/v1/enrichments/tasks- 请求头
X-API-Key= 您的 API 密钥Content-Type=application/json- 请求体(JSON)
- json{"enrichmentId": "waterfall-phone-finder","uniqueId": "waterfall-phone-finder-import-1","settings": {"cacheAge": "30"},"inputs": [{"inputId": "row-1", "data": {"profileUrl": "https://www.linkedin.com/in/maya-lindqvist/"}},{"inputId": "row-2", "data": {"profileUrl": "https://www.linkedin.com/in/tom-okafor/"}},{"inputId": "row-3", "data": {"profileUrl": "https://www.linkedin.com/in/lea-moreau/"}}]}
- 保留
- 响应中的
@id。这就是您的任务 ID。
2. 等待任务完成
添加短暂等待或延迟,然后向 https://api.datablist.com/v1/enrichments/tasks/TASK_ID 发送 GET 请求,并使用相同的 X-API-Key 请求头。重复执行,直到 status 为 completed。
3. 读取结果
GET https://api.datablist.com/v1/enrichments/tasks/TASK_ID/results?limit=50。将 outputs 映射到您的列。如果 nextCursor 不为空,请添加 &cursor= 及其值,再次调用。
快速了解
一次调用会依次尝试多个电话号码查找服务,直到其中一个返回号码;您只需为成功找到的号码付费。无需 Datablist workspace、collection 或导入操作。
团队可以用它构建什么
将 Waterfall Phone Finder 接入您现有的任何数据流。
在销售序列中加入电话联系
- lead 的 LinkedIn URL
- 在拨号工具中添加通话步骤
获取优质 leads 的直线电话号码,并在 Aircall、Ringover 或您的销售互动工具中添加通话步骤。
直接致电候选人
- 候选人的 LinkedIn URL
- 保存到您的 ATS
通过电话联系入围候选人,无需等待 InMail 回复。
完善高价值联系人信息
- CRM 中的重点客户
- 将号码添加到联系人
仅对目标客户中的决策者执行查找,把 credits 用在真正值得致电的联系人上。
需要花费多少?
使用 credits 按次支付查找费用。API 访问权限从 Growth 套餐开始提供。
需要花费多少?
告诉我们您需要为多少个 LinkedIn 个人资料查找电话号码,我们会为您推荐成本最低的方式。
= 500,000 credits,按每个成功找到的号码 500 credits 计算(假设每一行都返回结果时的最高费用)
credits 如何运作
1,000 credits = $1,因此每个 credit 的价格为十分之一美分。每成功找到一个电话号码需 500 credits,即 $0.50。未找到结果的搜索和已接受的缓存结果不收费,因此上述估算为最高费用。使用您自己的查找服务密钥可能会改变 Datablist 的使用量。套餐 credits 每月续期,未使用的部分会在重置时失效。额外购买的 credits 永不过期。
集成到您的代码中
直接调用 REST API 所需的一切:代码、响应、端点、字段、身份验证和限制。
复制、粘贴、运行
一个完整脚本:创建任务、等待任务完成并输出每条结果。请将 YOUR_PERSONAL_API_KEY 替换为您的密钥。
# 1. Create the task (returns 202 Accepted and the task "@id")
curl --request POST 'https://api.datablist.com/v1/enrichments/tasks' \
--header 'X-API-Key: YOUR_PERSONAL_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"enrichmentId": "waterfall-phone-finder",
"uniqueId": "waterfall-phone-finder-import-1",
"settings": {
"cacheAge": "30"
},
"inputs": [
{"inputId": "row-1", "data": {"profileUrl": "https://www.linkedin.com/in/maya-lindqvist/"}},
{"inputId": "row-2", "data": {"profileUrl": "https://www.linkedin.com/in/tom-okafor/"}},
{"inputId": "row-3", "data": {"profileUrl": "https://www.linkedin.com/in/lea-moreau/"}}
]
}'
# 2. Poll every few seconds until status is completed, failed or stopped
curl 'https://api.datablist.com/v1/enrichments/tasks/TASK_ID' \
--header 'X-API-Key: YOUR_PERSONAL_API_KEY'
# 3. Read the results, then follow nextCursor until it is null
curl 'https://api.datablist.com/v1/enrichments/tasks/TASK_ID/results?limit=50' \
--header 'X-API-Key: YOUR_PERSONAL_API_KEY'API 返回内容
每个输入对应一条结果,其中包含您的 inputId、状态、outputs 和已使用的 credits。以下为示例数据。
{
"taskId": "00000000000040008000000000000001",
"results": [
{
"inputId": "row-1",
"status": "success",
"outputs": {
"phoneNumber": "+46701234567",
"phoneNumberCountry": "SE"
},
"creditsUsed": "500",
"error": null
}
],
"nextCursor": null
}端点与字段
所有路径均相对于 https://api.datablist.com。字段定义来自 GET /v1/enrichments/waterfall-phone-finder(文档更新于 2026 年 10 月 15 日)。Schema 版本:2026-09-12。
查看 API schema(JSON) (在新标签页中打开)
- /v1/enrichments/waterfall-phone-finder
- 读取 schema,无需密钥
- POST
- /v1/enrichments/tasks
- 创建任务
- /v1/enrichments/tasks/{taskId}
- 轮询状态和进度
- /v1/enrichments/tasks/{taskId}/results
- 读取结果,每页 1 至 100 条
- POST
- /v1/enrichments/tasks/{taskId}/stop
- 取消正在运行的任务
- /v1/enrichments/tasks
- 任务历史记录,最新的排在最前
Schema 参考
每个任务仅发送一次 settings,并为每个输入发送一个 data 对象。随着 enrichment 功能演进,结果可能包含额外字段,因此解析 outputs 时请保留未知键。
显示所有设置、输入和输出
设置
cacheAgeAllowed Cache Age | Text | Results are cached to avoid paying multiple times for the same search. Configure the cache limit here. Default to 30 days.允许的值: |
|---|---|---|
useCustomAPIKeysCustom Waterfall | Boolean | Check this setting to customize the Waterfall sequence and use your own API Keys. |
customSequenceWaterfall Sequence | JSON list | Define each provider and configure your API Keys. 启用条件: |
customSequence[].providerProvider | Text | 允许的值: 启用条件: |
customSequence[].apiKeyProvider API Key | Text | When configuring your sequence, you have to provide your API Key for each provider. 启用条件: |
输入(data)
profileUrl必填LinkedIn Profile | Text | Person's Profile URL should be in the format of https://linkedin.com/in/xxx . This enrichment doesn't work with Sales Navigator Profile URL format. |
|---|
输出
phoneNumberPhone Number | Text | Phone Number found in international format (with country prefix). |
|---|---|---|
phoneNumberCountryCountry | Text | Alpha-2 country code for the phone Number. See [Wikipedia page](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) for more information on ISO 3166-1 alpha-2. |
finderProviderProvider | Text | Which Phone Finder provider returned the result. 启用条件: |
一个请求头,限制一目了然
在您的 Datablist 账户中创建个人 API 密钥,并在每个需要身份验证的请求中发送该密钥。
身份验证
在 X-API-Key 请求头中发送您的密钥。Datablist 会为您交换并续期访问令牌。
- 请求头:
X-API-Key: YOUR_PERSONAL_API_KEY - 可选:使用来自
POST /v1/account/token的Authorization: Bearer自行管理令牌 - 二选一:同时发送两个请求头会返回
400 AmbiguousCredentials - 仅限服务端:切勿在 URL、浏览器代码和日志中暴露密钥
限制
- 每个任务的输入数:1 至 10,000
- 大小:每个输入 16 KiB,每个请求 10 MiB
- 运行时间:每个任务最长 24 小时
- 创建任务:每个账户每 60 秒 10 个请求
- 轮询和结果:每项操作每 60 秒 120 个请求
- 活动任务:每个账户约可同时运行 20 个
- 保留期限:任务和结果保留 90 天
常见问题解答
您或您的 AI 编程代理集成 Waterfall Phone Finder API 所需了解的一切:身份验证、请求、轮询、结果、限制和重试。


