# Pubrio Documentation: Spanish Primeros pasos Documentación de la API

> Pubrio API documentation — market expansion intelligence: detect when companies enter new markets via typed, dated signals across 200+ markets, with company & people enrichment, search, lookup, and real-time monitors. REST API reference, guides, and concept docs.

## Documentación de la API

### Documentación de la API

- [Descripción general de la API de Pubrio](https://docs.pubrio.com/es/api-reference/introduction.md): Referencia completa de la API REST de Pubrio — endpoints para enriquecimiento de empresas y personas, búsqueda, lookup, canje, monitores en tiempo real y más.
- [Autenticación](https://docs.pubrio.com/es/api-reference/authentication.md): Autentica las solicitudes a la API de Pubrio mediante el encabezado `pubrio-api-key` — configuración, gestión de claves y prácticas recomendadas de seguridad.
- [Límite de tasa](https://docs.pubrio.com/es/api-reference/rate-limits.md): Límite de tasa para garantizar la estabilidad y fiabilidad del servicio.
- [Códigos de estado / Errores](https://docs.pubrio.com/es/api-reference/status-codes.md): Pubrio utiliza códigos de estado HTTP / error para indicar el resultado de tus solicitudes.
- [Enumeraciones y constantes](https://docs.pubrio.com/es/api-reference/enums.md): Todos los valores fijos que la API de Pubrio acepta o devuelve — niveles de seniority, funciones de empleo, fuentes y formatos de anuncios, niveles de alcance, tipos de señal, niveles de gestión — en una sola página.
- [Logo API](https://docs.pubrio.com/es/api-reference/logo-api.md): Búsqueda gratuita y pública de logotipos de empresas por dominio. Incorpora logotipos de empresas en tu CRM, dashboards, páginas de marketing o secuencias con una simple URL — sin necesidad de API key.

### Endpoints

#### Perfil (espacio de trabajo)

- [Detalles del perfil](https://docs.pubrio.com/es/api-reference/endpoint/profile/profile.md): Obtén los detalles del perfil actual del espacio de trabajo, incluida la información del plan y la configuración.
- [Uso del perfil](https://docs.pubrio.com/es/api-reference/endpoint/profile/profile-usage.md): Obtén las estadísticas de consumo de créditos y cuota del perfil actual del espacio de trabajo.
- [Detalles del usuario](https://docs.pubrio.com/es/api-reference/endpoint/user/user.md): Obtén los detalles del usuario autenticado actualmente.

#### Claves de API

- [Listar registros de solicitudes de la API](https://docs.pubrio.com/es/api-reference/endpoint/api-keys/logs.md): Obtén una lista paginada de registros de solicitudes de API del espacio de trabajo. Cada entrada resume una única solicitud realizada con una `pubrio-api-key`, incluyendo la ruta, el método, el código de estado, la duración, el tamaño de la respuesta y el coste en créditos. Usa el endpoint [Consulta…
- [Consultar registro de solicitud de la API](https://docs.pubrio.com/es/api-reference/endpoint/api-keys/logs_lookup.md): Obtén el cuerpo completo de la solicitud, las cabeceras de la solicitud, el cuerpo de la respuesta y el tamaño de la respuesta de una entrada de registro de solicitud a la API específica. Úsalo para inspeccionar lo que se envió o se devolvió para un `query_log_id` determinado, descubierto mediante e…
- [Uso diario de la API](https://docs.pubrio.com/es/api-reference/endpoint/api-keys/usage_daily.md): Obtén un desglose diario de las solicitudes a la API y los créditos consumidos por el espacio de trabajo dentro de un intervalo de fechas. La respuesta incluye una serie temporal por día y una serie apilada por endpoint, adecuadas para crear gráficos de uso.
- [Desglose de uso de la API](https://docs.pubrio.com/es/api-reference/endpoint/api-keys/usage_breakdown.md): Obtén un desglose de las solicitudes a la API y los créditos consumidos dentro de un rango de fechas, agrupados tanto por clave de API individual (`by_key`) como por endpoint (`by_endpoint`). Útil para identificar las claves con mayor tráfico y los endpoints que más créditos consumen en todo el espa…

#### Enriquecimiento

- [Enriquecimiento de la consulta de empresas](https://docs.pubrio.com/es/api-reference/endpoint/companies/enrichment.md): Enriquecimiento de empresas en tiempo real. Devuelve el registro de la empresa junto con sus señales recientes de contratación, medios, publicidad y empresas similares en una sola llamada.

#### Afines

- [Búsqueda de empresas afines](https://docs.pubrio.com/es/api-reference/endpoint/companies/similar.md): **Obsoleto.** Usa `POST /companies/search/similar` en su lugar. El cuerpo de la solicitud es el mismo; los resultados se devuelven en `data.lookalikes` con un objeto `data.pagination`.
- [Buscar empresas similares](https://docs.pubrio.com/es/api-reference/endpoint/companies/search_similar.md): Encuentra empresas similares a una empresa de referencia. Proporciona exactamente un identificador singular (`domain_search_id`, `domain`, `linkedin_url` u otro `*_url`). Cada fila incluye un `similarity_score` entre 0 y 1.
- [Buscar personas similares](https://docs.pubrio.com/es/api-reference/endpoint/people/search_similar.md): Encuentra personas similares a una persona o cargo de referencia. Proporciona una referencia (`people_search_id`, `linkedin_url`, `linkedin_urls`, `peoples` o `people_titles`). Cada persona incluye un `similarity_score` entre 0 y 1. La referencia solo define qué significa similar; cualquier otro fil…

#### Consulta

- [Consulta de empresas](https://docs.pubrio.com/es/api-reference/endpoint/companies/lookup.md): Obtén información detallada sobre una empresa específica usando su ID de búsqueda de Pubrio, dominio o URL de LinkedIn.
- [Consulta de empresas afines (alias)](https://docs.pubrio.com/es/api-reference/endpoint/companies/similar_lookup.md): Alias heredado de Company Lookup: devuelve el registro único de la empresa correspondiente a un ID de búsqueda de Pubrio, un dominio o una URL de LinkedIn. Para encontrar empresas similares, usa Similar Company Search.
- [Consulta de empleos de la empresa](https://docs.pubrio.com/es/api-reference/endpoint/companies/job_lookup.md): Obtén los detalles de una oferta de empleo de una empresa específica usando un ID de búsqueda de empleo.
- [Consulta de noticias de la empresa](https://docs.pubrio.com/es/api-reference/endpoint/companies/news_lookup.md): Obtén los detalles de un artículo de noticias de una empresa específica usando un ID de búsqueda de noticias.
- [Consulta de anuncios de la empresa](https://docs.pubrio.com/es/api-reference/endpoint/companies/advertisements_lookup.md): Obtén los detalles de un anuncio de una empresa específica usando un ID de búsqueda de anuncios. La respuesta incluye la `destination_url` resuelta, la `raw_link_url` original y, para anuncios de Meta, `publisher_platforms`.
- [Consulta de la huella cloud de la empresa](https://docs.pubrio.com/es/api-reference/endpoint/companies/cloud_footprints_lookup.md): Devuelve una única fila de huella cloud por su identificador, con sus regiones cloud, ciudades y una muestra reciente de la infraestructura. Consulta la [guía de búsqueda de huella cloud](/es/developer-guides/search/cloud-footprint-search).
- [Consulta de tecnologías de la empresa](https://docs.pubrio.com/es/api-reference/endpoint/companies/technology_lookup.md): Recupera información detallada sobre una tecnología específica utilizada por las empresas.
- [Consulta de personas](https://docs.pubrio.com/es/api-reference/endpoint/people/lookup.md): Obtén información detallada sobre una persona específica usando su ID de búsqueda de Pubrio o su URL de LinkedIn.

#### Búsqueda

- [Búsqueda de empresas](https://docs.pubrio.com/es/api-reference/endpoint/companies/search.md): Busca en la base de datos de Pubrio empresas que coincidan con criterios específicos como industria, tamaño, ubicación y tecnologías.
- [Búsqueda de empleos de la empresa](https://docs.pubrio.com/es/api-reference/endpoint/companies/job_search.md): Busca ofertas de empleo. Consulta la [guía de búsqueda de empleos](/es/developer-guides/search/job-search).
- [Búsqueda de noticias de la empresa](https://docs.pubrio.com/es/api-reference/endpoint/companies/news_search.md): Busca noticias sobre empresas. Consulta la [guía de búsqueda de noticias](/es/developer-guides/search/news-search).
- [Búsqueda de anuncios de la empresa](https://docs.pubrio.com/es/api-reference/endpoint/companies/advertisements_search.md): Busca anuncios publicados por empresas. Consulta la [guía de búsqueda de anuncios](/es/developer-guides/search/advertisement-search).
- [Búsqueda de la huella cloud de la empresa](https://docs.pubrio.com/es/api-reference/endpoint/companies/cloud_footprints_search.md): Busca la huella pública de cloud y hosting de las empresas: qué proveedores usan y en qué países y regiones despliegan. Cada fila es una empresa en un proveedor y un país. Consulta la [guía de búsqueda de huella cloud](/es/developer-guides/search/cloud-footprint-search).
- [Búsqueda de personas](https://docs.pubrio.com/es/api-reference/endpoint/people/search.md): Busca en la base de datos de Pubrio personas que coincidan con criterios específicos como cargo, ubicación, empresa y antigüedad.

#### Estadísticas

- [Estadísticas de empleos de la empresa](https://docs.pubrio.com/es/api-reference/endpoint/companies/job_insights.md): Estadísticas agregadas de señales de contratación de una empresa en una ventana de fechas: volumen de publicaciones, distribución de antigüedad, principales funciones/departamentos/ubicaciones, y una serie temporal semanal.
- [Estadísticas de noticias de la empresa](https://docs.pubrio.com/es/api-reference/endpoint/companies/news_insights.md): Estadísticas agregadas de señales de noticias de una empresa en una ventana de fechas: volumen de menciones, principales temas y fuentes, desgloses por categoría y mercado, y una serie temporal semanal.
- [Información de anuncios de la empresa](https://docs.pubrio.com/es/api-reference/endpoint/companies/advertisements_insights.md): Estadísticas agregadas de señales publicitarias de una empresa en una ventana de fechas: recuento de anuncios activos y lanzados, combinación de canales y ubicaciones, muestras creativas, alcance de audiencia como distribución por niveles, y una serie temporal semanal. El alcance se reporta como una…
- [Información de la huella cloud de la empresa](https://docs.pubrio.com/es/api-reference/endpoint/companies/cloud_footprints_insights.md): La huella cloud de una empresa en una sola llamada: totales, principales proveedores, países y regiones, hosts nuevos por semana, los hosts más recientes y alertas de los cambios que merece la pena atender. Consulta la [guía de Análisis de huella cloud](/es/developer-guides/search/cloud-footprint-in…

#### Expansión

- [Resumen de expansión](https://docs.pubrio.com/es/api-reference/endpoint/expansions/dashboard.md): KPI de expansión a nivel de mercado — recuentos de etapas por mercado y los principales flujos transfronterizos. Agregado, no paginado. Responde `408` cuando la solicitud no puede completarse a tiempo.
- [Búsqueda de expansión](https://docs.pubrio.com/es/api-reference/endpoint/expansions/market_lookup.md): Encuentra empresas que se están expandiendo a uno o más mercados mediante filtros firmográficos y de señales o una consulta en lenguaje natural, con explicaciones de coincidencia generadas por IA opcionales y basadas en las señales reales de cada empresa. Envía al menos uno de `tos`, `froms`, `compa…
- [Detalle de expansión de empresa](https://docs.pubrio.com/es/api-reference/endpoint/expansions/company_lookup.md): Perfil de expansión detallado para una sola empresa (etapa actual, señales, presencia en el mercado e historial de transición de etapas) para un mercado o agregado en todos los mercados.
- [Comparar expansiones de empresas](https://docs.pubrio.com/es/api-reference/endpoint/expansions/company_compare.md): Compara la huella de expansión de varias empresas en paralelo, con pares comparables opcionales para una empresa objetivo.
- [Resúmenes de expansión de empresas por lote](https://docs.pubrio.com/es/api-reference/endpoint/expansions/company_summaries.md): Resúmenes de expansión listos para renderizar de un lote de empresas, preparados para comparación en paralelo sin agregación del lado del cliente.
- [Eventos de señales de empresa](https://docs.pubrio.com/es/api-reference/endpoint/expansions/company_pulse_events.md): Desglose enriquecido y paginado de los eventos de señales que impulsan la expansión de una sola empresa.
- [Clasificación de expansión](https://docs.pubrio.com/es/api-reference/endpoint/expansions/company_markers.md): Lista clasificada y ligera de pares empresa/mercado por puntuación de expansión, apta para representarse en mapas o mapas de calor.
- [Búsqueda de señales de expansión](https://docs.pubrio.com/es/api-reference/endpoint/expansions/signal_search.md): Filas de señales de expansión sin procesar y paginadas: la evidencia fechada detrás de la etapa de cada empresa, con la fuente y la URL de evidencia.

#### Canjear

- [Canjear personas - Individual](https://docs.pubrio.com/es/api-reference/endpoint/redeem/people.md): Gasta créditos para desbloquear los datos de contacto completos (correo electrónico, teléfono) de una persona específica.
- [Canjear personas - Masivo](https://docs.pubrio.com/es/api-reference/endpoint/redeem/people/batch.md): Envía una solicitud en lote para desbloquear los datos de contacto de varias personas a la vez.
- [Canjear personas - Estado masivo](https://docs.pubrio.com/es/api-reference/endpoint/redeem/people/batch/query.md): Comprueba el estado y los resultados de una solicitud de canje en lote enviada previamente.
- [Consulta de contacto - Individual](https://docs.pubrio.com/es/api-reference/endpoint/redeem/people/contact/lookup.md): Consulta inversa de una persona por correo electrónico, teléfono o nombre y apellido más dominio o empresa. Devuelve el `people_search_id` y los datos básicos de la persona encontrada, además de los metadatos `match` que describen cómo se hizo la coincidencia. Cobra 1 crédito por coincidencia factur…
- [Consulta de contacto - Masiva](https://docs.pubrio.com/es/api-reference/endpoint/redeem/people/contact/lookup/batch.md): Versión en lote de `/redeem/people/contact/lookup`. Envía hasta el límite de tamaño de lote de tu suscripción en una sola solicitud. Cada entrada en `peoples` acepta los mismos identificadores que el cuerpo de una consulta individual. Cobra 1 crédito por coincidencia facturable. Las entradas duplica…

#### LinkedIn

- [Consulta de empresas en LinkedIn (en tiempo real)](https://docs.pubrio.com/es/api-reference/endpoint/companies/linkedin_lookup.md): Obtén los detalles de una empresa usando la URL de una página de empresa de LinkedIn. Proporciona obtención de datos en tiempo real.
- [Consulta de personas en LinkedIn (en tiempo real)](https://docs.pubrio.com/es/api-reference/endpoint/people/linkedin_lookup.md): Obtén los detalles de una persona usando la URL de un perfil de LinkedIn. Proporciona obtención de datos en tiempo real.

#### Canales

##### Tipos

- [Tipo de plantilla de canal](https://docs.pubrio.com/es/api-reference/endpoint/channels/types/template_types.md): Obtén los tipos de canal disponibles para plantillas de outreach.

##### Plantillas

- [Plantillas de canal](https://docs.pubrio.com/es/api-reference/endpoint/channels/templates/templates.md): Obtén una lista de todas las plantillas de outreach de canal en el espacio de trabajo.
- [Crear plantilla de canal](https://docs.pubrio.com/es/api-reference/endpoint/channels/templates/create.md): Crea una nueva plantilla de canal de outreach con los parámetros especificados.
- [Crear versión de plantilla de canal](https://docs.pubrio.com/es/api-reference/endpoint/channels/templates/create_version.md): Crea una nueva versión de una plantilla de canal existente.
- [Establecer plantilla de canal predeterminada](https://docs.pubrio.com/es/api-reference/endpoint/channels/templates/default.md): Obtén la plantilla de canal predeterminada del espacio de trabajo.
- [Consulta de plantilla de canal](https://docs.pubrio.com/es/api-reference/endpoint/channels/templates/lookup.md): Obtén los detalles de una plantilla de canal específica por ID.
- [Actualizar plantilla de canal](https://docs.pubrio.com/es/api-reference/endpoint/channels/templates/update.md): Actualiza la configuración de una plantilla de canal existente.
- [Eliminar plantilla de canal](https://docs.pubrio.com/es/api-reference/endpoint/channels/templates/delete.md): Elimina una plantilla de canal del espacio de trabajo.

#### Monitor

- [Obtener lista de monitores](https://docs.pubrio.com/es/api-reference/endpoint/monitors/monitors.md): Recupera una lista de todos los monitores del espacio de trabajo.
- [Crear monitor](https://docs.pubrio.com/es/api-reference/endpoint/monitors/create.md): Crea un monitor de datos: una vigilancia siempre activa que muestra continuamente las señales de negocio que te interesan (nuevas ofertas de empleo, noticias, anuncios o movimientos de expansión de mercado) a partir de las empresas y filtros que definas, enriquece cada coincidencia con datos de empr…
- [Interpretar monitor](https://docs.pubrio.com/es/api-reference/endpoint/monitors/interpret.md): Obtén una vista previa de un monitor antes de crearlo: convierte una solicitud en lenguaje sencillo (en cualquier idioma) en una configuración de **borrador** validada que puedes inspeccionar, ajustar y luego enviar a [Create Monitor](/es/api-reference/endpoint/monitors/create). Es seguro llamarlo t…
- [Actualizar monitor](https://docs.pubrio.com/es/api-reference/endpoint/monitors/update.md): Actualiza la configuración y las reglas de detección de un monitor existente.
- [Duplicar monitor](https://docs.pubrio.com/es/api-reference/endpoint/monitors/duplicate.md): Crea una copia de un monitor existente con la misma configuración.
- [Eliminar monitor](https://docs.pubrio.com/es/api-reference/endpoint/monitors/delete.md): Elimina un monitor del espacio de trabajo.
- [Consulta de monitor](https://docs.pubrio.com/es/api-reference/endpoint/monitors/lookup.md): Recupera información detallada sobre un monitor específico.
- [Revelación de firma de monitor](https://docs.pubrio.com/es/api-reference/endpoint/monitors/signature_reveal.md): Obtén el secreto de firma de webhook de un monitor.
- [Validar webhook de monitor](https://docs.pubrio.com/es/api-reference/endpoint/monitors/webhook_validate.md): Envía una carga útil de prueba firmada a una URL de webhook e informa si fue aceptada.

##### Estadísticas

- [Estadísticas de monitor](https://docs.pubrio.com/es/api-reference/endpoint/monitors/statistics.md): Obtén una visión general, a nivel de todo el espacio de trabajo, de las estadísticas de activación de monitores. No hay parámetro monitor_id: las cifras se agregan de todos los monitores del espacio de trabajo (se excluyen los monitores basados en listas de seguimiento).
- [Registros de estadísticas de monitor](https://docs.pubrio.com/es/api-reference/endpoint/monitors/statistics_logs.md): Recupera una lista paginada de registros de detección de un monitor específico.
- [Consulta de registro de estadísticas de monitor](https://docs.pubrio.com/es/api-reference/endpoint/monitors/statistics_logs_lookup.md): Recupera los detalles de una entrada específica del registro de detección del monitor.
- [Gráfico de estadísticas de monitor](https://docs.pubrio.com/es/api-reference/endpoint/monitors/statistics_chart.md): Obtén datos de series temporales listos para graficar de un monitor.

##### Procesamiento

- [Prueba de proceso de monitor](https://docs.pubrio.com/es/api-reference/endpoint/monitors/process_try.md): Ejecuta un monitor guardado por su id, o ejecuta una configuración ad-hoc no guardada pasando la configuración en línea; con monitor_id, los campos en línea sobrescriben el monitor guardado para esta ejecución.
- [Reintento de proceso de monitor](https://docs.pubrio.com/es/api-reference/endpoint/monitors/process_retry.md): Reintenta una ejecución de procesamiento de monitor fallida.

#### Filtros

- [Tecnologías](https://docs.pubrio.com/es/api-reference/endpoint/technologies/technologies.md): Obtén la lista de tecnologías disponibles para los filtros de búsqueda.
- [Categorías de tecnología](https://docs.pubrio.com/es/api-reference/endpoint/technologies/categories.md): Obtén la lista de categorías de tecnología para filtrar.
- [Ubicaciones](https://docs.pubrio.com/es/api-reference/endpoint/locations/locations.md): Obtén la lista de ubicaciones disponibles para los filtros de búsqueda.
- [Tamaño de la empresa](https://docs.pubrio.com/es/api-reference/endpoint/company-size/company-size.md): Obtén la lista de categorías de tamaño de empresa para filtrar.
- [Niveles de gestión](https://docs.pubrio.com/es/api-reference/endpoint/management-levels/management-levels.md): Obtén la lista de niveles de gestión y antigüedad para filtrar.
- [Departamentos](https://docs.pubrio.com/es/api-reference/endpoint/departments/departments.md): Obtén la lista de cargos de departamento para filtrar.
- [Función del departamento](https://docs.pubrio.com/es/api-reference/endpoint/departments/function.md): Obtén la lista de funciones de departamento para filtrar.
- [Verticales](https://docs.pubrio.com/es/api-reference/endpoint/verticals/verticals.md): Obtén la lista de verticales de industria para filtrar.
- [Categorías verticales](https://docs.pubrio.com/es/api-reference/endpoint/verticals/vertical_categories.md): Obtén la lista de categorías verticales para filtrar.
- [Subcategorías verticales](https://docs.pubrio.com/es/api-reference/endpoint/verticals/vertical_sub_categories.md): Obtén la lista de subcategorías verticales para filtrar.
- [Categorías de noticias](https://docs.pubrio.com/es/api-reference/endpoint/news/categories.md): Obtén la lista de categorías de artículos de noticias para filtrar.
- [Galerías de noticias](https://docs.pubrio.com/es/api-reference/endpoint/news/galleries.md): Obtén la lista de galerías de noticias para filtrar.
- [Idiomas de noticias](https://docs.pubrio.com/es/api-reference/endpoint/news/languages.md): Obtén la lista de idiomas disponibles para filtrar noticias.
- [Filtros de expansión](https://docs.pubrio.com/es/api-reference/endpoint/expansions/types.md): Catálogo de referencia para la taxonomía de expansión (etapas, tipos de señal, intensidades, polaridades, impulso y actualidad) que se usa para resolver los valores devueltos por los demás endpoints de expansión.

#### Varios

- [Zonas horarias](https://docs.pubrio.com/es/api-reference/endpoint/timezones/timezones.md): Obtén la lista de zonas horarias admitidas.

## OpenAPI Specs

- [es-openapi](/es/api-reference/es-openapi.json)