> ## 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. # Resumen de expansión > KPI de expansión a nivel de mercado — recuentos de etapas por mercado y los principales flujos transfronterizos. Agregado, no paginado. ## OpenAPI ````yaml es-openapi POST /expansions/dashboard 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: /expansions/dashboard: post: tags: - Expansion summary: Expansion Overview description: >- KPI de expansión a nivel de mercado — recuentos de etapas por mercado y los principales flujos transfronterizos. Agregado, no paginado. operationId: expansions_dashboard requestBody: required: true content: application/json: schema: type: object properties: froms: $ref: '#/components/schemas/expansion_froms' tos: $ref: '#/components/schemas/expansion_tos' exclude_froms: $ref: '#/components/schemas/expansion_exclude_froms' exclude_tos: $ref: '#/components/schemas/expansion_exclude_tos' stages: allOf: - $ref: '#/components/schemas/expansion_stages' description: >- Los valores distinguen mayúsculas de minúsculas y **no se validan**. Un valor no reconocido se descarta silenciosamente en lugar de rechazarse: en `stages`, `freshness`, `scopes` y `momentum` se descarta el filtro completo y obtienes resultados *sin filtrar*, mientras que en `signal_types` y `signal_strengths` el filtro se aplica y no coincide con *nada*. En ambos casos, la respuesta parece normal. Resuelve los slugs válidos desde [Expansion Reference](/es/api-reference/endpoint/expansions/types) y compara `data.pagination.total_entries` con una llamada sin filtrar si un conjunto de resultados parece incorrecto. momentum: allOf: - $ref: '#/components/schemas/expansion_momentum' description: >- Trayectoria del movimiento de la empresa en el mercado. `advancing` indica que está ganando terreno, `steady` que se mantiene estable, `pulling_back` cubre la retirada y la contracción. **No** uses aquí los valores de `directions` en [Expansion Reference](/es/api-reference/endpoint/expansions/types). Esos (`advancing`, `steady`, `retreating`, `new`) son los valores de *respuesta* que obtienes en `stage.direction`; solo los tres indicados arriba se aceptan como *filtro*. Enviar `retreating` o `new` desactiva silenciosamente el filtro y devuelve resultados sin filtrar. freshness: allOf: - $ref: '#/components/schemas/expansion_freshness' description: >- Los valores distinguen mayúsculas de minúsculas y **no se validan**. Un valor no reconocido se descarta silenciosamente en lugar de rechazarse: en `stages`, `freshness`, `scopes` y `momentum` se descarta el filtro completo y obtienes resultados *sin filtrar*, mientras que en `signal_types` y `signal_strengths` el filtro se aplica y no coincide con *nada*. En ambos casos, la respuesta parece normal. Resuelve los slugs válidos desde [Expansion Reference](/es/api-reference/endpoint/expansions/types) y compara `data.pagination.total_entries` con una llamada sin filtrar si un conjunto de resultados parece incorrecto. scopes: $ref: '#/components/schemas/expansion_scopes' ahead_of_pace: type: boolean example: false description: >- Limita a los pares empresa/mercado que avanzan más rápido que el ritmo habitual de ese mercado. signal_types: allOf: - $ref: '#/components/schemas/expansion_signal_type_slugs' description: >- Los valores distinguen mayúsculas de minúsculas y **no se validan**. Un valor no reconocido se descarta silenciosamente en lugar de rechazarse: en `stages`, `freshness`, `scopes` y `momentum` se descarta el filtro completo y obtienes resultados *sin filtrar*, mientras que en `signal_types` y `signal_strengths` el filtro se aplica y no coincide con *nada*. En ambos casos, la respuesta parece normal. Resuelve los slugs válidos desde [Expansion Reference](/es/api-reference/endpoint/expansions/types) y compara `data.pagination.total_entries` con una llamada sin filtrar si un conjunto de resultados parece incorrecto. signal_strengths: allOf: - $ref: '#/components/schemas/signal_strengths' description: >- Los valores distinguen mayúsculas de minúsculas y **no se validan**. Un valor no reconocido se descarta silenciosamente en lugar de rechazarse: en `stages`, `freshness`, `scopes` y `momentum` se descarta el filtro completo y obtienes resultados *sin filtrar*, mientras que en `signal_types` y `signal_strengths` el filtro se aplica y no coincide con *nada*. En ambos casos, la respuesta parece normal. Resuelve los slugs válidos desde [Expansion Reference](/es/api-reference/endpoint/expansions/types) y compara `data.pagination.total_entries` con una llamada sin filtrar si un conjunto de resultados parece incorrecto. min_signal_count: type: integer example: 3 description: >- Número mínimo de señales de expansión que debe tener una empresa en la ventana de tiempo — "muy activa / presencia intensa". only_contraction: $ref: '#/components/schemas/only_contraction' verticals: $ref: '#/components/schemas/verticals' vertical_categories: $ref: '#/components/schemas/vertical_categories' vertical_sub_categories: $ref: '#/components/schemas/vertical_sub_categories' technologies: $ref: '#/components/schemas/technologies' employees: $ref: '#/components/schemas/employees' revenues: $ref: '#/components/schemas/revenues' founded_dates: $ref: '#/components/schemas/founded_dates' keywords: $ref: '#/components/schemas/keywords' companies: $ref: '#/components/schemas/expansion_companies' job_locations: $ref: '#/components/schemas/locations' job_exclude_locations: $ref: '#/components/schemas/job_exclude_locations' job_posted_dates: $ref: '#/components/schemas/posted_dates' job_titles: $ref: '#/components/schemas/people_titles' advertisement_target_locations: $ref: '#/components/schemas/advertisement_target_locations' advertisement_exclude_target_locations: $ref: '#/components/schemas/advertisement_exclude_target_locations' advertisement_search_terms: $ref: '#/components/schemas/advertisement_search_terms' advertisement_start_dates: $ref: '#/components/schemas/advertisement_start_dates' advertisement_end_dates: $ref: '#/components/schemas/advertisement_end_dates' news_categories: $ref: '#/components/schemas/news_categories' news_published_dates: $ref: '#/components/schemas/published_dates' transitioned_dates: type: array items: type: string format: date example: - '2026-06-01' - '2026-06-29' description: >- Rango de fechas ISO [start, end] para la ventana de visualización (mapa, flujos y línea temporal de la lista de seguimiento). El valor predeterminado son los últimos 90 días. El KPI `new_transitions_30d` siempre usa su propia ventana fija de 30 días, independientemente de este rango. window_days: $ref: '#/components/schemas/window_days' min_markets: type: integer example: 3 description: >- Número mínimo de mercados nuevos en los que debe haber entrado una empresa dentro de la ventana de tiempo (empresas de expansión amplia). home_country_code: type: array items: type: string example: - SG description: >- Filtra por país de origen de la empresa (ISO 3166-1 alfa-2). Se combina con `froms` cuando se proporcionan ambos. industries: $ref: '#/components/schemas/industries' exclude_industries: $ref: '#/components/schemas/exclude_industries' select_size: type: integer example: 250 description: >- Número máximo de mercados que se devuelven (limitado según el plan). flows_size: type: integer example: 50 description: >- Número máximo de flujos transfronterizos que se devuelven (limitado según el plan). is_include_metadata: allOf: - $ref: '#/components/schemas/expansion_is_include_metadata' description: >- Devuelve la carga completa de detalles. El tráfico con clave de API es reducido de forma predeterminada: el bloque `model`, las cifras de confianza (`stage.confidence` en Company Expansion Detail, `confidence_score` en `other_markets[]` y en los `markers[]` de Rankings) y los campos `established_min` / `share_of_detected` / `has_known_office` se omiten a menos que esto sea `true`. is_enable_similarity_search: type: boolean description: >- Habilita la coincidencia de texto libre para `verticals`, `vertical_categories`, `vertical_sub_categories` y `technologies`; estos filtros se descartan a menos que esto sea `true`. example: true responses: '200': description: Agregados del panel de mercado. content: application/json: schema: type: object properties: metadata: type: object data: type: object description: >- Contenedor del panel: mercados clasificados más los principales flujos de corredores. Réplica heredada obsoleta. Cada contenedor dentro de `data` también se emite en el nivel superior (`countries`, `top_flows`, `picks_aggregate`, `watchlist_markets`, `watchlist_timeline`) para clientes antiguos. Léelos desde `data`; las copias del nivel superior se eliminarán. properties: countries: type: array description: >- Mercados clasificados con recuentos de señales por mercado. items: type: object top_flows: type: array items: type: object description: >- Los mayores flujos de expansión transfronteriza, ordenados de mayor a menor actividad. picks_aggregate: type: array description: >- Resumen agregado de los mercados que coinciden con los filtros actuales. items: type: object watchlist_markets: type: array description: >- Recuentos de etapas por mercado limitados a las empresas guardadas en tu espacio de trabajo. items: type: object watchlist_timeline: type: array description: >- Eventos de transición de etapa para las empresas guardadas en tu espacio de trabajo, del más reciente al más antiguo. items: type: object x-legacy-root-keys: - countries - top_flows - picks_aggregate - watchlist_markets - watchlist_timeline example: metadata: filters: froms: - CN tos: - GB select_size: 250 flows_size: 50 transitioned_dates: - '2026-06-01' - '2026-06-29' data: countries: - country_code: US inbound_count: 18 outbound_count: 5 total_companies_with_signals: 23 exploring_count: 8 committing_count: 10 expanding_count: 4 scaling_count: 1 new_transitions_30d: 3 pairs_ahead_of_pace_30d: 1 freshest_transition_at: '2026-06-27T14:32:10.000Z' top_flows: - home_country_code: SG country_code: US company_count: 5 new_transitions_30d: 1 '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: expansion_froms: type: array items: type: string example: - US - GB description: >- Mercados de origen (ISO 3166-1 alfa-2). Desde dónde se expande una empresa: sus países de origen o sede. Úsalo solo para encontrar empresas que crecen a partir de estos mercados; combínalo con `tos` para un corredor origen→destino específico. expansion_tos: type: array items: type: string example: - US - GB description: >- Mercados de destino (ISO 3166-1 alfa-2). Hacia dónde se expande una empresa. Úsalo solo para encontrar todas las empresas que están entrando en estos mercados; combínalo con `froms` para un corredor origen→destino específico. expansion_exclude_froms: type: array items: type: string example: - US - GB description: Mercados de origen a excluir (ISO 3166-1 alfa-2). expansion_exclude_tos: type: array items: type: string example: - US - GB description: Mercados de destino a excluir (ISO 3166-1 alfa-2). expansion_stages: type: array items: type: string enum: - exploring - committing - expanding - scaling example: - committing - expanding description: >- Filtra por una o varias etapas de expansión. Consulta la base de conocimientos de Señales de Expansión para conocer las definiciones de las etapas. expansion_momentum: type: array items: type: string enum: - advancing - steady - pulling_back example: - advancing - steady description: >- Trayectoria por la que filtrar. Solo se aceptan `advancing`, `steady` y `pulling_back`; los valores de `directions` en [Referencia de expansión](/es/api-reference/endpoint/expansions/types) son solo de respuesta. expansion_freshness: type: array items: type: string enum: - fresh - cooling - stale - cold example: - fresh - cooling description: >- Filtra por antigüedad de la evidencia: fresh (~30 días), cooling (~30-60 días), stale (~60-90 días), cold (>90 días). expansion_scopes: type: array items: type: string enum: - entering_new_market - expanding_within_presence - established_only example: - entering_new_market description: Filtra por alcance de entrada al mercado. expansion_signal_type_slugs: 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: - EXEC - HIRE description: >- Filtra a tipos de señal específicos. Consulta el catálogo de tipos de señal en la base de conocimientos para las definiciones y niveles (`DNS` e `INFRA` son señales de nivel Premier). signal_strengths: type: array items: type: string enum: - low - medium - high - very_high example: - high description: >- Filtra por nivel de confianza de la evidencia: `low`, `medium` o `high`. Ten en cuenta que esto es distinto del `signal_strength_slug` por señal que devuelven los registros de señales (que va de `low` a `very_high`); cualquier otro valor aquí no coincide con nada. only_contraction: type: boolean example: false description: >- Cuando es true, devuelve solo las expansiones marcadas como contracción (empresas que están reduciendo su actividad). verticals: type: array items: type: integer description: >- 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: type: array items: type: integer description: >- 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: type: array items: type: integer description: >- 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"]`. technologies: type: array items: type: integer description: >- 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"]`. employees: type: array items: type: array items: type: string example: - - 1 - 10 - - 11 - 20 - - 10001 description: >- 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. revenues: type: array items: type: integer example: - 0 - 100000 description: Rango mínimo y máximo de ingresos de la empresa. founded_dates: type: array items: type: integer example: - 2018 - 2024 description: >- Rango de años de fundación de la empresa. El valor máximo de fundación es el año en curso. keywords: type: array items: type: string example: - ecommerce - ai - fintech description: >- Una lista de palabras clave para filtrar empresas por relevancia, especialidades o descripciones. expansion_companies: type: array items: type: string example: - stripe.com - https://www.linkedin.com/company/airbnb - b7d92a56-31f8-4c0b-ae43-19c8e5f24b70 description: >- Limita el alcance a empresas específicas mediante cualquier combinación de `domain_search_id`, dominio de la empresa o URL de perfil de red social de la empresa. Los dominios y las URL se resuelven a la empresa mejor clasificada. 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. job_exclude_locations: allOf: - $ref: '#/components/schemas/exclude_locations' description: >- Ubicaciones geográficas a excluir de los resultados de ofertas de empleo. posted_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. people_titles: type: array items: type: string example: - sales manager - marketing manager description: |- 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`. advertisement_target_locations: allOf: - $ref: '#/components/schemas/target_locations' description: Ubicaciones geográficas objetivo para los anuncios. advertisement_exclude_target_locations: allOf: - $ref: '#/components/schemas/exclude_target_locations' description: Ubicaciones geográficas a excluir de la segmentación de anuncios. advertisement_search_terms: type: array items: type: string example: - asus description: >- Palabras clave utilizadas para buscar dentro del contenido o los títulos de los anuncios. advertisement_start_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: Rango de fecha de inicio para filtrar anuncios. advertisement_end_dates: type: array items: type: string format: date example: - '2025-12-25' - '2025-12-25' description: Rango de fecha de fin para filtrar anuncios. 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. 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. window_days: type: integer example: 90 description: >- Opcional. Tamaño de la ventana móvil en días. Se usa cuando no se proporciona un rango explícito de `transitioned_dates`; si se omiten ambos, se usa una ventana predeterminada. industries: type: array items: type: string example: - software - financial services description: Filtra por nombre de industria (coincidencia de texto libre). exclude_industries: type: array items: type: string example: - tobacco description: Industrias a excluir (coincidencia de texto libre). expansion_is_include_metadata: type: boolean example: true description: >- Las respuestas con clave de API son reducidas de forma predeterminada. Establece en true para incluir el bloque completo de `metadata` (agregados, principales orígenes/destinos, principales industrias, línea temporal) y el detalle del modelo por empresa. exclude_locations: type: array items: type: string example: - CN - US - RU - CA description: >- 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. target_locations: type: array items: type: string example: - TW - AE - 'NO' description: >- Filtra anuncios para incluir aquellos dirigidos a ubicaciones específicas por código de país. Úsalo para encontrar anuncios que se están mostrando en países concretos. Se combina con `filter_conditions` usando el operador OR: el anuncio debe estar dirigido al menos a una de las ubicaciones especificadas. exclude_target_locations: type: array items: type: string example: - IS - GB - FR - IE - ES description: >- Filtra anuncios para excluir aquellos dirigidos a ubicaciones específicas por código de país. Úsalo para descartar anuncios que se están mostrando en países concretos. Cuando se especifica en `filter_conditions` con el operador 'or', el anuncio no debe estar dirigido a ninguna de las ubicaciones excluidas. 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 ````