// массовые операции
Массовый поиск авторов
Загрузите CSV с URL статей и найдите адреса электронной почты всех авторов одновременно.
Article URLsДо 5,000 строк в задачеCSV, список или строки
author-finder-list.csvСтрок: 2,500 · article urlscompleted
Массовый Author Finder · /bulk/author2,500 / 2,500
- 01pending
POST /v1/bulk/author201 · { "data": { "id": 1042 } } - 02running
launch: trueход выполнения запрашивается через GET /v1/bulk/author/1042/progress - 03completed
bulk.completedподписанный вебхук доставлен на ваш webhook_url
GET /v1/bulk/author/1042/download?file=fullОплата при первой загрузке · задача хранится 180 дней// 01 · входные данные
Входные данные массовой задачи «Author Finder»
Загрузите CSV размером до 4 МБ в приложении или отправьте список, строки или файл на POST /v1/bulk/author. Столбцы определяются по строке заголовков; укажите индекс поля, чтобы выбрать столбец самостоятельно.
POST
/bulk/authorСтолбцыurl_field_index- Article URL
POST
/bulk/authorПараметрыinclude_sources- true adds the web pages where each address was found
// 02 · api
Один запрос запускает задачу
Создайте и запустите задачу одним вызовом, затем следите за ходом выполнения или получите подписанное событие bulk.completed. Каждая строка результата — это то, что возвращает GET /author-finder.
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"]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.
Оплата массовых задач в документации- Строк: до 5,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 · используйте где угодно
Запускайте задачи «Author Finder» из приложения или из своего кода
Та же задача, те же кредиты: загрузите файл в приложении, вызовите API или работайте из таблицы или no-code-инструмента.
- REST APIJSON по HTTPS, 13 SDK, подписанные вебхуки.
GET /v1/author-finder - Массовая обработка CSVЗагрузите список в приложении или отправьте его POST-запросом на /bulk; скачайте результат, когда всё будет готово.
POST /v1/bulk/{type} - Google Sheets и ExcelФормулы и боковая панель, которые вызывают те же эндпоинты.
=TOMBA_AUTHOR(A2) - Zapier, Make, n8nNo-code-действия для поиска, проверки и обогащения.
Zapier · Make · n8n · Pipedream
Полный справочник по запросу: /api/bulk/author-finder
// клиенты
Команды, которые запускают задачи «Author Finder»
Tomba finding the contacts for the perfect prospects at scale is game changing in helping us promote our data-based research studies.
Nicholas RizzoSenior Digital Manager, VizmeTomba has been critical to my SEO and cold outreach workflow. None matched Tomba's accuracy or the depth of contact details it returns.
Henry HoeSEO & Sales Outreach Specialist
Массовый поиск авторов это специализированный инструмент для извлечения адресов электронной почты из набора URL статей. Чтобы понять, как он работает, можно провести отдельный поиск с помощью поиска авторов.
Поиск авторов получает адреса электронной почты, публично доступные в интернете. Чтобы помочь вам определить точность этих email, каждому присваивается оценка достоверности, основанная на таких факторах, как надёжность источника, проверки SMTP и контекст на веб-страницах.
Доступ к массовому поиску авторов предоставляется через бесплатный аккаунт с различными тарифами в зависимости от необходимого количества запросов. Пробный запуск возможен до оформления подписки. Вы можете загрузить CSV-файл, чтобы оценить объём и качество найденных адресов, рассчитать необходимое количество запросов и предварительно просмотреть данные. Подписку можно отменить в любой момент.