> ## 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. # Búsqueda de noticias de la empresa > Busca noticias sobre empresas. Consulta la [guía de búsqueda de noticias](/es/developer-guides/search/news-search). ## OpenAPI ````yaml es-openapi POST /companies/news/search 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/news/search: post: tags: - Search summary: Buscar noticias de empresas description: >- Busca noticias sobre empresas. Consulta la [guía de búsqueda de noticias](/es/developer-guides/search/news-search). operationId: companies_search_news parameters: [] requestBody: required: true content: application/json: schema: type: object properties: locations: $ref: '#/components/schemas/locations' company_locations: $ref: '#/components/schemas/company_locations' companies: $ref: '#/components/schemas/companies' news_search_id: allOf: - $ref: '#/components/schemas/news_search_id' description: >- Devuelve únicamente este registro. Útil para volver a obtener una fila que guardaste antes sin paginar. domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' search_term: $ref: '#/components/schemas/search_term' search_terms: type: array items: type: string example: - Trump description: >- Array de cadenas de palabras clave para filtrar artículos de noticias. Cada término se compara con el contenido del artículo. Usa `search_term` para una sola cadena o `search_terms` para varias palabras clave. categories: $ref: '#/components/schemas/news_categories' news_gallery_ids: $ref: '#/components/schemas/news_gallery_ids' published_dates: $ref: '#/components/schemas/published_dates' published_at: $ref: '#/components/schemas/news_published_at_from' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' is_ascending_order: $ref: '#/components/schemas/is_ascending_order' news_galleries: type: array items: type: string example: - electronic-commerce description: >- Lista de `gallery slugs` para filtrar noticias por galería. Para encontrar un slug, llama al endpoint `news galleries` en la pestaña Filters. news_languages: type: array items: type: string example: - en description: >- Lista de valores `locale_code` para filtrar noticias por idioma. Para encontrar los códigos disponibles, llama al endpoint `news languages` en la pestaña Filters. is_expansion_signal_available: $ref: '#/components/schemas/is_expansion_signal_available' expansion_signal_types: $ref: '#/components/schemas/expansion_signal_types' expansion_signal_polarities: $ref: '#/components/schemas/expansion_signal_polarities' responses: '200': description: >- Respuesta exitosa que contiene los detalles de la búsqueda de noticias de empresas. content: application/json: schema: type: object properties: metadata: $ref: '#/components/schemas/search_metadata' data: type: object properties: pagination: $ref: '#/components/schemas/search_pagination' news: type: array items: $ref: '#/components/schemas/news_search_result' example: metadata: profile: null filters: domains: - stripe.com per_page: 25 language: en ignored_fields: [] data: pagination: page: 1 per_page: 25 total_entries: 351800 total_pages: 14072 is_timeout: false total_display_pages: 250 news: - news_id: 0b0f1c53-7a04-4a46-b5bc-3b17a7c4cfbd news_search_id: 4110b929-17cd-42aa-a159-906ead0c9b56 country_codes: - CN - SG company_country_codes: - CN - FR domains: - insead.edu - digitalchina.com companies: - logo_url: >- https://buckets.pubrio.com/company-logo/MjY5OTY5NDJpbnNlYWQuZWR1bGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: dfbe6797-5311-46f9-9518-bf1a7c3d09bc country_code: FR company_name: Insead linkedin_name: insead domain: insead.edu - logo_url: >- https://buckets.pubrio.com/company-logo/NDA2NTQ5NTFkaWdpdGFsY2hpbmEuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: e13a9e24-a07d-4630-9b47-fceb778df74e country_code: CN company_name: Digital China linkedin_name: digital-china domain: digitalchina.com news_galleries: - slug: banking-financial-service news_gallery_id: 7c8ec9cc-66c5-4153-82da-9c8f356c6c99 name: Banking/Financial Service locations: - Singapore - China last_modified: '2025-06-01T08:15:23.945Z' image_url: null url: http://enold.prnasia.com/p/asia-story-125304015-0.shtml published_at: '2025-06-01T08:00:00.000Z' language: id source: prnasia.com category: launches title: >- Digital China's AI-driven transformation showcased at INSEAD summary: >- Guo Wei, Chairman of Digital China, presented on AI-era corporate management at INSEAD 2025 Asia AI Conference, launching a case study on Digital China's AI transformation journey. news_category_name: Launches - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: 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. 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. 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. news_search_id: type: string format: uuid example: 4110b929-17cd-42aa-a159-906ead0c9b56 description: >- Identificador único para la operación de búsqueda de noticias de la empresa. 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/` search_term: type: string example: pubrio description: Una cadena de palabras sobre la que queremos filtrar los resultados. 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. news_gallery_ids: type: array items: type: string format: uuid description: >- Una lista de `news_gallery_id` utilizada para buscar galerías de noticias específicas. Para encontrar el ID, llama al endpoint `news galleries` 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. news_published_at_from: type: string format: date-time example: '2026-09-01T00:00:00Z' description: >- Publicado en este instante o después (UTC). Fecha o marca de tiempo ISO. `published_dates` es la forma de ventana cerrada y utiliza la zona horaria de tu espacio de trabajo. 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**. is_ascending_order: type: boolean default: false example: false description: >- Dirección de ordenación. Los resultados se devuelven por defecto de más reciente a más antiguo; establece `true` para el orden inverso (de más antiguo a más reciente). No existe `sort_by` en este endpoint: la clave de ordenación es fija y se indica en la descripción del endpoint. is_expansion_signal_available: type: boolean description: >- Cuando es `true`, adjunta las señales de expansión resueltas (`expansion_signals`) a cada noticia y habilita los filtros `expansion_signal_types` / `expansion_signal_polarities`. Déjalo sin definir para la búsqueda más rápida: la combinación con expansión solo se añade cuando este indicador está activado. expansion_signal_types: type: array items: type: string enum: - AD - AUDIENCE - DNS - ENTITY - EVENT - EVENT_PLUS - EXEC - HIRE - INFRA - IP - NEWS - OFFICE - PARTNER - PRODUCT - REG - SCALE - TECH example: - HIRE - PARTNER description: >- Devuelve solo las noticias que generaron una señal de expansión de alguno de estos tipos (slugs en mayúsculas). Requiere `is_expansion_signal_available: true`. Los slugs desconocidos se ignoran. expansion_signal_polarities: type: array items: type: string enum: - expansion - contraction_leading - contraction_confirming - contraction_lagging example: - expansion description: >- Devuelve solo las noticias cuya señal de expansión tenga alguna de estas polaridades. Requiere `is_expansion_signal_available: true`. Se combina con `expansion_signal_types` mediante AND. search_metadata: type: object description: Contexto de la solicitud. properties: profile: type: object nullable: true description: >- Bloque de créditos (`credit`, `topup_credit`, `total_credit_cost`) cuando se solicita la contabilidad de créditos; `null` en el tráfico simple con clave de API. filters: type: object description: >- Eco del cuerpo de la solicitud tal como lo aplicó el endpoint, incluidos valores predeterminados como `per_page` y `language`. ignored_fields: type: array items: type: string description: >- Claves del cuerpo que el endpoint no reconoció y descartó. Si está vacío, significa que se aplicaron todas las claves; un filtro mal escrito amplía la búsqueda en lugar de fallar. search_pagination: type: object description: Paginación del conjunto de resultados. properties: page: type: integer description: Número de página actual. per_page: type: integer description: Registros por página. total_entries: type: integer description: >- Total de registros coincidentes. En búsquedas amplias e independientes de empresa, este valor es una estimación. total_pages: type: integer description: '`total_entries` dividido entre `per_page`.' total_display_pages: type: integer description: >- Páginas que realmente puedes solicitar, limitadas por el `max_search_page` de tu plan. is_timeout: type: boolean description: >- `true` cuando la consulta de conteo excedió el tiempo de espera y `total_entries` es una estimación parcial. news_search_result: type: object description: Un artículo de noticias. properties: news_id: type: string format: uuid description: Identificador del artículo. news_search_id: type: string format: uuid description: Identificador del registro de búsqueda. Pásalo a News Lookup. title: type: string description: Titular. summary: type: string description: Breve resumen del artículo. nullable: true url: type: string description: Enlace al artículo. source: type: string description: Dominio del editor. nullable: true image_url: type: string description: Imagen principal, cuando el artículo tiene una. nullable: true language: type: string description: >- Código de idioma ISO 639-1 del artículo. Mismo vocabulario que el filtro `news_languages`. nullable: true published_at: type: string format: date-time description: >- Hora de publicación. Esta es la clave de ordenación predeterminada (los artículos sin fecha se ordenan al final). nullable: true last_modified: type: string format: date-time description: Cuándo se actualizó el registro por última vez. category: type: string description: >- Slug de categoría de noticias. Mismo vocabulario que el filtro `categories` y el endpoint de categorías de noticias. nullable: true news_category_name: type: string description: Nombre de categoría legible, localizado según `language`. nullable: true news_galleries: type: array nullable: true items: type: object properties: news_gallery_id: type: string format: uuid slug: type: string name: type: string description: >- Galerías a las que pertenece el artículo; `null` si no pertenece a ninguna. country_codes: type: array nullable: true items: type: string description: >- Países sobre los que trata el artículo (ISO 3166-1 alfa-2); `null` cuando no se detecta. Mismo vocabulario que el filtro `locations`. company_country_codes: type: array nullable: true items: type: string description: >- Países de la sede de las empresas mencionadas. Mismo vocabulario que el filtro `company_locations`. locations: type: array nullable: true items: type: string description: >- Nombres de lugares mencionados en el artículo; `null` si no hay ninguno. domains: type: array items: type: string description: Dominios de todas las empresas que menciona el artículo. companies: type: array items: $ref: '#/components/schemas/search_result_company' description: >- Todas las empresas que menciona el artículo, en el mismo orden que `domains`. expansion_signals: type: array items: type: object properties: signal_type_slug: type: string description: Tipo de señal, p. ej. `HIRE`, `PARTNER`, `PRODUCT`. signal_subtype_slug: type: string description: Subtipo de señal, cuando el tipo tiene uno. nullable: true signal_strength_slug: type: string description: 'Intensidad de la señal: `low`, `medium`, `high`, `very_high`.' polarity: type: string description: >- `expansion`, `contraction_leading`, `contraction_confirming` o `contraction_lagging`. country_code: type: string description: Mercado al que apunta la señal. nullable: true domain_search_id: type: string format: uuid description: Empresa a la que pertenece la señal. event_date: type: string format: date-time description: Cuándo ocurrió la señal. description: >- Solo cuando `is_expansion_signal_available: true`: las señales de expansión que generó este artículo. Arreglo vacío si no hay ninguna. search_result_company: type: object description: La empresa a la que está vinculado el registro. properties: domain_search_id: type: string format: uuid description: >- Identificador de empresa de Pubrio. Pásalo a `companies` en cualquier búsqueda, o a Company Lookup. company_name: type: string description: Nombre de la empresa. linkedin_name: type: string nullable: true description: >- Slug de empresa de LinkedIn (la parte después de `linkedin.com/company/`). country_code: type: string nullable: true description: Código ISO 3166-1 alfa-2 de la sede de la empresa. company_url: type: string nullable: true description: URL del sitio web de la empresa. domain: type: string description: Dominio de la empresa, normalizado (`stripe.com`). logo_url: type: string nullable: true description: URL del logotipo de la empresa. 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 ````