批量作者邮件搜索概述

批量作者查找器是一款专门从一系列文章 URL 中提取电子邮件地址的工具。如需体验其工作原理，可以使用作者查找器进行单次搜索。

评估检索到的电子邮件地址的准确性

作者查找器获取的是互联网上公开可用的电子邮件地址。为了帮助您判断这些邮件的准确性，每个邮件都会根据来源可信度、SMTP 验证和网页上下文等因素分配一个置信度评分。

批量作者查找器的使用权限和价格

通过免费账户即可使用批量作者查找器，并根据您所需的请求数量提供多种方案。您可以在升级之前先进行试用。上传 CSV 文件即可查看找到的邮件地址数量和质量、估算所需请求数并预览数据。您可以随时取消订阅。

批量作者查找器是否也返回电话号码？

是的。结果现在包含作者邮件之外的电话号码（如果公开可用），因此每个文章 URL 都能在一次运行中为您提供更丰富的联系资料。

支持哪些文件格式和限制？

上传 CSV 或 TXT 文件，每行一个文章 URL，每批最多 5,000 行。结果可导出为 CSV、XLSX 或 JSON 格式，或直接同步到 Google Sheets、Excel、Zapier 和 Make。

我可以处理非英语文章吗？

是的。批量作者查找器适用于任何语言和域名顶级域，因此国际出版物、博客和小众媒体网站都受支持。

如果文章没有作者或联系数据会怎样？

未匹配的行不消耗积分。您只需为已解析的作者邮件付费，因此上传含噪声的 URL 列表既安全又经济。

// 批量操作

批量作者查找器

上传包含文章 URL 的 CSV 文件，一次查找所有作者的电子邮件地址。

开始批量处理查看 API

Article URLs每个任务最多 5,000 行CSV、列表或行

author-finder-list.csv2,500 行 · article urlscompleted

批量Author Finder · /bulk/author2,500 / 2,500

01pendingPOST /v1/bulk/author201 · { "data": { "id": 1042 } }
02runninglaunch: true通过 GET /v1/bulk/author/1042/progress 轮询进度
03completedbulk.completed已签名的 webhook 发送至您的 webhook_url

GET /v1/bulk/author/1042/download?file=full首次下载时收费 · 任务 180 天后过期

// 01 · 输入

批量Author Finder任务的输入

在应用中上传最大 4 MB 的 CSV，或将列表、行或文件发送到 POST /v1/bulk/author。列会根据表头行自动识别；设置字段索引即可自行选择。

POST/bulk/author列

url_field_index: Article URL

POST/bulk/author选项

include_sources: true adds the web pages where each address was found

// 02 · api

一个请求即可启动任务

一次调用即可创建并启动任务，然后跟踪其进度或接收已签名的 bulk.completed 事件。每个结果行即 GET /author-finder 返回的内容。

POST /bulk/author

curl -X POST "https://api.tomba.io/v1/bulk/author" \
  -H "X-Tomba-Key: $TOMBA_API_KEY" \
  -H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Author Finder job","list":"https://piedpiper.com/blog/middle-out-compression","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'

const res = await fetch("https://api.tomba.io/v1/bulk/author", {
  method: "POST",
  headers: {
    "X-Tomba-Key": process.env.TOMBA_API_KEY,
    "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "name": "Author Finder job",
    "list": "https://piedpiper.com/blog/middle-out-compression",
    "launch": true,
    "webhook_url": "https://hooks.example.com/tomba"
  })
});
const { data } = await res.json(); // { id }

import os, requests

res = requests.post(
    "https://api.tomba.io/v1/bulk/author",
    headers={
        "X-Tomba-Key": os.environ["TOMBA_API_KEY"],
        "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
    },
    json={
      "name": "Author Finder job",
      "list": "https://piedpiper.com/blog/middle-out-compression",
      "launch": True,
      "webhook_url": "https://hooks.example.com/tomba"
    },
)
job_id = res.json()["data"]["id"]

POST /bulk/author

201 Created

{
  "data": {
    "id": 1042
  }
}

每一行，与 GET /author-finder 返回的内容相同

200 OK

