Skip to main content
POST
Buscar 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
company_name
string

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.

Ejemplo:

"pubrio"

companies
string<uuid>[]

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

company_groups
integer[]

Limita a los miembros de estos grupos de empresas (ids), como el source_group_id o excluded_group_id de un monitor; paginado como cualquier búsqueda.

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:
company_filters
object

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.

Ejemplo:
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:
exclude_locations
string[]

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.

Ejemplo:
places
string[]

Nombres de lugares (ciudad, región) utilizados para filtrar resultados. Acepta nombres de lugares localizados o en inglés.

Ejemplo:
exclude_places
string[]

Nombres de lugares (ciudad, región) a excluir de los resultados. Acepta nombres de lugares localizados o en inglés.

Ejemplo:
job_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:
job_exclude_locations
string[]

Ubicaciones geográficas a excluir de los resultados de ofertas de empleo.

Ejemplo:
job_posted_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:
job_titles
string[]

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.

Ejemplo:
verticals
integer[]

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

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

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

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

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

Un nombre de producto que la lista de tecnologías conoce coincide con ese producto y sus propios productos ("Salesforce" también coincide con Salesforce Desk y Salesforce Service Cloud), nunca con productos parecidos; el resto del texto coincide por similitud.

exclude_technologies
string[]

Tecnologías que la empresa no debe usar, como tag_id o, con is_enable_similarity_search, nombres como ["Shopify"]. Una empresa sin tecnologías conocidas se mantiene.

Ejemplo:
employees
string[][]

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.

Ejemplo:
revenues
integer[]

Rango mínimo y máximo de ingresos de la empresa.

Ejemplo:
founded_dates
integer[]

Rango de años de fundación de la empresa. El valor máximo de fundación es el año en curso.

Ejemplo:
keywords
string[]

Una lista de palabras clave para filtrar empresas por relevancia, especialidades o descripciones.

Ejemplo:
social_media
enum<string>[]

Empresas con perfil en alguna de estas redes: linkedin, facebook, instagram, tiktok, twitter, x, github, wantedly, rocketpunch. Conviértelo en AND con filter_conditions.

Opciones disponibles:
linkedin,
facebook,
instagram,
tiktok,
twitter,
x,
github,
wantedly,
rocketpunch
Ejemplo:
news_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:
news_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:
advertisement_search_terms
string[]

Palabras clave utilizadas para buscar dentro del contenido o los títulos de los anuncios.

Ejemplo:
advertisement_target_locations
string[]

Ubicaciones geográficas objetivo para los anuncios.

Ejemplo:
advertisement_exclude_target_locations
string[]

Ubicaciones geográficas a excluir de la segmentación de anuncios.

Ejemplo:
advertisement_start_dates
string<date>[]

Rango de fecha de inicio para filtrar anuncios.

Ejemplo:
advertisement_end_dates
string<date>[]

Rango de fecha de fin para filtrar anuncios.

Ejemplo:
advertisement_active_dates
string<date>[]

Encuentra anuncios que estuvieron activos en algún momento dentro de este rango de fechas (basado en solapamiento: incluye anuncios que empezaron antes del rango y siguen activos, no solo los que empezaron dentro de él).

Ejemplo:
advertisement_status
enum<string>[]

currently_running: empresas con publicidad registrada. active_last_30_min: empresas cuya publicidad cambió en los últimos 30 minutos.

Opciones disponibles:
currently_running,
active_last_30_min
Ejemplo:
advertisement_headlines
string[]

Palabras clave a buscar dentro del texto del titular del anuncio.

Ejemplo:
advertisement_platforms
enum<string>[]

Filtra según de qué biblioteca de anuncios proviene el anuncio. En minúsculas, sin distinción entre mayúsculas y minúsculas. Se acepta meta como alias de facebook.

Opciones disponibles:
linkedin,
facebook,
google,
tiktok,
apple
Ejemplo:
advertisement_publisher_platforms
enum<string>[]

Filtra anuncios de Facebook/Meta según la superficie de plataforma en la que se entregaron. En minúsculas y sin distinción entre mayúsculas y minúsculas. Solo se aplica a la fuente facebook (las demás fuentes son de plataforma única).

Opciones disponibles:
facebook,
instagram,
messenger,
threads,
audience_network
Ejemplo:
advertisement_exclude_publisher_platforms
enum<string>[]

