Overview of Bulk Author Email Search

The Bulk Author Finder is a specialized tool for extracting email addresses from a compilation of article URLs. For sampling how it works, individual searches can be conducted using the Author Finder.

Evaluating the Precision of Retrieved Email Addresses

The Author Finder sources email addresses publicly available on the web. To assist in determining the accuracy of these emails, each one is assigned a confidence score based on factors like source credibility, SMTP verifications, and the surrounding context on web pages.

Accessibility and Pricing of Bulk Author Finder

Access to the Bulk Author Finder is granted through a Free account, with various plans depending on your requirement for the number of requests. A trial run is possible before committing to an upgrade. You can upload a CSV file to review the volume and quality of the email addresses found, estimate the required number of requests, and get a glimpse of the data. Subscriptions can be terminated at any point.

// bulk operations

Bulk Author Finder

Upload a CSV of article URLs and find all the authors' email addresses at once.

Start Bulk Processing View API

Article URLsUp to 5,000 rows a jobCSV, list or rows

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

Bulk Author Finder · /bulk/author2,500 / 2,500

01pendingPOST /v1/bulk/author201 · { "data": { "id": 1042 } }
02runninglaunch: trueprogress polled with GET /v1/bulk/author/1042/progress
03completedbulk.completedsigned webhook delivered to your webhook_url

GET /v1/bulk/author/1042/download?file=fullCharged at the first download · the job expires after 180 days

// 01 · input

The input of a bulk Author Finder job

Upload a CSV of up to 4 MB in the app, or send a list, rows or a file to POST /v1/bulk/author. Columns are found from the header row; set a field index to choose one yourself.

POST/bulk/authorColumns

url_field_index: Article URL

POST/bulk/authorOptions

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

// 02 · api

One request starts the job

Create and launch it in one call, then follow its progress or receive a signed bulk.completed event. Each result row is what GET /author-finder returns.

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
  }
}

Each row, as GET /author-finder returns it

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 · cost and limits

What a job costs

Nothing is charged to create or launch a job. Its cost is charged once, at the first download of its results.

// billing per row

1 search credit per article with an author address.

Bulk billing in the docs

Rows: up to 5,000 per job
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 · use it anywhere

Run Author Finder jobs from the app or your code

The same job, the same credits: upload a file in the app, call the API, or work from a spreadsheet or a no-code tool.

The full request reference: /api/bulk/author-finder

// customers

Teams that run Author Finder jobs

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

// faq

Frequently Asked Questions

Still have questions? Visit the help center

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": [] } }