> ## 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. # Busca de Pessoas > Busca no banco de dados da Pubrio por pessoas que correspondam a critérios especificados, como cargo, localização, empresa e senioridade. ## OpenAPI ````yaml pt-openapi POST /people/search openapi: 3.0.0 info: description: >- A API Pubrio entrega inteligência de expansão de mercado — sinais em tempo real que indicam quando uma empresa entra em um novo mercado — além dos dados de empresas e pessoas por trás desses sinais. Pesquise, consulte e enriqueça contas e contatos, e assine sinais de movimentação tipados e datados em mais de 200 mercados. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/pt-BR/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/pt-BR/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: Informações do perfil da equipe e estatísticas de uso - name: Enrichment description: Enriqueça registros de pessoas e empresas com dados B2B detalhados - name: Lookalike description: Encontre empresas semelhantes a uma empresa específica - name: Search description: Pesquise pessoas, empresas, vagas, notícias e anúncios com filtros - name: Lookup description: >- Consulte informações detalhadas de pessoas, empresas, vagas, notícias, anúncios e tecnologias específicas - name: LinkedIn description: >- Consulte dados de pessoas e empresas por meio de URLs de perfil do LinkedIn - name: Redeem description: >- Resgate créditos para desbloquear detalhes de contato de pessoas (individual e em lote) - name: Channels description: >- Gerencie templates de canais de outreach (criar, atualizar, excluir, listar) - name: Monitor description: >- Crie e gerencie monitores de dados com webhooks, estatísticas e processamento - name: Filters description: >- Obtenha os valores de filtro disponíveis para os parâmetros de busca (tecnologias, localizações, verticais etc.) - name: API Keys description: >- Liste e inspecione logs de requisições da API e análises de uso das chaves de API - name: Insights description: Insights agregados de sinais para empresas (vagas, notícias, anúncios). - name: Export description: Exportações de dados em massa (consomem créditos). - name: Expansion description: >- Inteligência de expansão de mercado de empresas: sinais, estágios, mercados e exportações. externalDocs: description: >- A API Pubrio é usada para pesquisar, pré-visualizar e enriquecer contatos e contas. O banco de dados Pubrio oferece dados extensos de contatos B2B e inteligência de vendas. url: https://docs.pubrio.com paths: /people/search: post: tags: - Search summary: Buscar pessoas description: >- Busca no banco de dados da Pubrio por pessoas que correspondam a critérios especificados, como cargo, localização, empresa e senioridade. 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: >- Busca em linguagem natural. Quando fornecida, a Pubrio a interpreta nos filtros de pessoa e empresa abaixo (cargo, senioridade, departamento, localização, setor, tamanho da empresa e mais). Quaisquer filtros explícitos que você também informar têm prioridade sobre os interpretados. Deixe em branco para buscar apenas pelos filtros estruturados. is_include_similar_people_titles: type: boolean description: >- Quando habilitado, `people_titles` também corresponde a cargos intimamente relacionados (por exemplo, `software engineer` corresponde a `senior software engineer`) em vez de apenas correspondências exatas. people_title_similarity_score: type: number format: float example: 0.9 description: >- Usado em conjunto com `is_include_similar_people_titles`. Controla o quão próxima a correspondência de um cargo deve ser; quanto maior o número, mais rigorosa a correspondência. responses: '200': description: Resposta bem-sucedida contendo os detalhes da busca de pessoas. content: application/json: schema: type: object properties: metadata: type: object description: >- Contexto da solicitação: os `filters` e `parameters` informados são retornados, um bloco opcional de créditos `profile`, e `ignored_fields` (chaves do corpo da requisição que o endpoint descartou). 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: Uma string de palavras pela qual queremos filtrar os resultados. people_name: type: string example: king description: Filtra os resultados da busca para incluir um nome de pessoa específico. people_titles: type: array items: type: string example: - sales manager - marketing manager description: |- Cargos associados aos indivíduos que você deseja localizar. Os resultados também incluirão cargos que contenham terminologia semelhante, mesmo que não correspondam exatamente. Por exemplo, buscar por `software engineer` pode retornar resultados de indivíduos com o cargo `senior software engineer`. exclude_people_titles: type: array items: type: string example: - intern - assistant description: >- Cargos a excluir. Mesma correspondência por palavra usada em `people_titles`, então `["senior"]` remove todo cargo que contenha essa palavra. Aplicado após `people_titles`. peoples: type: array items: type: string format: uuid description: >- Uma lista de identificadores únicos (people_search_id) usada para operações de busca de pessoas. 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: >- Nível hierárquico da pessoa. O slug para C-level é `c_suite`, não `c_level`. Slugs desconhecidos são descartados quando outros filtros de pessoas estão presentes, e falham com `40037` quando este é o único filtro. Lista completa disponível no endpoint `management level` na aba Filters. departments: type: array items: type: string example: - master_human_resources description: >- O campo de departamento permite buscar pessoas em áreas específicas de atuação. Consulte os endpoints `department` na aba Filters para mais informações. exclude_departments: type: array items: type: string example: - master_human_resources description: >- Slugs de departamento a excluir. Mesmo vocabulário de `departments`. Pessoas sem departamento registrado são mantidas. functions: type: array items: type: string example: - human_resources description: >- O campo de filtro para funções de trabalho permite especificar cargos ou áreas de atuação específicas ao buscar pessoas. Consulte os endpoints `department functions` na aba Filters para mais informações. exclude_department_functions: type: array items: type: string example: - software_development description: >- Slugs de função a excluir. Mesmo vocabulário de `department_functions`. Pessoas sem função registrada são mantidas. employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- O intervalo numérico de funcionários que trabalham na empresa. Isso permite encontrar empresas com base no número de funcionários. Você pode adicionar múltiplos intervalos para expandir os resultados da busca. Consulte os endpoints de `company size` na aba Filters para mais informações. people_locations: type: array items: type: string example: - US - SG - CN description: >- A localização onde as pessoas vivem. Consulte os endpoints de `location` na aba Filters para mais informações. exclude_people_locations: type: array items: type: string example: - US description: >- Países em que a pessoa **não** deve residir (ISO 3166-1 alfa-2). Complementar a `people_locations`. company_locations: type: array items: type: string example: - US - SG - CN description: >- A localização da sede da empresa. Consulte os endpoints de `location` na aba Filters para mais informações. company_exclude_locations: type: array items: type: string example: - CN description: >- Países de sede a excluir (ISO 3166-1 alfa-2). Complementar a `company_locations`; enviar o mesmo código em ambos não retorna nada. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- A URL completa do perfil da empresa no LinkedIn. A URL começa com `http` e contém `linkedin.com/company/` people_linkedin_urls: type: array items: type: string example: - http://www.linkedin.com/in/king-lai-605382b7 description: >- A URL completa do perfil do usuário no LinkedIn. A URL começa com `http` e contém `linkedin.com/in/` ou `linkedin.com/pub/` companies: type: array items: type: string format: uuid description: >- Uma lista de identificadores únicos (domain_search_id) usada para operações de busca de empresas e pessoas. domains: type: array items: type: string example: - pubrio.com description: >- Lista de domínios de empresas usada para operações de busca de empresas e pessoas. Se recebermos uma URL como `www.pubrio.com` ou `https://docs.pubrio.com/`, o sistema a converterá para `pubrio.com` para processamento. company_filters: type: object description: >- Objeto wrapper para filtros em nível de empresa. Agrupamento recomendado que separa visualmente quais chaves filtram a *pessoa* (nível superior) das que filtram a *empresa*. Aceita as mesmas chaves dos filtros de empresa de nível superior (por exemplo, `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`, além de `filter_conditions`). O mecanismo achata esse objeto para o nível superior antes de processar — as chaves de nível superior prevalecem em caso de conflito. Mesma estrutura usada pelo `company_filters` do Monitor. Consulte o guia do desenvolvedor Visão Geral dos Filtros para ver exemplos. 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: >- A chave de filtro que especifica a qual propriedade o operador deve ser aplicado. As chaves referenciam os nomes de filtro unificados de empresa (use `places`, não `company_places`). operator: type: string enum: - or - and example: and description: >- O operador lógico a ser aplicado. Use 'or' para corresponder a qualquer um dos valores especificados, ou 'and' para exigir todos os valores especificados. description: >- Substituição de AND/OR por chave para os filtros em /people/search. O padrão é OR quando omitido. Consulte o guia do desenvolvedor Filtros de Pessoas e Empresas para a referência completa de remapeamento de chaves. is_enable_similarity_search: type: boolean description: >- Quando habilitado, os filtros listados acima que suportam buscas por similaridade podem ser preenchidos com texto livre para IDs específicos. similarity_score: type: number format: float example: 0.7 description: >- Usado em conjunto com `is_enable_similarity_search`. Esse número é usado para analisar se um slug específico (por exemplo, setor vertical, tecnologia) é semelhante à entrada do usuário, e quanto maior o número, mais rigoroso é o critério. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- Registros por página. O padrão é 25, que também é o teto na maioria dos planos — o limite é o `max_search_per_page` da sua assinatura, retornado por [Profile](/pt/api-reference/endpoint/profile/profile). Excedê-lo retorna **HTTP 416** com o código `41676` (ou `41613` na busca de empresas e pessoas), não um conjunto de resultados limitado. page: type: integer example: 1 default: 1 description: >- Número da página, começando em 1. O teto é o `max_search_page` da sua assinatura (`max_company_search_page` para busca de empresas), retornado por [Profile](/pt/api-reference/endpoint/profile/profile). Excedê-lo retorna **HTTP 416**. data: type: object nullable: true description: As informações da resposta dependem do endpoint específico. responses: general_error: description: >- Requisição inválida. A requisição estava malformada ou continha parâmetros inválidos. Verifique o código de erro e a mensagem para mais detalhes. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Os erros e códigos variam de acordo com o cenário; consulte a documentação para mais informações. type: string details: type: object rate_limit_error: description: >- Limite de requisições excedido. Foram feitas requisições em excesso em um determinado período de tempo. Tente novamente após a janela do limite de requisições ser reiniciada. content: application/json: schema: required: - error type: object properties: error: example: >- Limite de requisições excedido. Aguarde e tente novamente mais tarde. type: string server_error: description: >- Erro interno do servidor. Ocorreu um erro inesperado no servidor. Entre em contato com o suporte caso o erro persista. content: application/json: schema: required: - error type: object properties: error: example: Ocorreu um erro inesperado no servidor. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- Um token de API exclusivo que representa as ações que você realiza por meio da API e as permissões e operações correspondentes. Você pode criá-lo na seção [Configurações](https://dashboard.pubrio.com/#/settings/). in: header ````