> ## 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. # Buscar personas similares > Encuentra personas similares a una persona de referencia. Proporciona una referencia (`people_search_id`, `linkedin_url`, `linkedin_urls`, `peoples` o `people_titles`); las filas llevan un `similarity_score` y se ordenan por él, de mayor a menor. ## OpenAPI ````yaml es-openapi POST /people/search/similar openapi: 3.0.0 info: description: >- La API de Pubrio ofrece inteligencia de expansión de mercado —señales en tiempo real que indican cuándo una empresa entra en un nuevo mercado— junto con los datos de empresas y personas que las respaldan. Busca, consulta y enriquece cuentas y contactos, y suscríbete a señales de movimiento tipadas y fechadas en más de 200 mercados. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/es/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/es/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: Información del perfil del espacio de trabajo y estadísticas de uso - name: Enrichment description: Enriquece registros de personas y empresas con datos B2B detallados - name: Lookalike description: Encuentra empresas similares a una empresa determinada - name: Search description: Busca personas, empresas, empleos, noticias y anuncios con filtros - name: Lookup description: >- Consulta información detallada de personas, empresas, empleos, noticias, anuncios y tecnologías específicos - name: LinkedIn description: Consulta datos de personas y empresas mediante URL de perfil de LinkedIn - name: Redeem description: >- Canjea créditos para desbloquear datos de contacto de personas (individual y por lotes) - name: Channels description: >- Gestiona plantillas de canales de contacto (crear, actualizar, eliminar, listar) - name: Monitor description: >- Crea y gestiona monitores de datos con webhooks, estadísticas y procesamiento - name: Filters description: >- Obtén los valores de filtro disponibles para los parámetros de búsqueda (tecnologías, ubicaciones, verticales, etc.) - name: API Keys description: >- Lista e inspecciona los registros de solicitudes a la API y las analíticas de uso de las claves de API - name: Insights description: >- Información agregada de señales para empresas (empleos, noticias, anuncios). - name: Export description: Exportaciones de datos masivas (sujetas a créditos). - name: Expansion description: >- Inteligencia de expansión de mercado de empresas: señales, etapas, mercados y exportaciones. externalDocs: description: >- La API de Pubrio se utiliza para buscar, previsualizar y enriquecer contactos y cuentas. La base de datos de Pubrio ofrece amplios datos de contactos B2B e inteligencia de ventas. url: https://docs.pubrio.com paths: /people/search/similar: post: tags: - Lookalike summary: Buscar personas similares description: >- Encuentra personas similares a una persona de referencia. Proporciona una referencia (`people_search_id`, `linkedin_url`, `linkedin_urls`, `peoples` o `people_titles`); las filas llevan un `similarity_score` y se ordenan por él, de mayor a menor. operationId: people_search_similar parameters: [] requestBody: required: true content: application/json: schema: type: object properties: people_search_id: type: string description: ID de persona de Pubrio a usar como referencia. linkedin_url: type: string description: Una única URL de perfil de LinkedIn a usar como referencia. identifier: type: string description: >- Una cadena de referencia libre (nombre, cargo o URL de perfil) para iniciar la búsqueda por similitud. search_term: $ref: '#/components/schemas/search_term' people_name: $ref: '#/components/schemas/people_name' people_titles: $ref: '#/components/schemas/people_titles' peoples: $ref: '#/components/schemas/peoples' management_levels: $ref: '#/components/schemas/management_levels' departments: $ref: '#/components/schemas/departments' department_functions: $ref: '#/components/schemas/functions' employees: $ref: '#/components/schemas/employees' people_locations: $ref: '#/components/schemas/people_locations' company_locations: $ref: '#/components/schemas/company_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' 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' company_filters: $ref: '#/components/schemas/company_filters' anyOf: - title: peoples required: - peoples - title: people_search_id required: - people_search_id - title: people_titles required: - people_titles - title: linkedin_url required: - linkedin_url - title: linkedin_urls required: - linkedin_urls - title: identifier required: - identifier responses: '200': description: >- Respuesta exitosa que contiene los detalles de la búsqueda de personas. content: application/json: schema: type: object properties: metadata: type: object description: >- Contexto de la solicitud — `filters` y `parameters` reflejados, además de un bloque `profile` con `credit`, `topup_credit` y `total_credit_cost` cuando se solicita el cálculo de créditos. 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: Una cadena de palabras sobre la que queremos filtrar los resultados. people_name: type: string example: king description: >- Filtra los resultados de búsqueda para incluir un nombre de persona específico. people_titles: type: array items: type: string example: - sales manager - marketing manager description: |- Cargos asociados a las personas que deseas localizar. Los resultados también incluirán cargos que contengan terminología similar, aunque no coincidan exactamente. Por ejemplo, buscar `software engineer` puede devolver resultados de personas con el cargo `senior software engineer`. peoples: type: array items: type: string format: uuid description: >- Una lista de identificadores únicos (people_search_id) utilizada para operaciones de búsqueda de personas. 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: >- Nivel jerárquico de la persona. El slug para la alta dirección es `c_suite`, no `c_level`. Los slugs desconocidos se descartan cuando hay otros filtros de personas presentes, y fallan con `40037` cuando este es el único filtro. Lista completa en el endpoint `management level` de la pestaña Filters. departments: type: array items: type: string example: - master_human_resources description: >- El campo de departamento permite buscar personas en áreas de especialización específicas. Consulta los endpoints `department` en la pestaña Filters para más información. functions: type: array items: type: string example: - human_resources description: >- El campo de filtro para funciones laborales permite especificar roles o áreas de especialización concretas al buscar personas. Consulta los endpoints `department functions` en la pestaña Filters para más información. employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- El rango numérico de empleados que trabajan en la empresa. Esto te permite encontrar empresas según su plantilla. Puedes añadir varios rangos para ampliar los resultados de búsqueda. Consulta los endpoints `company size` en la pestaña Filters para más información. people_locations: type: array items: type: string example: - US - SG - CN description: >- La ubicación donde viven las personas. Consulta los endpoints `location` en la pestaña Filters para más información. company_locations: type: array items: type: string example: - US - SG - CN description: >- La ubicación de la sede de la empresa. Consulta los endpoints `location` en la pestaña Filters para más información. company_linkedin_urls: type: array items: type: string example: - https://www.linkedin.com/company/pubrio description: >- La URL completa del perfil de LinkedIn de la empresa. La URL debe empezar por `http` y contener `linkedin.com/company/` people_linkedin_urls: type: array items: type: string example: - http://www.linkedin.com/in/king-lai-605382b7 description: >- La URL completa del perfil de LinkedIn del usuario. La URL debe empezar por `http` y contener `linkedin.com/in/` o `linkedin.com/pub/` companies: type: array items: type: string format: uuid description: >- Una lista de identificadores únicos (domain_search_id) utilizada para operaciones de búsqueda de empresas y personas. domains: type: array items: type: string example: - pubrio.com description: >- Lista de dominios de empresa utilizada para operaciones de búsqueda de empresas y personas. Si recibimos una URL como `www.pubrio.com` o `https://docs.pubrio.com/`, el sistema la convertirá a `pubrio.com` para su procesamiento. 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: >- La clave de filtro que especifica a qué propiedad aplicar el operador. Las claves hacen referencia a los nombres unificados de filtro de empresa (usa `places`, no `company_places`). operator: type: string enum: - or - and example: and description: >- El operador lógico a aplicar. Usa 'or' para coincidir con cualquiera de los valores especificados, o 'and' para requerir todos los valores especificados. description: >- Anulación de AND/OR por clave para los filtros en /people/search. Por defecto es OR cuando se omite. Consulta la guía para desarrolladores de filtros de personas y empresas para la referencia completa de reasignación de claves. is_enable_similarity_search: type: boolean description: >- Cuando está habilitado, los filtros indicados anteriormente que admiten búsquedas por similitud pueden completarse con texto libre en lugar de IDs específicos. similarity_score: type: number format: float example: 0.7 description: >- Se usa junto con `is_enable_similarity_search`. Este número se utiliza para analizar si un slug específico (por ejemplo, vertical de industria, tecnología) es similar a la entrada del usuario, y cuanto mayor es el número, más estricto es. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- Registros por página. Por defecto es 25, que también es el límite en la mayoría de los planes — el límite es el `max_search_per_page` de tu suscripción, devuelto por [Perfil](/es/api-reference/endpoint/profile/profile). Superarlo devuelve **HTTP 416** con el código `41676` (o `41613` en la búsqueda de empresas y personas), no un conjunto de resultados recortado. page: type: integer example: 1 default: 1 description: >- Número de página, empezando en 1. El límite es el `max_search_page` de tu suscripción (`max_company_search_page` para la búsqueda de empresas), devuelto por [Perfil](/es/api-reference/endpoint/profile/profile). Superarlo devuelve **HTTP 416**. company_filters: type: object description: >- Objeto contenedor para filtros a nivel de empresa. Agrupación recomendada que separa visualmente qué claves filtran a la *persona* (nivel superior) de cuáles filtran a la *empresa*. Acepta las mismas claves que los filtros de empresa de nivel superior (por ejemplo, `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`, además de `filter_conditions`). El motor aplana este objeto al nivel superior antes de procesarlo — las claves de nivel superior prevalecen en caso de conflicto. Misma estructura que usa `company_filters` en Monitor. Consulta la guía para desarrolladores sobre filtros para ver ejemplos. example: company_locations: - US technologies: - 37 - 152 founded_dates: - 2015 - 2023 filter_conditions: - key: technologies operator: and data: type: object nullable: true description: La información de la respuesta depende del endpoint específico. responses: general_error: description: >- Solicitud incorrecta. La solicitud estaba mal formada o contenía parámetros no válidos. Consulta el código de error y el mensaje para más detalles. 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: >- Límite de tasa excedido. Se realizaron demasiadas solicitudes en un período de tiempo determinado. Vuelve a intentarlo después de que se restablezca la ventana de límite de tasa. 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: >- Error interno del servidor. Se produjo un error inesperado en el servidor. Contacta con soporte si el error persiste. 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: >- Un token de API único que representa las acciones que realizas a través de la API, junto con los permisos y operaciones correspondientes. Puedes crearlo en la sección [Configuración](https://dashboard.pubrio.com/#/settings/). in: header ````