Excluye anuncios de Facebook/Meta entregados en estas superficies de plataforma.

Opciones disponibles:
facebook,
instagram,
messenger,
threads,
audience_network
Ejemplo:
advertisement_formats
enum<string>[]

Encuentra empresas con al menos un anuncio en cualquiera de estos formatos creativos.

Opciones disponibles:
image,
video,
text,
carousel,
dynamic_product,
document,
message,
event,
article,
spotlight,
follow,
job,
engagement
Ejemplo:
advertisement_active_ads
(integer | null)[]

Recuento mínimo y máximo de anuncios actualmente activos de la empresa, en todos los países. Usa null para un límite abierto, por ejemplo [1, null] para "al menos un anuncio activo".

Required array length: 2 elements
Ejemplo:
advertisement_running_ads
(integer | null)[]

Recuento mínimo y máximo de anuncios de la empresa que siguen activos (sin fecha de fin, o con fecha de fin futura). Actualmente solo se completa para anuncios de LinkedIn.

Required array length: 2 elements
Ejemplo:
advertisement_total_ads
(integer | null)[]

Recuento mínimo y máximo del total de anuncios registrados de la empresa, en todos los países.

Required array length: 2 elements
Ejemplo:
advertisement_platform_count
(integer | null)[]

Número mínimo y máximo de plataformas publicitarias distintas (linkedin, facebook, google, tiktok, apple) en las que la empresa está anunciando activamente.

Required array length: 2 elements
Ejemplo:
advertisement_format_count
(integer | null)[]

Número mínimo y máximo de formatos creativos de anuncio distintos que la empresa está utilizando activamente.

Required array length: 2 elements
Ejemplo:
advertisement_impressions_estimate
(integer | null)[]

Impresiones estimadas de anuncios, mínimas y máximas, sumadas en todos los países. Solo se cuentan los anuncios con un rango de impresiones reportado.

Required array length: 2 elements
Ejemplo:
advertisement_country_activity
object

Actividad publicitaria para un país específico. country es obligatorio, y debe establecerse al menos otro campo (un país por sí solo no coincide con nada). Para un total de todos los países, usa en su lugar los filtros de nivel superior advertisement_active_ads / advertisement_total_ads / advertisement_impressions_estimate.

Ejemplo:
sort_by
enum<string>

Orden de los resultados. Omítelo para el orden por relevancia predeterminado. advertisement_country_rank ordena por el rango publicitario de la empresa dentro del país indicado en advertisement_country_activity (rango 1 = mayor anunciante de ese mercado) y se ignora si ese filtro no está presente. Combínalo con is_ascending_order: false para listar primero a los anunciantes más pequeños. Aún no disponible: name (en ambos sentidos) y relevance con is_ascending_order: false: esas solicitudes agotan el tiempo de espera. Usa el orden de relevancia predeterminado, number_of_employees o founded_year en su lugar.

Opciones disponibles:
relevance,
name,
number_of_employees,
founded_year,
advertisement_country_rank
Ejemplo:

"advertisement_country_rank"

is_ascending_order
boolean

Dirección de ordenación para sort_by. Por defecto es ascendente, lo que para advertisement_country_rank significa los mayores anunciantes primero.

Ejemplo:

true

filter_conditions
object[]

Opciones de filtrado avanzado para búsquedas de empresas. Especifica condiciones combinando claves y operadores lógicos para refinar los resultados de búsqueda.

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
number<float>

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.

Ejemplo:

0.7

query
string

Búsqueda en lenguaje natural. Si se indica, Pubrio la interpreta en los filtros de empresa siguientes: sector (y sectores a excluir), especialidad, tecnología (y herramientas a excluir), perfiles sociales, país, región o ciudad de la sede, número de empleados, ingresos, año de fundación, puestos que se están contratando y dónde, eventos de noticias como "se expandió recientemente", publicidad (plataforma, formato, país objetivo, número de anuncios, impresiones, fechas, posición en un país) y alojamiento en la nube (proveedor, países y ciudades de los servidores, número de hosts y servidores, en total o en un país). Los valores unidos por "o" coinciden con cualquiera de ellos; las herramientas o perfiles unidos por "y" ("usa tanto Salesforce como HubSpot") deben coincidir todos. Los filtros explícitos que envíes también tienen prioridad sobre los interpretados. La parte de la frase que ningún filtro puede expresar (por ejemplo, la propiedad) se devuelve en metadata.unmatched_criteria en lugar de descartarse; una frase sin nada que buscar no devuelve resultados, con metadata.nl_no_intent: true.

