> ## 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. # Поиск людей > Поиск в базе данных Pubrio людей, соответствующих заданным критериям, таким как должность, местоположение, компания и уровень. ## OpenAPI ````yaml ru-openapi POST /people/search 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: /people/search: post: tags: - Search summary: Поиск людей description: >- Поиск в базе данных Pubrio людей, соответствующих заданным критериям, таким как должность, местоположение, компания и уровень. operationId: people_search parameters: [] requestBody: required: true content: application/json: schema: type: object properties: search_term: $ref: '#/components/schemas/search_term' people_name: $ref: '#/components/schemas/people_name' people_titles: $ref: '#/components/schemas/people_titles' exclude_people_titles: $ref: '#/components/schemas/exclude_people_titles' peoples: $ref: '#/components/schemas/peoples' management_levels: $ref: '#/components/schemas/management_levels' departments: $ref: '#/components/schemas/departments' exclude_departments: $ref: '#/components/schemas/exclude_departments' department_functions: $ref: '#/components/schemas/functions' exclude_department_functions: $ref: '#/components/schemas/exclude_department_functions' employees: $ref: '#/components/schemas/employees' people_locations: $ref: '#/components/schemas/people_locations' exclude_people_locations: $ref: '#/components/schemas/exclude_people_locations' company_locations: $ref: '#/components/schemas/company_locations' company_exclude_locations: $ref: '#/components/schemas/company_exclude_locations' company_linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' linkedin_urls: $ref: '#/components/schemas/people_linkedin_urls' companies: $ref: '#/components/schemas/companies' domains: $ref: '#/components/schemas/domains' company_filters: $ref: '#/components/schemas/company_filters' filter_conditions: $ref: '#/components/schemas/people_filter_conditions' is_enable_similarity_search: $ref: '#/components/schemas/is_enable_similarity_search' similarity_score: $ref: '#/components/schemas/similarity_score' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' query: type: string example: decision makers in marketing description: >- Поиск на естественном языке. Если указан, Pubrio интерпретирует его в приведённые ниже фильтры по человеку и компании (должность, уровень, отдел, местоположение, отрасль, размер компании и т. д.). Любые явно переданные фильтры имеют приоритет над интерпретированными. Оставьте пустым, чтобы искать только по структурированным фильтрам. is_include_similar_people_titles: type: boolean description: >- Если включено, `people_titles` также сопоставляется с близкими по смыслу должностями (например, `software engineer` соответствует `senior software engineer`), а не только с точными совпадениями. people_title_similarity_score: type: number format: float example: 0.9 description: >- Используется вместе с `is_include_similar_people_titles`. Определяет, насколько точно должность должна совпадать; чем выше значение, тем строже сопоставление. responses: '200': description: Успешный ответ с данными поиска людей. content: application/json: schema: type: object properties: metadata: type: object description: >- Контекст запроса: отражённые `filters` и `parameters`, необязательный кредитный блок `profile` и `ignored_fields` (ключи тела запроса, отброшенные эндпоинтом). data: $ref: '#/components/schemas/data' example: metadata: filters: management_levels: - c_suite profile: null data: pagination: page: 1 per_page: 25 total_entries: 199616132 total_pages: 100 total_display_pages: 100 is_timeout: false peoples: - people_search_id: 134591fb-f0fa-41ba-9c8c-f1eb8aab8946 name: Doug McMillon first_name: Doug last_name: McMillon title: President & CEO seniority: c_suite functions: null headline: President & CEO at Walmart Inc. tagline: null introduction: null description: null departments: - c_suite subdepartments: - executive keywords: null employment_history: - title: President & CEO current: true end_date: null start_date: '2014-02-01' company_name: Walmart - title: President & CEO, Walmart International current: false end_date: '2014-01-01' start_date: '2009-02-01' company_name: Walmart - title: President & CEO current: false end_date: '2009-01-01' start_date: '2005-08-01' company_name: Sam's Club country: United States country_code: US location: United States state: Arkansas city: Bentonville wantedly_name: null rocketpunch_name: null contacts: null contact_types: [] emails: null phones: null facebook_url: null github_url: null twitter_url: null linkedin_url: http://www.linkedin.com/in/dougmcmillon wantedly_url: null rocketpunch_url: null saved_lists: null sequences: null social_metadata: {} company: company_name: Walmart company_url: http://walmart.com is_company_url_active: true domain: walmart.com domain_id: 26067151 domain_ids: - 757023267 - 368242703 - 26067151 domain_search_id: 2a0d6cd7-cc10-44d6-94ec-41fd528a11b6 founded_year: 1962 country: United States country_code: US location: United States phones: null emails: [] contacts: [] wantedly_name: null rocketpunch_name: null tiktok_name: null company_size_printed: 466,000 company_size: 466000 industry: Retail specialties: - Retail - E-commerce logo_url: >- https://buckets.pubrio.com/company-logo/NzU3MDIzMjY3aWxqOXNzbmoxd2FsbWFydC5jb21saW5rZWRpbl8zMzMxOTgxMg==.jpg linkedin_url: http://www.linkedin.com/company/walmart facebook_url: http://facebook.com/walmart twitter_url: https://twitter.com/walmart crunchbase_url: null instagram_url: http://instagram.com/walmart youtube_url: http://youtube.com/user/walmart x_url: null github_url: null tiktok_url: null wantedly_url: null rocketpunch_url: null social_metadata: {} - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: search_term: type: string example: pubrio description: Строка слов, по которой мы фильтруем результаты. people_name: type: string example: king description: Ограничить результаты поиска конкретным именем человека. people_titles: type: array items: type: string example: - sales manager - marketing manager description: >- Должности, связанные с людьми, которых вы хотите найти. Результаты также будут включать должности, содержащие схожую терминологию, даже если они не совпадают точно. Например, поиск по `software engineer` может вернуть результаты с должностью `senior software engineer`. exclude_people_titles: type: array items: type: string example: - intern - assistant description: >- Должности для исключения. То же сопоставление на уровне слов, что и у `people_titles`, поэтому `["senior"]` удаляет каждую должность, содержащую это слово. Применяется после `people_titles`. peoples: type: array items: type: string format: uuid description: >- Список уникальных идентификаторов (people_search_id), используемых для операций поиска людей. management_levels: type: array items: type: string enum: - c_suite - director - entry - founder - head - intern - manager - owner - partner - senior - vp example: - c_suite - vp description: >- Уровень подчинённости человека. Слаг для высшего руководства — `c_suite`, а не `c_level`. Неизвестные слаги отбрасываются, если присутствуют другие фильтры по людям, и приводят к ошибке `40037`, если это единственный указанный фильтр. Полный список доступен в эндпоинте `management level` на вкладке Filters. departments: type: array items: type: string example: - master_human_resources description: |- Поле отдела позволяет искать людей в конкретных областях деятельности. Подробнее см. эндпоинты `department` на вкладке Filters. exclude_departments: type: array items: type: string example: - master_human_resources description: >- Слаги отделов для исключения. Тот же словарь, что и `departments`. Люди без указанного отдела сохраняются. functions: type: array items: type: string example: - human_resources description: >- Поле фильтра по функциям позволяет указать конкретные роли или области деятельности при поиске людей. Подробнее см. эндпоинты `department functions` на вкладке Filters. exclude_department_functions: type: array items: type: string example: - software_development description: >- Слаги функций для исключения. Тот же словарь, что и `department_functions`. Люди без указанной функции сохраняются. employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- Диапазон количества сотрудников, работающих в компании. Позволяет находить компании по численности персонала. Можно добавить несколько диапазонов, чтобы расширить результаты поиска. Подробнее см. эндпоинты `company size` на вкладке Filters. people_locations: type: array items: type: string example: - US - SG - CN description: >- Местоположение проживания людей. Подробнее см. эндпоинты `location` на вкладке Filters. exclude_people_locations: type: array items: type: string example: - US description: >- Страны, в которых человек **не должен** проживать (ISO 3166-1 alpha-2). Дополняет `people_locations`. company_locations: type: array items: type: string example: - US - SG - CN description: >- Местоположение штаб-квартиры компании. Подробнее см. эндпоинты `location` на вкладке Filters. company_exclude_locations: type: array items: type: string example: - CN description: >- Страны штаб-квартир для исключения (ISO 3166-1 alpha-2). Дополняет `company_locations`; передача одного и того же кода в обоих полях не даёт результатов. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- Полностью сформированный URL профиля компании в LinkedIn. URL начинается с `http` и содержит `linkedin.com/company/` people_linkedin_urls: type: array items: type: string example: - http://www.linkedin.com/in/king-lai-605382b7 description: >- Полностью сформированный URL профиля пользователя в LinkedIn. URL начинается с `http` и содержит `linkedin.com/in/` или `linkedin.com/pub/` 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_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 people_filter_conditions: type: array items: type: object properties: key: type: string enum: - keywords - verticals - vertical_categories - vertical_sub_categories - technologies - categories - places - exclude_places - social_media example: technologies description: >- Ключ фильтра, определяющий, к какому свойству применяется оператор. Ключи ссылаются на унифицированные названия фильтров компании (используйте `places`, а не `company_places`). operator: type: string enum: - or - and example: and description: >- Логический оператор для применения. Используйте 'or' для сопоставления с любым из указанных значений или 'and', чтобы требовать все указанные значения. description: >- Переопределение AND/OR для каждого ключа фильтров в /people/search. По умолчанию — OR, если не указано. Полный справочник по замене ключей см. в руководстве разработчика People + Company Filters. is_enable_similarity_search: type: boolean description: >- Если включено, перечисленные выше фильтры, поддерживающие поиск по схожести, можно заполнять произвольным текстом вместо конкретных ID. similarity_score: type: number format: float example: 0.7 description: >- Используется вместе с `is_enable_similarity_search`. Это число используется для анализа того, насколько конкретный слаг (например, отрасль, технология) похож на введённый пользователем текст; чем выше число, тем строже сопоставление. 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**. data: type: object nullable: true description: Информация об ответе зависит от конкретного эндпоинта. 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 ````