// post /v1/reveal/search
Company Reveal API
Получите полную информацию о компании по любому домену отрасль, выручка, численность персонала, технологический стек, социальные профили и верифицированные контакты лиц, принимающих решения, одним API-запросом.
// консоль api
- companies
- 1 item
- companies[0].name
- Pied Piper
- companies[0].website_url
- piedpiper.com
- companies[0].industry
- computer software
- companies[0].company_size
- 11-50
- companies[0].city
- Palo Alto
- companies[0].founded
- 2014
- companies[0].total_emails
- 48
// 01 · запрос
«Company Search» — это один HTTPS-запрос
Отправьте параметры с вашим ключом и секретом. Все SDK, CLI и MCP-сервер выполняют этот же вызов.
/reveal/searchqueryобязательный- What you are looking for, in plain language
page1- Result page
curl -X POST https://api.tomba.io/v1/reveal/search \
-H "X-Tomba-Key: $TOMBA_API_KEY" \
-H "X-Tomba-Secret: $TOMBA_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Compression startups in California","page":1}'const res = await fetch("https://api.tomba.io/v1/reveal/search", {
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({"query":"Compression startups in California","page":1})
});
const { data } = await res.json();import os, requests
res = requests.post(
"https://api.tomba.io/v1/reveal/search",
headers={
"X-Tomba-Key": os.environ["TOMBA_API_KEY"],
"X-Tomba-Secret": os.environ["TOMBA_SECRET_KEY"],
},
json={"query":"Compression startups in California","page":1},
)
data = res.json()["data"]// 02 · ответ
Что возвращается
JSON, одинаковый на любом языке. Поля, которые Tomba не знает, равны null — без догадок.
/reveal/searchdata.companies[]array | null- Name, website, description, industry, size, type, founded, revenue, location, social links
data.companies[].total_emailsinteger- Addresses Tomba holds for the company
data.companies[].total_similarinteger- Similar companies Tomba knows
meta.total, meta.pagesinteger- Companies that match, and pages
meta.page, meta.limitinteger- This page and its size
meta.filtersobject- The filters Tomba read from your query
{
"success": true,
"data": {
"companies": [
{
"name": "Pied Piper",
"description": "Middle-out compression for files and video.",
"country": "US",
"state": "California",
"city": "Palo Alto",
"street_address": "5230 Newell Road",
"postal_code": "94303",
"industry": "computer software",
"company_size": "11-50",
"type": "privately held",
"founded": "2014",
"website_url": "piedpiper.com",
"total_emails": 48,
"revenue": "",
"phone_number": false,
"linkedin_url": "https://www.linkedin.com/company/pied-piper",
"facebook_url": "",
"twitter_url": "",
"total_similar": 2
}
]
},
"meta": {
"total": 64,
"page": 1,
"limit": 10,
"pages": 7,
"filters": {
"location_state": {
"include": [
"California"
]
},
"industry": {
"include": [
"computer software"
]
}
}
}
}// 03 · стоимость и лимиты
Сколько стоит вызов
Вызов оплачивается только при условии, указанном ниже. Лимиты запросов зависят от вашего тарифа.
// стоимость
1search credit
Когда списывается: At least one company is returned.
Ошибки, ответы 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. Лимиты запросов