Skip to main content
POST
Buscar noticias de empresas

Autorizaciones

pubrio-api-key
string
header
requerido

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.

Cuerpo

application/json
locations
string[]

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.

Ejemplo:
company_locations
string[]

La ubicación de la sede de la empresa. Consulta los endpoints location en la pestaña Filters para más información.

Ejemplo:
companies
string<uuid>[]

Una lista de identificadores únicos (domain_search_id) utilizada para operaciones de búsqueda de empresas y personas.

news_search_id
string<uuid>

Devuelve únicamente este registro. Útil para volver a obtener una fila que guardaste antes sin paginar.

Ejemplo:

"4110b929-17cd-42aa-a159-906ead0c9b56"

domains
string[]

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.

Ejemplo:
linkedin_urls
string[]

La URL completa del perfil de LinkedIn de la empresa. La URL debe empezar por http y contener linkedin.com/company/

Ejemplo:
search_term
string

Una cadena de palabras sobre la que queremos filtrar los resultados.

Ejemplo:

"pubrio"

search_terms
string[]

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.

Ejemplo:
categories
string[]

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.

Ejemplo:

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
string[]

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.

Ejemplo:
published_at
string<date-time>

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.

Ejemplo:

"2026-09-01T00:00:00Z"

per_page
integer
predeterminado:25

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. 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.

Rango requerido: x <= 25
Ejemplo:

25

page
integer
predeterminado:1

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. Superarlo devuelve HTTP 416.

Ejemplo:

1

is_ascending_order
boolean
predeterminado:false

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.

Ejemplo:

false

news_galleries
string[]

Lista de gallery slugs para filtrar noticias por galería. Para encontrar un slug, llama al endpoint news galleries en la pestaña Filters.

Ejemplo:
news_languages
string[]

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.

Ejemplo:
is_expansion_signal_available
boolean

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
enum<string>[]

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.

Opciones disponibles:
AD,
AUDIENCE,
DNS,
ENTITY,
EVENT,
EVENT_PLUS,
EXEC,
HIRE,
INFRA,
IP,
NEWS,
OFFICE,
PARTNER,
PRODUCT,
REG,
SCALE,
TECH
Ejemplo:
expansion_signal_polarities
enum<string>[]

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.

Opciones disponibles:
expansion,
contraction_leading,
contraction_confirming,
contraction_lagging
Ejemplo:

Respuesta

Respuesta exitosa que contiene los detalles de la búsqueda de noticias de empresas.

metadata
object

Contexto de la solicitud.

data
object
Última modificación el 4 de septiembre de 2026