> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # Поиск похожих компаний > Поиск компаний, похожих на образцовую компанию. Укажите ровно один единичный идентификатор (`domain_search_id`, `domain`, `linkedin_url` или другой `*_url`); строки содержат `similarity_score` и упорядочены по нему — от наибольшего к наименьшему. ## OpenAPI ````yaml ru-openapi POST /companies/search/similar openapi: 3.0.0 info: description: >- API Pubrio предоставляет данные об экспансии на рынки — сигналы в реальном времени, отмечающие выход компании на новый рынок, — вместе с лежащими в их основе данными о компаниях и людях. Выполняйте поиск, просмотр и обогащение данных об аккаунтах и контактах, а также подписывайтесь на типизированные сигналы движения с указанием даты по более чем 200 рынкам. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ru/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ru/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: Информация о профиле рабочей области и статистика использования - name: Enrichment description: Обогащение записей о людях и компаниях подробными B2B-данными - name: Lookalike description: Поиск компаний, похожих на заданную компанию - name: Search description: >- Поиск людей, компаний, вакансий, новостей и рекламы с использованием фильтров - name: Lookup description: >- Просмотр подробной информации о конкретных людях, компаниях, вакансиях, новостях, рекламе и технологиях - name: LinkedIn description: Просмотр данных о людях и компаниях по URL профиля LinkedIn - name: Redeem description: >- Погашение кредитов для получения контактных данных людей (по одному и пакетно) - name: Channels description: >- Управление шаблонами каналов для рассылок (создание, обновление, удаление, список) - name: Monitor description: >- Создание мониторов данных и управление ими с вебхуками, статистикой и обработкой - name: Filters description: >- Получение доступных значений фильтров для параметров поиска (технологии, местоположения, отрасли и т. д.) - name: API Keys description: >- Просмотр списка и анализ журналов запросов API и статистики использования ключей API - name: Insights description: Агрегированные данные по сигналам компаний (вакансии, новости, реклама). - name: Export description: Массовый экспорт данных (расходует кредиты). - name: Expansion description: 'Данные об экспансии компаний на рынки: сигналы, стадии, рынки и экспорт.' externalDocs: description: >- API Pubrio используется для поиска, предварительного просмотра и обогащения контактов и аккаунтов. База данных Pubrio предоставляет обширные B2B-контакты и данные для анализа продаж. url: https://docs.pubrio.com paths: /companies/search/similar: post: tags: - Lookalike summary: Поиск похожих компаний description: >- Поиск компаний, похожих на образцовую компанию. Укажите ровно один единичный идентификатор (`domain_search_id`, `domain`, `linkedin_url` или другой `*_url`); строки содержат `similarity_score` и упорядочены по нему — от наибольшего к наименьшему. operationId: companies_search_similar parameters: [] requestBody: required: true content: application/json: schema: type: object properties: domain_search_id: type: string description: Идентификатор компании в Pubrio. domain: type: string description: Основной домен компании, например `stripe.com`. example: stripe.com linkedin_url: type: string description: URL страницы компании в LinkedIn. tiktok_url: type: string description: URL профиля компании в TikTok. wantedly_url: type: string description: URL профиля компании в Wantedly. tw104_url: type: string description: URL профиля компании на 104 (Тайвань). rocketpunch_url: type: string description: URL профиля компании в RocketPunch. remember_url: type: string description: URL профиля компании в Remember. youtrust_url: type: string description: URL профиля компании в YOUTRUST. company_name: $ref: '#/components/schemas/company_name' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' locations: $ref: '#/components/schemas/locations' exclude_locations: $ref: '#/components/schemas/exclude_locations' places: $ref: '#/components/schemas/places' exclude_places: $ref: '#/components/schemas/exclude_places' job_locations: $ref: '#/components/schemas/locations' job_exclude_locations: $ref: '#/components/schemas/job_exclude_locations' job_posted_dates: $ref: '#/components/schemas/posted_dates' job_titles: $ref: '#/components/schemas/people_titles' verticals: $ref: '#/components/schemas/verticals' vertical_categories: $ref: '#/components/schemas/vertical_categories' vertical_sub_categories: $ref: '#/components/schemas/vertical_sub_categories' categories: $ref: '#/components/schemas/categories' technologies: $ref: '#/components/schemas/technologies' employees: $ref: '#/components/schemas/employees' revenues: $ref: '#/components/schemas/revenues' founded_dates: $ref: '#/components/schemas/founded_dates' keywords: $ref: '#/components/schemas/keywords' news_categories: $ref: '#/components/schemas/news_categories' news_published_dates: $ref: '#/components/schemas/published_dates' advertisement_search_terms: $ref: '#/components/schemas/advertisement_search_terms' advertisement_target_locations: $ref: '#/components/schemas/advertisement_target_locations' advertisement_exclude_target_locations: $ref: '#/components/schemas/advertisement_exclude_target_locations' advertisement_start_dates: $ref: '#/components/schemas/advertisement_start_dates' advertisement_end_dates: $ref: '#/components/schemas/advertisement_end_dates' filter_conditions: $ref: '#/components/schemas/company_filter_conditions' is_enable_similarity_search: $ref: '#/components/schemas/is_enable_similarity_search' similarity_score: $ref: '#/components/schemas/similarity_score' exclude_fields: $ref: '#/components/schemas/exclude_fields' is_parameter_metadata_available: $ref: '#/components/schemas/is_parameter_metadata_available' is_profile_metadata_available: $ref: '#/components/schemas/is_profile_metadata_available' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' company_filters: $ref: '#/components/schemas/company_filters' anyOf: - title: domain_search_id required: - domain_search_id - title: domain required: - domain - title: linkedin_url required: - linkedin_url - title: tiktok_url required: - tiktok_url - title: wantedly_url required: - wantedly_url - title: tw104_url required: - tw104_url - title: rocketpunch_url required: - rocketpunch_url - title: remember_url required: - remember_url - title: youtrust_url required: - youtrust_url responses: '200': description: Успешный ответ с данными поиска компаний. content: application/json: schema: type: object properties: metadata: type: object description: >- Контекст запроса. Содержит отражённые `filters` и `parameters`, а также блок `profile` с полями `credit`, `topup_credit` и `total_credit_cost` — единственный учёт кредитов на вызов, который возвращает API. data: type: array description: >- Похожие компании, ранжированные по степени схожести. Обратите внимание: этот эндпоинт возвращает простой массив — в отличие от других эндпоинтов поиска, внутри `data` нет обёртки `pagination`. items: type: object example: data: pagination: page: 1 per_page: 25 total_entries: 45234700 total_pages: 1809388 companies: - logo_url: >- https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg company_name: Twitter emails: - ... phones: - ... contacts: - ... founded_year: 2006 specialties: - Software Development industry: Software Development domain: twitter.com domain_search_id: 61a73da7-2efc-41a5-a252-a8a8df29925a domain_id: 224475931 linkedin_company_id: 44005587 linkedin_name: twitter is_company_url_active: true domain_ids: - 224475931 - 1758889566 - 368242865 company_keywords: - realtime information - social commerce - online shopping - classifieds - craigslist killers - e-commerce - killers - consumer internet - internet - information technology - edp services - technology - software development - microblogging - social networking - public conversation - user engagement - content sharing - advertising solutions - monetization - community building - digital wallet - ai integration - user safety company_size: 1500 youtube_url: null crunchbase_url: null linkedin_url: http://www.linkedin.com/company/twitter instagram_url: null facebook_url: http://facebook.com/twitterinc twitter_url: https://twitter.com/x github_url: null x_url: null location: United States company_ranking: null company_url: http://twitter.com saved_lists: null company_size_printed: 1,500 similarity_score: 0.87 - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: company_name: type: string example: pubrio description: >- Ограничить результаты поиска конкретным названием компании. Если введённое значение этого параметра не совпадает с названием компании, компания не появится в результатах поиска, даже если она соответствует другим параметрам. Частичные совпадения допускаются. companies: type: array items: type: string format: uuid description: >- Список уникальных идентификаторов (domain_search_id), используемых для операций поиска компаний и людей. domains: type: array items: type: string example: - pubrio.com description: >- Список доменов компаний, используемых для операций поиска компаний и людей. Если получен URL вида `www.pubrio.com` или `https://docs.pubrio.com/`, система преобразует его в `pubrio.com` для обработки. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- Полностью сформированный URL профиля компании в LinkedIn. URL начинается с `http` и содержит `linkedin.com/company/` locations: type: array items: type: string example: - US - SG - CN description: >- ISO 3166-1 alpha-2 (cca2) используется для фильтрации местоположений. Подробнее см. эндпоинты `location` на вкладке Filters. exclude_locations: type: array items: type: string example: - CN - US - RU - CA description: >- ISO 3166-1 alpha-2 (cca2) используется для исключения местоположений, которые не нужно возвращать. Подробнее см. эндпоинты `location` на вкладке Filters. places: type: array items: type: string example: - Tokyo description: >- Названия мест (город, регион), используемые для фильтрации результатов. Принимает локализованные или английские названия мест. exclude_places: type: array items: type: string example: - Tokyo description: >- Названия мест (город, регион) для исключения из результатов. Принимает локализованные или английские названия мест. job_exclude_locations: allOf: - $ref: '#/components/schemas/exclude_locations' description: >- Географические местоположения, исключаемые из результатов поиска вакансий. posted_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- Диапазон дат публикации вакансии. Максимальное значение — текущий день. Границы дня определяются часовым поясом вашей рабочей области. people_titles: type: array items: type: string example: - sales manager - marketing manager description: >- Должности, связанные с людьми, которых вы хотите найти. Результаты также будут включать должности, содержащие схожую терминологию, даже если они не совпадают точно. Например, поиск по `software engineer` может вернуть результаты с должностью `senior software engineer`. verticals: type: array items: type: integer description: >- Список значений `vertical_id`, используемых для поиска компаний в конкретной отрасли. Чтобы найти ID, вызовите эндпоинт `vertical` на вкладке Filters. Этот фильтр поддерживает `is_enable_similarity_search`; при включении можно вводить произвольный текст, например `["AI"]`. vertical_categories: type: array items: type: integer description: >- Список значений `vertical_category_id`, используемых для поиска компаний в конкретной категории отрасли. Чтобы найти ID, вызовите эндпоинт `vertical category` на вкладке Filters. Этот фильтр поддерживает `is_enable_similarity_search`; при включении можно вводить произвольный текст, например `["Information Technology"]`. vertical_sub_categories: type: array items: type: integer description: >- Список значений `vertical_sub_category_id`, используемых для поиска компаний в конкретной подкатегории отрасли. Чтобы найти ID, вызовите эндпоинт `vertical sub category` на вкладке Filters. Этот фильтр поддерживает `is_enable_similarity_search`; при включении можно вводить произвольный текст, например `["Software"]`. categories: type: array items: type: integer description: >- Список значений `category_id`, используемых для поиска конкретных категорий технологий, применяемых компаниями. Чтобы найти ID, вызовите эндпоинт `category` на вкладке Filters. Этот фильтр поддерживает `is_enable_similarity_search`; при включении можно вводить произвольный текст, например `["CDN"]`. technologies: type: array items: type: integer description: >- Список значений `tag_id`, используемых для поиска конкретных технологий, применяемых компаниями. Чтобы найти ID, вызовите эндпоинт `technology` на вкладке Filters. Этот фильтр поддерживает `is_enable_similarity_search`; при включении можно вводить произвольный текст, например `["Shopify"]`. employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- Диапазон количества сотрудников, работающих в компании. Позволяет находить компании по численности персонала. Можно добавить несколько диапазонов, чтобы расширить результаты поиска. Подробнее см. эндпоинты `company size` на вкладке Filters. revenues: type: array items: type: integer example: - 0 - 100000 description: Минимальный и максимальный диапазон выручки компании. founded_dates: type: array items: type: integer example: - 2018 - 2024 description: Диапазон годов основания компании. Максимальное значение — текущий год. keywords: type: array items: type: string example: - ecommerce - ai - fintech description: >- Список ключевых слов для фильтрации компаний по релевантности, специализациям или описаниям. news_categories: type: array items: type: string example: - launches description: >- Список `category slugs` для поиска конкретных категорий новостей. Чтобы найти слаг, вызовите эндпоинт `news categories` на вкладке Filters. published_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- Диапазон дат публикации. Максимальное значение — текущий день. Границы дня определяются часовым поясом вашей рабочей области. advertisement_search_terms: type: array items: type: string example: - asus description: >- Ключевые слова, используемые для поиска в содержимом или заголовках рекламы. advertisement_target_locations: allOf: - $ref: '#/components/schemas/target_locations' description: Целевые географические местоположения для рекламы. advertisement_exclude_target_locations: allOf: - $ref: '#/components/schemas/exclude_target_locations' description: Географические местоположения, исключаемые из таргетинга рекламы. advertisement_start_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: Начало диапазона дат для фильтрации рекламы. advertisement_end_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: Конец диапазона дат для фильтрации рекламы. company_filter_conditions: type: array items: type: object properties: key: type: string enum: - keywords - verticals - vertical_categories - vertical_sub_categories - technologies - categories - advertisement_target_locations - advertisement_exclude_target_locations - advertisement_search_terms - places - exclude_places - job_exclude_locations example: keywords description: >- Ключ фильтра, определяющий, к какому свойству применяется оператор. operator: type: string enum: - or - and example: or description: >- Логический оператор для применения. Используйте 'or' для сопоставления с любым из указанных значений или 'and', чтобы требовать все указанные значения. description: >- Расширенные параметры фильтрации для поиска компаний. Задайте условия, сочетающие ключи и логические операторы, чтобы уточнить результаты поиска. is_enable_similarity_search: type: boolean description: >- Если включено, перечисленные выше фильтры, поддерживающие поиск по схожести, можно заполнять произвольным текстом вместо конкретных ID. similarity_score: type: number format: float example: 0.7 description: >- Используется вместе с `is_enable_similarity_search`. Это число используется для анализа того, насколько конкретный слаг (например, отрасль, технология) похож на введённый пользователем текст; чем выше число, тем строже сопоставление. exclude_fields: type: array items: type: string example: - emails - phones - contacts description: Список полей, исключаемых из полезной нагрузки ответа. is_parameter_metadata_available: type: boolean description: Указывает, доступны ли метаданные параметров для запроса. is_profile_metadata_available: type: boolean description: Указывает, доступны ли метаданные профиля для запроса. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- Количество записей на странице. По умолчанию — 25, что также является пределом на большинстве тарифов — лимит определяется параметром `max_search_per_page` вашей подписки, который возвращает [Profile](/en/api-reference/endpoint/profile/profile). Превышение возвращает **HTTP 416** с кодом `41676` (или `41613` для поиска компаний и людей), а не усечённый набор результатов. page: type: integer example: 1 default: 1 description: >- Номер страницы, начиная с 1. Предел определяется параметром `max_search_page` вашей подписки (`max_company_search_page` для поиска компаний), который возвращает [Profile](/en/api-reference/endpoint/profile/profile). Превышение возвращает **HTTP 416**. company_filters: type: object description: >- Объект-обёртка для фильтров на уровне компании. Рекомендуемая группировка, визуально отделяющая, какие ключи фильтруют *человека* (верхний уровень), а какие — *компанию*. Принимает те же ключи, что и фильтры компании верхнего уровня (например, `technologies`, `verticals`, `vertical_categories`, `vertical_sub_categories`, `categories`, `keywords`, `founded_dates`, `employees`, `revenues`, `company_locations`, `company_exclude_locations`, `company_places`, `company_exclude_places`, `companies`, `domains`, `company_linkedin_urls`, `is_enable_similarity_search`, `similarity_score`, а также `filter_conditions`). Движок разворачивает этот объект на верхний уровень перед обработкой — при конфликте побеждают ключи верхнего уровня. Та же структура используется в `company_filters` монитора. Примеры см. в руководстве разработчика Filters Overview. example: company_locations: - US technologies: - 37 - 152 founded_dates: - 2015 - 2023 filter_conditions: - key: technologies operator: and target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- Фильтр рекламы для включения объявлений, нацеленных на конкретные местоположения, по коду страны. Используйте это, чтобы найти рекламу, показываемую в конкретных странах. Сочетается с `filter_conditions` через оператор OR — реклама должна быть нацелена хотя бы на одно из указанных местоположений. exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- Фильтр рекламы для исключения объявлений, нацеленных на конкретные местоположения, по коду страны. Используйте это, чтобы отфильтровать рекламу, показываемую в конкретных странах. При указании в `filter_conditions` с оператором 'or' реклама не должна быть нацелена ни на одно из исключённых местоположений. responses: general_error: description: >- Некорректный запрос. Запрос был некорректно сформирован или содержал недопустимые параметры. Подробности см. в коде и сообщении об ошибке. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- Превышен лимит запросов. За заданный период времени было сделано слишком много запросов. Повторите попытку после сброса окна лимита запросов. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- Внутренняя ошибка сервера. На сервере произошла непредвиденная ошибка. Если ошибка повторяется, обратитесь в службу поддержки. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Уникальный токен API, представляющий действия, которые вы выполняете через API, и соответствующие права доступа и операции. Вы можете создать его в разделе [Settings](https://dashboard.pubrio.com/#/settings/). in: header ````