How does the Bulk Author Finder API work?

Create a bulk operation by uploading article URLs, then launch the operation. The API extracts author information and finds their email addresses asynchronously for all URLs.

What is the maximum batch size?

You can process up to 10,000 article URLs per bulk operation. For larger datasets, create multiple bulk operations.

What types of URLs are supported?

The API works with blog posts, news articles, and content pages from most CMS platforms including WordPress, Medium, Ghost, and custom publishing systems.

What results are returned?

Each result includes the author's email address, full name, company, position, LinkedIn profile, confidence score, and sources where the information was found.

How long does processing take?

De verwerkingstijd hangt af van het aantal URL's. Gemiddeld duurt de verwerking 2-3 seconden per URL. Een batch van 5.000 URL's is doorgaans binnen enkele uren klaar.

How are credits calculated?

Each URL that returns an author email counts as 1 request. URLs where no author email is found are not counted against your quota.

Are webhooks supported?

Yes, configure a webhook URL to receive a notification when your bulk author finder operation completes with results ready for download.

What if an article has multiple authors?

The API returns the primary author's email address. For articles with multiple authors, consider using individual Author Finder API calls.

Can I use this for digital PR and journalist outreach?

Yes. Teams use Bulk Author Finder to build media and contributor lists at scale, then route high-confidence contacts into outreach sequences.

What helps improve match accuracy?

Provide clean canonical article URLs, avoid homepage/category pages, and remove URL duplicates before submission to maximize extraction quality.

// post /v1/bulk/author

Bulk Author Finder API

Turn thousands of article URLs into verified author contact records with one asynchronous bulk request.

Gratis API-sleutel API-naslag

Article URLsTot 5,000 rijen

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"]

// 01 · verzoek

Bulk Author Finder is één HTTPS-verzoek

Stuur de parameters mee met je sleutel en secret. Elke SDK, de CLI en de MCP-server doen precies deze aanroep.

type: author
list | data | file: Article URLs
launch: true start de taak meteen
webhook_url: Ontvangt een ondertekend event als de taak klaar is
rows: Tot 5,000 per taak

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"]

// 02 · antwoord

Wat je terugkrijgt

JSON, in elke taal hetzelfde. Velden die Tomba niet kent zijn null, nooit gegokt.

GET/author-finderVeld

data.emailstring | null: The address, or null when none is found
data.scoreinteger: Confidence from 0 to 100
data.verification.statusstring | null: valid, accept_all, invalid or unknown, with verification.date
data.full_name, data.position, data.departmentstring | null: Name, job title and team
data.typestring | null: personal or generic (a role address such as sales@)
data.linkedin, data.twitterstring | null: Public profiles
data.sources[]array | null: Up to 20 public pages where the address was found, with dates
data.info.title, data.info.publisher_name, data.info.publish_datestring: The article, who published it and when
data.info.candidates[]array | null: Every author candidate on the page, with a name confidence and score

POST /bulk/author

201 Created

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

Elke rij, zoals GET /author-finder die teruggeeft

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 · kosten en limieten

Wat een aanroep kost

Een aanroep wordt alleen in rekening gebracht onder de voorwaarde hieronder. Rate limits hangen af van je abonnement.

// kosten

1 search credit per article with an author address.

Charged once, at the first download; later downloads are free

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)

// faq

Frequently Asked Questions

Nog vragen? Bezoek het helpcentrum

Doe je eerste aanroep binnen een minuut

Gratis account, echte API-sleutel, dezelfde endpoints die Enterprise-klanten gebruiken.

1Maak een gratis account aan25 zoekopdrachten per maand. Geen creditcard.

2Kopieer je sleutel en secretOnder API-sleutels in het dashboard.

3Roep de API aanPlak het verzoek; het antwoord is 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": [] } }

Bulk Author Finder API

Bulk Author Finder is één HTTPS-verzoek

Wat je terugkrijgt

Wat een aanroep kost

Gerelateerde endpoints

Frequently Asked Questions

Doe je eerste aanroep binnen een minuut