> ## 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. # Información de anuncios de la empresa > 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 distribución por niveles, nunca como una cifra única sumada. ## OpenAPI ````yaml es-openapi POST /companies/advertisements/insights 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/advertisements/insights: post: tags: - Insights summary: Estadísticas de anuncios description: >- 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 distribución por niveles, nunca como una cifra única sumada. operationId: companies_advertisements_insights requestBody: required: true content: application/json: schema: type: object required: - domain_search_id properties: domain_search_id: $ref: '#/components/schemas/domain_search_id' date_from: $ref: '#/components/schemas/date_from' date_to: $ref: '#/components/schemas/date_to' is_include_unlinked_companies: type: boolean example: false description: >- Incluye anuncios aún no vinculados a un perfil de empresa verificado. responses: '200': description: Bandas de estadísticas publicitarias para la empresa y la ventana. content: application/json: schema: type: object properties: data: type: object description: >- Bandas de estadísticas para la empresa y ventana solicitadas. properties: postings: type: array description: >- Resumen del volumen de anuncios, agrupado por nivel de alcance, mercados, canal y formato. Las claves están abreviadas para mantener la carga útil pequeña: `r` = slug del nivel de alcance (coincide con `reach_tiers[].slug`, `null` cuando la plataforma no reporta alcance), `m` = los mercados ISO 3166-1 alfa-2 donde se mostraron los anuncios, `ch` = canal de origen, `fo` = formato del anuncio, `n` = número de anuncios en este grupo. items: type: object reach_tiers: type: array description: >- El catálogo de etiquetas de nivel de alcance, ordenado de menor a mayor. Es una tabla de referencia, no una distribución — no lleva recuentos. Cruza `postings[].r` con `slug` para obtener la etiqueta legible, y lee el volumen por nivel en `postings[].n`. El alcance de un anuncio es un rango de texto en origen, por lo que los niveles nunca deben sumarse en una única cifra de alcance. items: type: object creatives: type: array description: >- Anuncios creativos recientes, priorizando imagen: primero los creativos con una imagen real, luego los anuncios de texto o video recientes para que los anunciantes sin imagen también aparezcan. `headline`, `body` y `cta` pueden ser cada uno `null`. Todo lo necesario para renderizar una galería de creativos está aquí — no se requiere una segunda llamada a la búsqueda de anuncios. items: type: object example: data: totals: total: 14 launched: 4 active: 4 markets: 46 channels: 2 weekly_series: - week_start: '2026-05-25' count: 4 postings: - r: 10k_50k m: - PE - KR - VE - AR ch: facebook fo: video 'n': 1 placement_mix: - key: INSTAGRAM count: 10 creatives: - advertisement_search_id: 29fbc4ec-d9f2-40dc-be00-c96856271f8c image_url: >- https://buckets.pubrio.com/images/public/fHaGeJ1EMBzgz2o4TMwgsRptA17BMn8U.jpg headline: null cta: Learn more advertisement_url: https://www.facebook.com/ads/library?id=1234567890 destination_url: https://www.instagram.com/youtube advertiser: YouTube body: this video lives rent free in our minds format: image has_video: false reach_tiers: - slug: lt_1k label: < 1K - slug: 1k_10k label: 1K–10K - slug: 10k_50k label: 10K–50K - slug: 50k_100k label: 50K–100K - slug: 100k_500k label: 100K–500K window_days: 90 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: domain_search_id: type: string format: uuid description: Identificador único para la operación de búsqueda de empresas. date_from: type: string format: date example: '2026-01-01' description: >- Inicio de la ventana de fechas (ISO 8601, AAAA-MM-DD). Úsalo junto con `date_to` para limitar los resultados a un rango específico; omite ambos para usar la ventana predeterminada. date_to: type: string format: date example: '2026-03-31' description: >- Fin de la ventana de fechas (ISO 8601, AAAA-MM-DD). Debe ser igual o posterior a `date_from`. 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 ````