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?

処理時間はURLの数によって異なります。通常はURL1件あたり2〜3秒です。5,000件のURLのバッチは通常数時間以内に完了します。

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.

無料 API キーを取得 API リファレンス

Article URLs最大 5,000 行

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 · リクエスト

一括Author Finder は1回の HTTPS リクエストです

キーとシークレットとともにパラメーターを送信します。すべての SDK、CLI、MCP サーバーがこれと同じ呼び出しを行います。

type: author
list | data | file: Article URLs
launch: true ですぐにジョブを開始
webhook_url: ジョブ終了時に署名付きイベントを受信
rows: 1ジョブあたり最大 5,000 行

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 · レスポンス

返される内容

どの言語でも同じ JSON です。Tomba が把握していないフィールドは null となり、推測はしません。

GET/author-finderフィールド

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

各行は 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.

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

ほかにご質問がありますか？ヘルプセンターを見る

1分で最初の呼び出しを

無料アカウント、本物の API キー、Enterprise のお客様と同じエンドポイント。

1無料アカウントを作成月25回の検索。カード不要。

2キーとシークレットをコピーダッシュボードの「API キー」から。

3API を呼び出すリクエストを貼り付けると、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

一括Author Finder は1回の HTTPS リクエストです

返される内容

呼び出しの料金

関連エンドポイント

Frequently Asked Questions

1分で最初の呼び出しを