// массовые операции
Массовый поиск телефонов
Загрузите CSV с контактами и найдите номера телефонов для всех них одновременно.
- 01pending
POST /v1/bulk/phone-finder201 · { "data": { "id": 1042 } } - 02running
launch: trueход выполнения запрашивается через GET /v1/bulk/phone-finder/1042/progress - 03completed
bulk.completedподписанный вебхук доставлен на ваш webhook_url
GET /v1/bulk/phone-finder/1042/download?file=fullОплата при первой загрузке · задача хранится 180 дней// 01 · входные данные
Входные данные массовой задачи «Phone Finder»
Загрузите CSV размером до 4 МБ в приложении или отправьте список, строки или файл на POST /v1/bulk/phone-finder. Столбцы определяются по строке заголовков; укажите индекс поля, чтобы выбрать столбец самостоятельно.
/bulk/phone-finderСтолбцыdomain_field_index- Domain
email_field_index- Email address
linkedin_url_field_index- LinkedIn profile URL
/bulk/phone-finderПараметрыfind_all_phones- true returns every phone number found instead of one
// 02 · api
Один запрос запускает задачу
Создайте и запустите задачу одним вызовом, затем следите за ходом выполнения или получите подписанное событие bulk.completed. Каждая строка результата — это то, что возвращает GET /phone-finder.
curl -X POST "https://api.tomba.io/v1/bulk/phone-finder" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Phone Finder job","list":"richard@piedpiper.com","launch":true,"webhook_url":"https://hooks.example.com/tomba"}'const res = await fetch("https://api.tomba.io/v1/bulk/phone-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": "Phone Finder job",
"list": "richard@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/phone-finder",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={
"name": "Phone Finder job",
"list": "richard@piedpiper.com",
"launch": True,
"webhook_url": "https://hooks.example.com/tomba"
},
)
job_id = res.json()["data"]["id"]{
"data": {
"id": 1042
}
}{
"email": "richard@piedpiper.com",
"data": {
"email": "richard@piedpiper.com",
"valid": true,
"local_format": "(650) 555-0132",
"intl_format": "+1 650-555-0132",
"e164_format": "+16505550132",
"rfc3966_format": "tel:+1-650-555-0132",
"country_code": "US",
"line_type": "MOBILE",
"carrier": "AT&T",
"region": {
"name": "California",
"code": "CA"
},
"timezones": [
"America/Los_Angeles"
]
}
}// 03 · стоимость и лимиты
Сколько стоит задача
Создание и запуск задачи бесплатны. Её стоимость списывается один раз — при первой загрузке результатов.
// оплата за строку
5 search credits per row with at least one phone number.
Оплата массовых задач в документации- Строк: до 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 · используйте где угодно
Запускайте задачи «Phone Finder» из приложения или из своего кода
Та же задача, те же кредиты: загрузите файл в приложении, вызовите API или работайте из таблицы или no-code-инструмента.
- REST APIJSON по HTTPS, 13 SDK, подписанные вебхуки.
GET /v1/phone-finder - Массовая обработка CSVЗагрузите список в приложении или отправьте его POST-запросом на /bulk; скачайте результат, когда всё будет готово.
POST /v1/bulk/{type} - Google Sheets и ExcelФормулы и боковая панель, которые вызывают те же эндпоинты.
=TOMBA_PHONE(A2) - Zapier, Make, n8nNo-code-действия для поиска, проверки и обогащения.
Zapier · Make · n8n · Pipedream
Полный справочник по запросу: /api/bulk/phone-finder
// клиенты
Команды, которые запускают задачи «Phone Finder»
I've tested over a dozen providers, and Tomba.io stands out. The mobile phone finder is on another level instantly better than any other tool I've tested.
Al AminFounder & CEO, BizniftTomba.io keeps getting better every day. I've been using it since 2021. It's now a leading solution for email finding, verification, and easily finding mobile numbers.
Osama AhmedSEO Ninja, BYTEBEX