// массовые операции
Массовый поиск email
Загрузите CSV с именами и доменами для поиска всех профессиональных адресов электронной почты одновременно.
- 01pending
POST /v1/bulk/finder201 · { "data": { "id": 1042 } } - 02running
launch: trueход выполнения запрашивается через GET /v1/bulk/finder/1042/progress - 03completed
bulk.completedподписанный вебхук доставлен на ваш webhook_url
GET /v1/bulk/finder/1042/download?file=fullОплата при первой загрузке · задача хранится 180 дней// 01 · входные данные
Входные данные массовой задачи «Email Finder»
Загрузите CSV размером до 4 МБ в приложении или отправьте список, строки или файл на POST /v1/bulk/finder. Столбцы определяются по строке заголовков; укажите индекс поля, чтобы выбрать столбец самостоятельно.
/bulk/finderСтолбцыdomain_field_index- Domain
company_name_field_index- Company name
first_name_field_index, last_name_field_index- First name, last name
full_name_field_index- Full name
/bulk/finderПараметрыfind_phones- true adds phone numbers, at an extra cost
include_sources- true adds the web pages where each address was found
skip_rows_with_email- true skips rows that already have a value in an email column
// 02 · api
Один запрос запускает задачу
Создайте и запустите задачу одним вызовом, затем следите за ходом выполнения или получите подписанное событие bulk.completed. Каждая строка результата — это то, что возвращает GET /email-finder.
curl -X POST "https://api.tomba.io/v1/bulk/finder" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Conference leads","data":[["first_name","last_name","company_website"],["Richard","Hendricks","piedpiper.com"]],"launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/finder", {
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": "Conference leads",
"data": [
[
"first_name",
"last_name",
"company_website"
],
[
"Richard",
"Hendricks",
"piedpiper.com"
]
],
"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/finder",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Conference leads",
"data": [
[
"first_name",
"last_name",
"company_website"
],
[
"Richard",
"Hendricks",
"piedpiper.com"
]
],
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"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": []
}
}// 03 · стоимость и лимиты
Сколько стоит задача
Создание и запуск задачи бесплатны. Её стоимость списывается один раз — при первой загрузке результатов.
// оплата за строку
1 search credit per row whose address is verified valid. Plus 5 per row with phone data.
Оплата массовых задач в документации- Строк: до 10,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 · используйте где угодно
Запускайте задачи «Email Finder» из приложения или из своего кода
Та же задача, те же кредиты: загрузите файл в приложении, вызовите API или работайте из таблицы или no-code-инструмента.
- REST APIJSON по HTTPS, 13 SDK, подписанные вебхуки.
GET /v1/email-finder - Массовая обработка CSVЗагрузите список в приложении или отправьте его POST-запросом на /bulk; скачайте результат, когда всё будет готово.
POST /v1/bulk/{type} - Google Sheets и ExcelФормулы и боковая панель, которые вызывают те же эндпоинты.
=TOMBA_FIND(A2, B2) - Zapier, Make, n8nNo-code-действия для поиска, проверки и обогащения.
Zapier · Make · n8n · Pipedream
Полный справочник по запросу: /api/bulk/email-finder
// тест на 5 000 лидах
Больше действительных email, чем у восьми других протестированных инструментов
Реальные данные. Одинаковый вход. Без ручной обработки. Полная прозрачность. Мы провели прямое сравнение, прогнав один и тот же файл из 5 000 строк через несколько сервисов поиска адресов.
| Место | Инструмент | По сайтам | По названиям компаний | Итого |
|---|---|---|---|---|
| 1 |  Tomba.ioСайты 2,026 · 81.0% Имена 1,989 · 79.6% | 2,02681.0% | 1,98979.6% | 4,015 |
| 2 | 1,91876.7% | 1,95778.3% | 3,875 | |
| 3 | 1,88075.2% | 1,87775.1% | 3,757 | |
| 4 | 1,48359.3% | 1,61364.5% | 3,096 | |
| 5 | 1,00140.0% | 1,14145.6% | 2,142 | |
| 6 | 88735.5% | 99539.8% | 1,882 | |
| 7 | 1,05142.0% | 74930.0% | 1,800 | |
| 8 | 98839.5% | Менее 1% найдено по названиям компаний: инструменту нужен сайт или домен:190.8% | 1,007 | |
| 9 | 82433.0% | Менее 1% найдено по названиям компаний: инструменту нужен сайт или домен:220.9% | 846 |
Tomba.io нашёл 4,015 действительных email из 5,000 лидов: #1 из 9 протестированных инструментов.
Собственный тест Tomba, февраль 2026 года. Один файл из 5 000 лидов — 2 500 с сайтом компании и 2 500 только с названием компании — прошёл через каждый инструмент без ручной очистки. Учитываются только адреса, которые инструмент пометил как действительные или проверенные; проценты рассчитаны от 2 500 входных данных каждого типа.
Менее 1% найдено по названиям компаний: инструменту нужен сайт или домен.