// массовые операции
Массовая верификация email
Загрузите CSV с адресами электронной почты и проверьте их все на доставляемость одновременно.
- 01pending
POST /v1/bulk/verifier201 · { "data": { "id": 1042 } } - 02running
launch: trueход выполнения запрашивается через GET /v1/bulk/verifier/1042/progress - 03completed
bulk.completedподписанный вебхук доставлен на ваш webhook_url
GET /v1/bulk/verifier/1042/download?file=fullОплата при первой загрузке · задача хранится 180 дней// 01 · входные данные
Входные данные массовой задачи «Email Verifier»
Загрузите CSV размером до 4 МБ в приложении или отправьте список, строки или файл на POST /v1/bulk/verifier. Столбцы определяются по строке заголовков; укажите индекс поля, чтобы выбрать столбец самостоятельно.
/bulk/verifierСтолбцыemail_field_index- Email address
/bulk/verifierПараметрыfind_phones- true adds phone numbers, at an extra cost
include_sources- true adds the web pages where each address was found
// 02 · api
Один запрос запускает задачу
Создайте и запустите задачу одним вызовом, затем следите за ходом выполнения или получите подписанное событие bulk.completed. Каждая строка результата — это то, что возвращает GET /email-verifier.
curl -X POST "https://api.tomba.io/v1/bulk/verifier" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Email Verifier job","list":"richard@piedpiper.com\njohn@example.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/verifier", {
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": "Email Verifier job",
"list": "richard@piedpiper.com\njohn@example.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/verifier",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Email Verifier job",
"list": "richard@piedpiper.com\njohn@example.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"data": {
"email": {
"email": "richard@piedpiper.com",
"result": "deliverable",
"status": "valid",
"score": 99,
"smtp_provider": "Google",
"mx": {
"records": [
"aspmx.l.google.com",
"alt1.aspmx.l.google.com"
]
},
"mx_check": true,
"smtp_server": true,
"smtp_check": true,
"accept_all": false,
"greylisted": false,
"block": false,
"gibberish": false,
"disposable": false,
"webmail": false,
"regex": true,
"whois": {
"registrar_name": null,
"referral_url": null,
"created_date": null
}
},
"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": null
}
}// 03 · стоимость и лимиты
Сколько стоит задача
Создание и запуск задачи бесплатны. Её стоимость списывается один раз — при первой загрузке результатов.
// оплата за строку
1 verification credit per row, except disposable addresses. Plus 5 search credits per row with phone data.
Оплата массовых задач в документации- Строк: до 20,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 Verifier» из приложения или из своего кода
Та же задача, те же кредиты: загрузите файл в приложении, вызовите API или работайте из таблицы или no-code-инструмента.
- REST APIJSON по HTTPS, 13 SDK, подписанные вебхуки.
GET /v1/email-verifier - Массовая обработка CSVЗагрузите список в приложении или отправьте его POST-запросом на /bulk; скачайте результат, когда всё будет готово.
POST /v1/bulk/{type} - Google Sheets и ExcelФормулы и боковая панель, которые вызывают те же эндпоинты.
=TOMBA_VERIFY(A2) - Zapier, Make, n8nNo-code-действия для поиска, проверки и обогащения.
Zapier · Make · n8n · Pipedream
Полный справочник по запросу: /api/bulk/email-verifier
// клиенты
Команды, которые запускают задачи «Email Verifier»
Tomba is my go-to to validate emails. Even in a waterfall process with multiple tools, Tomba is usually the top choice.
Nuno PoçoSales Automation Architect, clickworks.ioThe data is always fresh, and the n8n integration is excellent. Support is very responsive. I'd rate it 9/10.
Benjie MalinaoCo-Founder & CTO, Channel Automation