API Данные о компаниях
Данные уровня компаний, без сведений о людях и контактных данных. enrich получает профиль компании по домену, peers выдаёт её прямых аналогов и крупных конкурентов, search находит компании по описанию в одно предложение, а brand_search ищет бренды по названию или началу домена.
Компания определяется по домену, например stripe.com; подойдёт и ссылка на сайт. Профили, аналоги и результаты поиска берутся из разных наборов данных, поэтому размер и отрасль в разных действиях сформулированы по-разному.
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Данные о компаниях: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Профиль компанииenrich | Получите профиль компании по домену: название, слоган, описание, отрасль, тип, диапазон численности сотрудников, год основания, LinkedIn и ссылки на соцсети, адреса офисов и оценка уверенности в совпадении. | $10.4 за 1 000 запросов | Норма |
Компании-аналоги и конкурентыpeers | Получите список прямых аналогов и крупных конкурентов компании по домену с кратким описанием того, как каждый из них конкурирует. | $20 за 1 000 запросов | Норма |
Поискsearch | Находите компании по описанию из одного предложения, при необходимости с фильтром по стране и численности сотрудников: штаб-квартира, численность, оценка выручки, стадия финансирования и раунды. | $3.19 за 1 000 запросов | Норма |
Поиск брендовbrand_search | Находите бренды по названию, домену или первым буквам любого из них: домен, описание, страна и язык сайта. | $0.56 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Данные о компаниях?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
enrichПрофиль компании Получите профиль компании по домену: название, слоган, описание, отрасль, тип, диапазон численности сотрудников, год основания, LinkedIn и ссылки на соцсети, адреса офисов и оценка уверенности в совпадении. | domain | — | Режим выдачи: Sync | — | $10.4 за 1 000 запросов | name · domain · headline · description · industry · company_type · size · founded · linkedin_url · socials · locations · match_confidence · platform |
peersКомпании-аналоги и конкуренты Получите список прямых аналогов и крупных конкурентов компании по домену с кратким описанием того, как каждый из них конкурирует. | domain | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $20 за 1 000 запросов | name · description · peer_type · platform |
searchПоиск Находите компании по описанию из одного предложения, при необходимости с фильтром по стране и численности сотрудников: штаб-квартира, численность, оценка выручки, стадия финансирования и раунды. | keyword | country, employees_max, employees_min | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=10. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $3.19 за 1 000 запросов | name · domain · description · organization_type · operating_status · industries · founded_year · hq_country_code · hq_region · hq_city · hq_street_address · hq_postal_code · employee_count · employees_min · employees_max · revenue_min_usd · revenue_max_usd · funding_total_usd · funding_round_count · funding_stage · latest_round · funding_rounds · platform |
brand_searchПоиск брендов Находите бренды по названию, домену или первым буквам любого из них: домен, описание, страна и язык сайта. | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=10. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | name · domain · description · country · language · logo_url · platform |
Что означают параметры действия enrich в API Данные о компаниях?
Получите профиль компании по домену: название, слоган, описание, отрасль, тип, диапазон численности сотрудников, год основания, LinkedIn и ссылки на соцсети, адреса офисов и оценка уверенности в совпадении.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеdomainОбязательный- Домен компании или ссылка на сайт, например
stripe.comилиhttps://www.notion.com/; схема,www.и путь отбрасываются. Всё, что не является доменом, отклоняется до списания средств.
Что означают параметры действия peers в API Данные о компаниях?
Получите список прямых аналогов и крупных конкурентов компании по домену с кратким описанием того, как каждый из них конкурирует.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеdomainОбязательный- Домен компании или ссылка на сайт, например
stripe.comилиhttps://www.notion.com/; схема,www.и путь отбрасываются. Всё, что не является доменом, отклоняется до списания средств.
Что означают параметры действия search в API Данные о компаниях?
Находите компании по описанию из одного предложения, при необходимости с фильтром по стране и численности сотрудников: штаб-квартира, численность, оценка выручки, стадия финансирования и раунды.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательныйsearch: описание искомых компаний одним предложением, до 500 символов, напримерpayment infrastructure companies in Ireland.brand_search: название бренда, домен или первые буквы одного из них, до 100 символов, напримерnotionилиnik.countryНеобязательный- Только компании со штаб-квартирой в этой стране; двухбуквенный код, например US, GB или IE (
search).ISO: коды стран ISO 3166 — На официальной странице ISO объясняется, что ISO 3166-1 обозначает страны двухбуквенными кодами; именно это означают US, GB или IE в `country`. Где находится штаб-квартира компании, определяется возвращаемыми данными, а не этим стандартом. · Проверено employees_maxНеобязательный- Максимальная численность сотрудников для
search. employees_minНеобязательный- Минимальная численность сотрудников для
search; учитываются компании, чей диапазон численности пересекается с заданным.
Что означают параметры действия brand_search в API Данные о компаниях?
Находите бренды по названию, домену или первым буквам любого из них: домен, описание, страна и язык сайта.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательныйsearch: описание искомых компаний одним предложением, до 500 символов, напримерpayment infrastructure companies in Ireland.brand_search: название бренда, домен или первые буквы одного из них, до 100 символов, напримерnotionилиnik.
Как использовать API Данные о компаниях
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"company_data","action":"enrich","params":{"domain":"<domain>"}}'
Вопросы об API Данные о компаниях
Какие данные можно получить через API Данные о компаниях?
Укажите в platform значение company_data. В текущем каталоге: профиль компании, компании-аналоги и конкуренты, поиск и поиск брендов. Эти названия действий соответствуют разным объектам или представлениям Данные о компаниях; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса enrich к платформе Данные о компаниях?
Домен компании или ссылка на сайт, например stripe.com или https://www.notion.com/; схема, www. и путь отбрасываются. Всё, что не является доменом, отклоняется до списания средств. Передайте это значение в поле domain объекта params.
Какие поля может вернуть enrich на платформе Данные о компаниях?
Объявленная схема включает name, domain, headline и description. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Данные о компаниях возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.