> ## 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 empresas similares > Encuentra empresas similares a una empresa de referencia. Proporciona exactamente un identificador singular (`domain_search_id`, `domain`, `linkedin_url` u otro `*_url`); las filas incluyen un `similarity_score` y se ordenan por él, de mayor a menor. ## OpenAPI ````yaml es-openapi POST /companies/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: /companies/search/similar: post: tags: - Lookalike summary: Buscar empresas similares description: >- Encuentra empresas similares a una empresa de referencia. Proporciona exactamente un identificador singular (`domain_search_id`, `domain`, `linkedin_url` u otro `*_url`); las filas incluyen un `similarity_score` y se ordenan por él, de mayor a menor. operationId: companies_search_similar parameters: [] requestBody: required: true content: application/json: schema: type: object properties: domain_search_id: type: string description: Identificador de empresa de Pubrio. domain: type: string description: >- El dominio principal de la empresa, por ejemplo `stripe.com`. example: stripe.com linkedin_url: type: string description: URL de LinkedIn de la empresa. tiktok_url: type: string description: URL del perfil de TikTok de la empresa. wantedly_url: type: string description: URL del perfil de Wantedly de la empresa. tw104_url: type: string description: URL del perfil de 104 (Taiwán) de la empresa. rocketpunch_url: type: string description: URL del perfil de RocketPunch de la empresa. remember_url: type: string description: URL del perfil de Remember de la empresa. youtrust_url: type: string description: URL del perfil de YOUTRUST de la empresa. 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: >- Respuesta correcta que contiene los detalles de la búsqueda de empresas. content: application/json: schema: type: object properties: metadata: type: object description: >- Contexto de la solicitud. Incluye los `filters` y `parameters` reflejados, y un bloque `profile` con `credit`, `topup_credit` y `total_credit_cost`: la única contabilidad de créditos por llamada que devuelve la API. data: type: array description: >- Las empresas similares, clasificadas por similitud. Ten en cuenta que este endpoint devuelve un array simple: a diferencia de los demás endpoints de búsqueda, no hay un contenedor `pagination` dentro de `data`. 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: >- Filtra los resultados de búsqueda para incluir un nombre de empresa específico. Si el valor que introduces para este parámetro no coincide con el nombre de una empresa, esta no aparecerá en los resultados de búsqueda, aunque coincida con otros parámetros. Se aceptan coincidencias parciales. 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. 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/` locations: type: array items: type: string example: - US - SG - CN description: >- Se usa el código ISO 3166-1 alfa-2 (cca2) para filtrar ubicaciones. Consulta los endpoints `location` en la pestaña Filters para más información. exclude_locations: type: array items: type: string example: - CN - US - RU - CA description: >- Se usa el código ISO 3166-1 alfa-2 (cca2) para excluir ubicaciones que no deben devolverse. Consulta los endpoints `location` en la pestaña Filters para más información. places: type: array items: type: string example: - Tokyo description: >- Nombres de lugares (ciudad, región) utilizados para filtrar resultados. Acepta nombres de lugares localizados o en inglés. exclude_places: type: array items: type: string example: - Tokyo description: >- Nombres de lugares (ciudad, región) a excluir de los resultados. Acepta nombres de lugares localizados o en inglés. job_exclude_locations: allOf: - $ref: '#/components/schemas/exclude_locations' description: >- Ubicaciones geográficas a excluir de los resultados de ofertas de empleo. posted_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- Rango de fechas de publicación. El valor máximo es el día actual. Los límites del día siguen la zona horaria de tu espacio de trabajo. 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`. verticals: type: array items: type: integer description: >- Una lista de `vertical_id` utilizada para buscar empresas en un vertical o industria específica. Para encontrar el ID, llama al endpoint `vertical` en la pestaña Filters. Este filtro admite `is_enable_similarity_search`; una vez habilitado, puedes introducir texto libre, por ejemplo `["AI"]`. vertical_categories: type: array items: type: integer description: >- Una lista de `vertical_category_id` utilizada para buscar empresas en una categoría vertical específica. Para encontrar el ID, llama al endpoint `vertical category` en la pestaña Filters. Este filtro admite `is_enable_similarity_search`; una vez habilitado, puedes introducir texto libre, por ejemplo `["Information Technology"]`. vertical_sub_categories: type: array items: type: integer description: >- Una lista de `vertical_sub_category_id` utilizada para buscar empresas en una subcategoría vertical específica. Para encontrar el ID, llama al endpoint `vertical sub category` en la pestaña Filters. Este filtro admite `is_enable_similarity_search`; una vez habilitado, puedes introducir texto libre, por ejemplo `["Software"]`. categories: type: array items: type: integer description: >- Una lista de `category_id` utilizada para buscar categorías específicas de tecnología usadas por las empresas. Para encontrar el ID, llama al endpoint `category` en la pestaña Filters. Este filtro admite `is_enable_similarity_search`; una vez habilitado, puedes introducir texto libre, por ejemplo `["CDN"]`. technologies: type: array items: type: integer description: >- Una lista de `tag_id` utilizada para buscar tecnologías específicas usadas por las empresas. Para encontrar el ID, llama al endpoint `technology` en la pestaña Filters. Este filtro admite `is_enable_similarity_search`; una vez habilitado, puedes introducir texto libre, por ejemplo `["Shopify"]`. 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. revenues: type: array items: type: integer example: - 0 - 100000 description: Rango mínimo y máximo de ingresos de la empresa. founded_dates: type: array items: type: integer example: - 2018 - 2024 description: >- Rango de años de fundación de la empresa. El valor máximo de fundación es el año en curso. keywords: type: array items: type: string example: - ecommerce - ai - fintech description: >- Una lista de palabras clave para filtrar empresas por relevancia, especialidades o descripciones. news_categories: type: array items: type: string example: - launches description: >- Lista de `category slugs` para buscar categorías de noticias específicas. Para encontrar un slug, llama al endpoint `news categories` en la pestaña Filters. published_dates: type: array items: type: string example: - '2025-01-01' - '2025-01-10' description: >- Rango de fechas de publicación. El valor máximo es el día actual. Los límites del día siguen la zona horaria de tu espacio de trabajo. advertisement_search_terms: type: array items: type: string example: - asus description: >- Palabras clave utilizadas para buscar dentro del contenido o los títulos de los anuncios. advertisement_target_locations: allOf: - $ref: '#/components/schemas/target_locations' description: Ubicaciones geográficas objetivo para los anuncios. advertisement_exclude_target_locations: allOf: - $ref: '#/components/schemas/exclude_target_locations' description: Ubicaciones geográficas a excluir de la segmentación de anuncios. advertisement_start_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: Rango de fecha de inicio para filtrar anuncios. advertisement_end_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: Rango de fecha de fin para filtrar anuncios. 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: >- La clave de filtro que especifica a qué propiedad aplicar el operador. operator: type: string enum: - or - and example: or 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: >- Opciones de filtrado avanzado para búsquedas de empresas. Especifica condiciones combinando claves y operadores lógicos para refinar los resultados de búsqueda. 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. exclude_fields: type: array items: type: string example: - emails - phones - contacts description: Lista de campos a excluir de la carga útil de la respuesta. is_parameter_metadata_available: type: boolean description: Indica si hay metadatos de parámetros disponibles para la solicitud. is_profile_metadata_available: type: boolean description: Indica si hay metadatos de perfil disponibles para la solicitud. 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 target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- Filtra anuncios para incluir aquellos dirigidos a ubicaciones específicas por código de país. Úsalo para encontrar anuncios que se están mostrando en países concretos. Se combina con `filter_conditions` usando el operador OR: el anuncio debe estar dirigido al menos a una de las ubicaciones especificadas. exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- Filtra anuncios para excluir aquellos dirigidos a ubicaciones específicas por código de país. Úsalo para descartar anuncios que se están mostrando en países concretos. Cuando se especifica en `filter_conditions` con el operador 'or', el anuncio no debe estar dirigido a ninguna de las ubicaciones excluidas. 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 ````