一括著者検索 API はどのように機能しますか？

記事の URL をアップロードして一括処理を作成し、処理を開始します。API がすべての URL について著者情報を抽出し、メールアドレスを非同期で検索します。

最大バッチサイズは？

一括処理1回につき最大10,000件の記事 URL を処理できます。それ以上のデータセットは、複数の一括処理を作成してください。

どの種類の URL に対応していますか？

ブログ記事、ニュース記事、そして WordPress、Medium、Ghost、独自のパブリッシングシステムなど、ほとんどの CMS のコンテンツページに対応しています。

どのような結果が返されますか？

各結果には、著者のメールアドレス、氏名、企業、役職、LinkedIn プロフィール、信頼度スコア、情報が見つかったソースが含まれます。

処理にはどのくらい時間がかかりますか？

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

クレジットはどのように計算されますか？

著者のメールアドレスが返った URL ごとに1リクエストとしてカウントされます。著者のメールアドレスが見つからなかった URL はクォータにカウントされません。

Webhook に対応していますか？

はい。Webhook URL を設定すると、一括著者検索の処理が完了し、結果をダウンロードできるようになったときに通知を受け取れます。

記事に複数の著者がいる場合は？

API はメインの著者のメールアドレスを返します。複数の著者がいる記事には、著者検索 API を個別に呼び出すことを検討してください。

デジタル PR やジャーナリストへのアウトリーチに使えますか？

はい。一括著者検索でメディアや寄稿者のリストを大規模に作成し、信頼度の高い連絡先をアウトリーチのシーケンスに回しているチームがあります。

一致精度を高めるには？

抽出の質を最大化するために、正規の記事 URL を指定し、トップページやカテゴリページを避け、送信前に重複する URL を削除してください。

// post /v1/bulk/author

一括著者検索 API

Q: Webhook に対応していますか？

はい。Webhook URL を設定すると、 一括著者検索 の処理が完了し、結果をダウンロードできるようになったときに通知を受け取れます。

Q: 記事に複数の著者がいる場合は？

API はメインの著者のメールアドレスを返します。複数の著者がいる記事には、 著者検索 API を個別に呼び出すことを検討してください。

1回の非同期一括リクエストで、何千もの記事 URL を検証済みの著者連絡先レコードに変換します。

無料 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

よくある質問

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

一括著者検索 API

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

返される内容

呼び出しの料金

関連エンドポイント

よくある質問

どの企業でも、Tomba が見つける人を確認