{
  "data": {
    "email": "richard@piedpiper.com",
    "first_name": "Richard",
    "last_name": "Hendricks",
    "full_name": "Richard Hendricks",
    "website_url": "piedpiper.com",
    "company": "Pied Piper",
    "pattern": "{first}",
    "department": "executive",
    "type": "personal",
    "position": "CEO",
    "country": "US",
    "gender": "male",
    "twitter": null,
    "linkedin": "https://www.linkedin.com/in/richard-hendricks",
    "score": 100,
    "accept_all": false,
    "phone_number": true,
    "verification": {
      "date": "2025-01-15T10:32:00+01:00",
      "status": "valid"
    },
    "sources": [
      {
        "uri": "https://piedpiper.com/blog/engineering",
        "website_url": "piedpiper.com",
        "extracted_on": "2024-06-01T09:14:07+01:00",
        "last_seen_on": "2025-01-10T17:02:44+01:00",
        "still_on_page": true
      }
    ],
    "info": {
      "url": "https://piedpiper.com/blog/middle-out-compression",
      "title": "Middle-out compression, explained",
      "og_image": "https://piedpiper.com/blog/middle-out-compression/cover.png",
      "description": "How middle-out compression reached a Weissman score of 5.2.",
      "article_domain": "piedpiper.com",
      "publisher_name": "Pied Piper",
      "publish_date": "2025-03-04",
      "candidates": [
        {
          "full_name": "Richard Hendricks",
          "first_name": "Richard",
          "last_name": "Hendricks",
          "job_title": "CEO",
          "linkedin": "https://www.linkedin.com/in/richard-hendricks",
          "name_confidence": 0.98,
          "score": 0.95,
          "count": 3
        }
      ]
    }
  }
}

// 03 · 费用和限制

任务的费用

创建或启动任务不收费。费用仅在首次下载结果时收取一次。

// 按行计费

1 search credit per article with an author address.

文档中的批量计费说明

行数：每个任务最多 5,000 行
Jobs created: 15 per day for each type
Running jobs: 2 per type
Downloads: 25 per day for each job
Request size: 4 MB (CSV, list or rows)

// 04 · 随处使用

从应用或代码运行Author Finder任务

同样的任务，同样的积分：在应用中上传文件、调用 API，或在电子表格或无代码工具中操作。

完整请求参考： /api/bulk/author-finder

// 客户

运行Author Finder任务的团队

Tomba finding the contacts for the perfect prospects at scale is game changing in helping us promote our data-based research studies.
Nicholas RizzoSenior Digital Manager, Vizme
Tomba has been critical to my SEO and cold outreach workflow. None matched Tomba's accuracy or the depth of contact details it returns.
Henry HoeSEO & Sales Outreach Specialist

// 常见问题

常见问题解答

还有其他问题？访问帮助中心

一分钟内完成首次调用

免费账户、真实的 API 密钥，与 Enterprise 客户使用相同的端点。

1创建免费账户每月 25 次搜索。无需信用卡。

2复制您的密钥和密钥密码在控制台的 API 密钥页面获取。

3调用 API粘贴请求；返回结果为 JSON。

const res = await fetch("https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks", { headers: { "X-Tomba-Key": process.env.TOMBA_API_KEY, "X-Tomba-Secret": process.env.TOMBA_SECRET_KEY } }); const { data } = await res.json();

import os, requests res = requests.get( "https://api.tomba.io/v1/email-finder?domain=piedpiper.com&first_name=Richard&last_name=Hendricks", headers={ "X-Tomba-Key": os.environ["TOMBA_API_KEY"], "X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"], }, ) data = res.json()["data"]

{ "data": { "email": "richard@piedpiper.com", "first_name": "Richard", "last_name": "Hendricks", "full_name": "Richard Hendricks", "website_url": "piedpiper.com", "company": "Pied Piper", "pattern": "{first}", "department": "executive", "type": "personal", "position": "CEO", "country": "US", "gender": "male", "twitter": null, "linkedin": "https://www.linkedin.com/in/richard-hendricks", "score": 100, "accept_all": false, "phone_number": true, "verification": { "date": "2025-01-15T10:32:00+01:00", "status": "valid" }, "sources": [ { "uri": "https://piedpiper.com/blog/engineering", "website_url": "piedpiper.com", "extracted_on": "2024-06-01T09:14:07+01:00", "last_seen_on": "2025-01-10T17:02:44+01:00", "still_on_page": true } ], "phone_data": [] } }