// массовые задачи
Обрабатывайте тысячи 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 · типы массовых задач
Одна модель задач для любого списка
Каждый тип массовой задачи выполняет один эндпоинт Tomba по списку с одинаковыми шагами: создание, запуск, отслеживание и загрузка.
| Тип задачи | Входные данные | API | Макс. строк | |
|---|---|---|---|---|
| Массовый Domain Search | Domains or company names | POST/bulk/search | 25,000 | |
| Массовый Similar Domains | Domains or company names | POST/bulk/similar | 5,000 | |
| Массовый Company Enrichment | Domains or company names | POST/bulk/company | 25,000 | |
| Массовый Email Finder | Names, with a domain or company name | POST/bulk/finder | 10,000 | |
| Массовый Email Enrichment | Email addresses | POST/bulk/enrich | 20,000 | |
| Массовый LinkedIn Finder | LinkedIn profile URLs | POST/bulk/linkedin | 20,000 | |
| Массовый Author Finder | Article URLs | POST/bulk/author | 5,000 | |
| Массовый Email Verifier | Email addresses | POST/bulk/verifier | 20,000 | |
| Массовый Phone Finder | Email addresses, LinkedIn URLs or domains | POST/bulk/phone-finder | 10,000 | |
| Массовый Phone Validator | Phone numbers, with an optional country | POST/bulk/phone-validator | 10,000 |
Прокрутите вбок, чтобы увидеть все столбцы
// 02 · жизненный цикл
Как выполняется массовая задача
Те же четыре шага в приложении и через API.
- 01
Создание
Отправьте POST со списком, строками или CSV до 4 МБ на /v1/bulk/{type} или загрузите файл в приложении.
- 02
Запуск
Укажите launch: true или запустите позже. Tomba проверит, что у вас достаточно кредитов для задачи.
- 03
Отслеживание
Запрашивайте ход выполнения или получите подписанное событие bulk.completed на ваш webhook_url.
- 04
Загрузка
Получите результаты в CSV. Задача оплачивается один раз, при первой загрузке, и хранится 180 дней.
// 03 · лимиты и оплата
Что нужно учесть
На массовые задачи не распространяются лимиты запросов тарифа; у них свои лимиты для каждого рабочего пространства.
- 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)
- Charged once, at the first download; later downloads are free
- Массовые задачи в документации