// get /v1/domain-search
API поиска по домену API
Найдите все email-адреса, номера телефонов, данные компании и профили сотрудников, связанные с любым корпоративным доменом. Фильтрация по отделу, уровню, стране и другим параметрам.
1 per 10 search credits
// консоль api
Пример ответа из справочника API
- organization.organization
- Pied Piper
- organization.industries
- computer software
- organization.company_size
- 11-50
- organization.pattern
- {first}
- organization.accept_all
- false
- emails
- 2 items
- emails[0].email
- dinesh@piedpiper.com
- emails[0].position
- Software Engineer
- emails[0].verification.status
- valid
// 01 · запрос
«Domain Search» — это один HTTPS-запрос
Отправьте параметры с вашим ключом и секретом. Все SDK, CLI и MCP-сервер выполняют этот же вызов.
GET
/domain-searchПараметрdomainpiedpiper.com- Company domain (or send company)
limit10- Results per page, from 1 to 5,000 (at most 10 on the Free plan)
departmentengineering- Filter by team
countryUS- Filter by country
curl "https://api.tomba.io/v1/domain-search?domain=piedpiper.com" \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY"const res = await fetch("https://api.tomba.io/v1/domain-search?domain=piedpiper.com", {
headers: {
"X-Tomba-Key": process.env.TOMBA_API_KEY,
"X-Tomba-Secret": process.env.TOMBA_SECRET_KEY
}
});
const { data } = await res.json();import os, requests
res = requests.get(
"https://api.tomba.io/v1/domain-search?domain=piedpiper.com",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
)
data = res.json()["data"]// 02 · ответ
Что возвращается
JSON, одинаковый на любом языке. Поля, которые Tomba не знает, равны null — без догадок.
GET
/domain-searchПолеdata.organizationobject- Company name, location, social links, industry, size, revenue, description, pattern
data.organization.accept_allboolean- The domain accepts mail for any address (catch-all)
data.emails[].emailstring- Each address found
data.emails[].full_name, data.emails[].position, data.emails[].departmentstring | null- Name, job title and team
data.emails[].senioritystring | null- junior, senior or executive
data.emails[].scoreinteger- Confidence from 0 to 100
data.emails[].verification.statusstring | null- valid, accept_all, invalid or unknown, with verification.date
data.emails[].sources[]array- Where each address was found
meta.total, meta.total_pagesinteger- Addresses that match, and pages at this pageSize
meta.current, meta.pageSizeinteger- This page and its size
meta.paramsobject- The parameters the search ran with
GET /domain-search
200 OK· 1 per 10 search credits
{
"data": {
"organization": {
"website_url": "piedpiper.com",
"organization": "Pied Piper",
"location": {
"country": "US",
"city": "Palo Alto",
"state": "CA",
"street_address": "5230 Newell Road",
"postal_code": "94303"
},
"social_links": {
"twitter_url": null,
"facebook_url": null,
"instagram_url": null,
"linkedin_url": "https://www.linkedin.com/company/pied-piper",
"github_url": null,
"youtube_url": null,
"pinterest_url": null,
"tiktok_url": null
},
"disposable": false,
"webmail": false,
"phone_number": false,
"industries": "computer software",
"founded": "2014",
"company_size": "11-50",
"company_type": "privately held",
"revenue": null,
"accept_all": false,
"description": "Pied Piper builds middle-out compression for files, video and a decentralized internet.",
"pattern": "{first}",
"total_similar": 2,
"keywords": [
"compression",
"middle-out",
"decentralized internet"
],
"ranking": null,
"whois": {
"registrar_name": null,
"created_date": null,
"referral_url": null
},
"last_updated": "2025-01-15T10:32:00+01:00"
},
"emails": [
{
"email": "dinesh@piedpiper.com",
"first_name": "Dinesh",
"last_name": "Chugtai",
"full_name": "Dinesh Chugtai",
"gender": "male",
"phone_number": false,
"type": "personal",
"country": "US",
"position": "Software Engineer",
"department": "engineering",
"seniority": "senior",
"twitter": null,
"linkedin": null,
"score": 99,
"verification": {
"date": "2025-01-15T10:32:00+01:00",
"status": "valid"
},
"phone_data": [],
"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
}
]
},
{
"email": "gilfoyle@piedpiper.com",
"first_name": "Bertram",
"last_name": "Gilfoyle",
"full_name": "Bertram Gilfoyle",
"gender": "male",
"phone_number": false,
"type": "personal",
"country": "US",
"position": "Systems Architect",
"department": "engineering",
"seniority": "senior",
"twitter": null,
"linkedin": null,
"score": 97,
"verification": {
"date": "2025-01-15T10:32:00+01:00",
"status": "valid"
},
"phone_data": [],
"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
}
]
}
]
},
"meta": {
"total": 12,
"pageSize": 10,
"current": 1,
"total_pages": 2,
"params": {
"domain": "piedpiper.com",
"company": "",
"page": 1,
"limit": 10,
"department": "engineering",
"country": null,
"type": "all",
"live": false,
"enrich_mobile": false,
"webhook_url": null
}
}
}// 03 · стоимость и лимиты
Сколько стоит вызов
Вызов оплачивается только при условии, указанном ниже. Лимиты запросов зависят от вашего тарифа.
// стоимость
1 per 10search credit
Когда списывается: At least one address is returned. 1 credit per 10 results requested with limit.
Ошибки, ответы 429 и 451, а также повтор того же запроса в пределах окна использования ничего не стоят.
Как работают кредиты// лимиты запросов
Запросов в секунду / минуту / день| Free | Basic | Growth | Pro | |
|---|---|---|---|---|
| Search, finder, similar, technology | 1 / 2 / 5 | 3 / 50 / 500 | 5 / 80 / 1,000 | 8 / 150 / 4,000 |
| Email verifier | 1 / 2 / 10 | 2 / 40 / 500 | 3 / 60 / 1,000 | 5 / 100 / 4,000 |
Pro Plus, Scale and credit packs of 50,000 or more: no limit on these endpoints. Enterprise: no per-second or per-minute limit, 100,000 requests a day. Daily limits reset at 00:00 UTC. Лимиты запросов
Каждый запрос возвращает: все известные email-адреса для домена, каждый с полным именем, должностью, отделом, уровнем, страной, URL LinkedIn, номером телефона, оценкой достоверности, статусом верификации, паттерном email, URL источников и временными метками. Данные компании включают отрасль, размер, местоположение, социальные профили и технологический стек.
Вы можете фильтровать по отделу (руководство, маркетинг, HR, IT, продажи, инженерия, финансы и др.), уровню (старший, младший, руководитель), типу email (личный или общий), коду страны и статусу верификации.
Да. При наличии номера телефонов возвращаются для каждого сотрудника, включая тип номера (мобильный, стационарный, бесплатный), страну и форматирование. Данные телефонов включены без дополнительных кредитов для результатов поиска по домену.
Результаты разбиты на страницы до 10 email на запрос. Используйте параметр page для навигации. Мета-объект включает общее количество и детали пагинации. 1 кредит = 1 страница до 10 результатов.
Лимиты зависят от тарифа и эндпоинта, в запросах в секунду / в минуту / в день: Free 1 / 2 / 5, Basic 3 / 50 / 500, Growth 5 / 80 / 1 000, Pro 8 / 150 / 4 000. На Pro Plus и Scale лимитов нет, а Enterprise допускает 100 000 запросов в день без ограничения в секунду. Каждый ответ содержит заголовки с лимитами запросов; подробнее в разделе Лимиты запросов. Для больших списков используйте массовый поиск по домену: до 25 000 доменов за задачу.
Каждый email включает массив источников с URL, где он был найден, датами извлечения, датами последнего обнаружения и статусом видимости. Это помогает проверить актуальность и надёжность данных.
Да. Ответ включает страницу компании в LinkedIn, аккаунт Twitter, страницу Facebook и другие социальные профили при наличии, а также описание компании и классификацию отрасли.
Да. Передайте двухбуквенный код страны (например, US, FR, DE) в качестве параметра запроса, чтобы получить только сотрудников из этой страны. Эта функция была добавлена в обновлении за июнь 2025 года.