一括著者メール検索の概要

一括著者検索は、記事URLの一覧からメールアドレスを抽出するための専門ツールです。動作の確認には、著者検索を使用して個別検索を行うことができます。

取得したメールアドレスの精度の評価

著者検索はウェブ上で公開されているメールアドレスを取得します。これらのメールの精度を判断するために、ソースの信頼性、SMTP検証、ウェブページ上のコンテキストなどの要因に基づいて、各メールに信頼スコアが割り当てられます。

一括著者検索のアクセスと料金

一括著者検索へのアクセスは無料アカウントを通じて提供され、必要なリクエスト数に応じてさまざまなプランがあります。アップグレードする前にお試しが可能です。CSVファイルをアップロードして、見つかったメールアドレスの量と品質を確認し、必要なリクエスト数を見積もり、データのプレビューを見ることができます。サブスクリプションはいつでもキャンセルできます。

一括著者検索は電話番号も返しますか？

はい。公開されている場合、著者のメールアドレスに加えて電話番号も結果に含まれます。そのため、各記事URLから1回の実行でより充実した連絡先プロフィールを取得できます。

どのファイル形式や制限が適用されますか？

1行につき1つの記事URLを含むCSVまたはTXTを、1バッチあたり最大5,000行までアップロードできます。結果はCSV、XLSX、JSONとしてエクスポートするか、Google Sheets、Excel、Zapier、Makeに直接同期できます。

英語以外の記事も処理できますか？

はい。一括著者検索はあらゆる言語やドメインのTLDに対応しているため、国際的な出版物、ブログ、ニッチなメディアサイトもすべてサポートされています。

記事に著者や連絡先データがない場合はどうなりますか？

一致しなかった行はクレジットを消費しません。解決された著者のメールアドレスに対してのみ料金が発生するため、ノイズの多いURLリストをアップロードしても安全で費用対効果に優れています。

// 一括操作

一括著者検索

記事URLのCSVをアップロードして、すべての著者のメールアドレスを一度に検索します。

一括処理を開始 APIを見る

Article URLs1ジョブ最大 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: trueGET /v1/bulk/author/1042/progress で進捗をポーリング
03completedbulk.completedwebhook_url に署名付き Webhook を配信

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

1回のリクエストでジョブを開始

1回の呼び出しで作成と開始を行い、進捗を確認するか、署名付きの 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回だけ請求されます。

// 行ごとの課金

1 search credit per article with an author address.

ドキュメントの一括処理の課金

行数：1ジョブあたり最大 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

// faq

よくある質問

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

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