Ejemplo:

"Food & Beverage companies in Singapore that recently expanded"

exclude_fields
string[]

Lista de campos a excluir de la carga útil de la respuesta.

Ejemplo:
is_parameter_metadata_available
boolean

Indica si hay metadatos de parámetros disponibles para la solicitud.

is_profile_metadata_available
boolean

Indica si hay metadatos de perfil disponibles para la solicitud.

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

cloud_footprint_providers
string[]

Empresas que usan alguno de estos proveedores en cualquier lugar. providers sin prefijo acota las filas; este acota las empresas.

Ejemplo:
cloud_footprint_exclude_providers
string[]

Excluye las filas que coincidan con proveedores cloud o de hosting. Limitado a esta fila de huella: un proveedor en un país.

Ejemplo:
cloud_footprint_target_locations
string[]

Empresas presentes en alguno de estos países en cualquier parte de su huella.

Ejemplo:
cloud_footprint_exclude_target_locations
string[]

Excluye las filas que coincidan con códigos de país donde está la infraestructura.

Ejemplo:
cloud_footprint_cloud_regions
string[]

Limita los resultados a las filas que coincidan con regiones cloud. Limitado a esta fila de huella: un proveedor en un país.

Ejemplo:
cloud_footprint_exclude_cloud_regions
string[]

Excluye las filas que coincidan con regiones cloud. Limitado a esta fila de huella: un proveedor en un país.

Ejemplo:
cloud_footprint_cities
string[]

Limita los resultados a las filas que coincidan con ciudades. Limitado a esta fila de huella: un proveedor en un país.

Ejemplo:
cloud_footprint_exclude_cities
string[]

Excluye las filas que coincidan con ciudades. Limitado a esta fila de huella: un proveedor en un país.

Ejemplo:
cloud_footprint_first_seen_dates
(string | null)[]

Dos fechas ISO 8601 (AAAA-MM-DD) que acotan cuándo se detectó por primera vez la huella. Limitado a esta fila de huella: un proveedor en un país.

Required array length: 2 elements
Ejemplo:
cloud_footprint_last_seen_dates
(string | null)[]

Dos fechas ISO 8601 (AAAA-MM-DD) que acotan cuándo se detectó por última vez la huella. Limitado a esta fila de huella: un proveedor en un país.

Required array length: 2 elements
Ejemplo:
cloud_footprint_is_cross_border_only
boolean

Si es true, devuelve solo filas fuera del mercado de origen de la empresa. Se excluyen las empresas sin sede conocida.

Ejemplo:

true

cloud_footprint_host_count
(integer | null)[]

Mínimo y máximo de hosts. Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_server_count
(integer | null)[]

Mínimo y máximo de servidores (IP distintas). Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_shared_server_count
(integer | null)[]

Mínimo y máximo de servidores compartidos con otras empresas. Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_provider_count
(integer | null)[]

Mínimo y máximo de proveedores distintos que usa la empresa. Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_country_count
(integer | null)[]

Mínimo y máximo de países donde aloja la empresa. Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_cross_border_country_count
(integer | null)[]

Mínimo y máximo de países fuera del mercado de origen. Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_region_count
(integer | null)[]

Mínimo y máximo de regiones cloud. Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_city_count
(integer | null)[]

Mínimo y máximo de ciudades. Usa null para dejar un extremo abierto. Contado para toda la empresa, en todos los proveedores y países.

Required array length: 2 elements
Ejemplo:
cloud_footprint_primary_provider
string[]

Empresas cuyo mayor proveedor es uno de estos.

Ejemplo:
cloud_footprint_country_activity
object

Límites acotados a un país: {"country":"DE","host_count":[100,null]} encuentra empresas con más de 100 hosts en Alemania concretamente. El cloud_footprint_host_count simple es el total de la empresa en todos los países, así que juntos no expresan esto. country por sí solo se rechaza.

Respuesta

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

metadata
object

Contexto de la solicitud: recent_search_log_identifier, parameters y filters reflejados, un bloque de crédito profile opcional, e ignored_fields (claves del cuerpo que el endpoint descartó).

data
object | null

La información de la respuesta depende del endpoint específico.

Última modificación el 4 de septiembre de 2026