> ## 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. # Detalle de expansión de empresa > 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. ## OpenAPI ````yaml es-openapi POST /expansions/companies/lookup 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/companies/lookup: post: tags: - Expansion summary: Detalle de expansión de empresa description: >- 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. operationId: expansions_company_lookup requestBody: required: true content: application/json: schema: type: object properties: country_code: $ref: '#/components/schemas/expansion_country_code' is_all_markets: $ref: '#/components/schemas/expansion_is_all_markets' signal_type: type: string enum: - AD - AUDIENCE - DNS - ENTITY - EVENT - EVENT_PLUS - EXEC - HIRE - INFRA - IP - NEWS - OFFICE - PARTNER - PRODUCT - REG - SCALE - TECH example: EXEC description: Filtra las señales devueltas a un solo tipo. query: type: string example: >- We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity. description: >- Descripción en lenguaje sencillo de lo que vendes, o el perfil de comprador con el que estás evaluando esta empresa. Se usa únicamente para fundamentar el `summary` de IA (consulta `is_explain_match`); a diferencia de la búsqueda de empresas, aquí NO se interpreta como filtros. is_explain_match: type: boolean example: true description: >- Cuando es true y se proporciona un `query`, `summary` devuelve un único resumen de IA sobre la actividad de expansión de esta empresa dentro del alcance actual (el mercado seleccionado, o todos los mercados extranjeros cuando `is_all_markets` es true), interpretado en función de tu `query` y fundamentado en las señales reales de la empresa con citas `[n]`. window_days: type: integer example: 90 default: 90 description: >- Opcional. Ventana móvil (en días) que acota el feed del `summary` de IA. Por defecto es **90** cuando no se proporciona ni este parámetro ni `transitioned_dates`. No afecta a la lista paginada de `signals` (historial completo). transitioned_dates: type: array items: type: string format: date example: - '2026-04-01' - '2026-06-29' description: >- Rango de fechas ISO `[from, to]` para la ventana de señales/transiciones. Tiene prioridad sobre `window_days` cuando se proporcionan ambos. domain: $ref: '#/components/schemas/domain' linkedin_url: $ref: '#/components/schemas/company_linkedin_url' domain_search_id: $ref: '#/components/schemas/domain_search_id' is_include_established: $ref: '#/components/schemas/expansion_is_include_established' page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' is_include_metadata: type: boolean description: >- Devuelve la carga útil de detalle completa. El tráfico con clave de API es ligero por defecto: el bloque `model`, las cifras de confianza (`stage.confidence` en Company Expansion Detail, `confidence_score` en `other_markets[]` y en `markers[]` de Rankings) y los campos `established_min` / `share_of_detected` / `has_known_office` se omiten todos a menos que este sea `true`. example: true summary_only: type: boolean description: >- Devuelve únicamente el bloque de resumen de etapa (`data`, `company`, `markets_summary`, `signal_weekly_totals`, `recent_signals`, `expansion_score`, `summary`) y omite la lista de señales y sus agregados. Mucho más económico para vistas de tipo hero/encabezado. example: true markets_summary_full: type: boolean description: >- Incluye el conjunto completo de mercados clasificados como `markets_summary`, junto con la lista limitada `other_markets`. example: true anyOf: - title: ID de búsqueda de dominio required: - domain_search_id - title: Dominio required: - domain - title: URL de LinkedIn required: - linkedin_url responses: '200': description: Detalle de empresa en el mercado. content: application/json: schema: type: object properties: metadata: type: object data: type: object description: Contenedor de resultados. properties: domain_search_id: type: string description: Identificador de empresa de Pubrio. country_code: type: string description: Mercado objetivo, ISO 3166-1 alfa-2. country_name: type: string description: Nombre del mercado objetivo. stage_rank: type: integer description: >- Rango numérico de la etapa; cuanto más alto, más avanzada. stage_name: type: string description: Nombre visible de la etapa. stage: type: object description: >- Detalle de la etapa: puntuación, alcance, dirección, actualidad y recuento de señales. local_people_count: type: integer description: Empleados ubicados en el mercado objetivo. local_people_coverage: type: boolean description: >- Indica si la cobertura de la plantilla es suficiente para confiar en el recuento. presence: type: object description: >- Presencia en el mercado: qué tan asentada está ya la empresa, independientemente de su etapa de expansión. properties: level: type: string enum: - established - emerging - none - no_data description: >- Qué tan asentada está la presencia de la empresa en este mercado: `established`, `emerging`, `none` o `no_data`. Esto es la presencia, no la etapa de expansión. local_people_count: type: integer description: Empleados ubicados en el mercado objetivo. matched_rule: type: string nullable: true description: >- Qué señal estableció el nivel, por ejemplo `office`, `headcount` o `share`. `null` cuando ninguna regla coincidió. read: type: object description: Estado de lectura de este registro. signals: type: array description: >- Las filas de señales paginadas detrás de este par empresa/mercado: la lista de evidencia. El tamaño de página y los totales provienen de `metadata.pagination`. items: type: object summary: type: object description: >- Resumen de una línea de la etapa para el par. Solo en la primera página. company: type: object description: >- Datos identificativos de la empresa: nombre, dominio, logotipo y URLs sociales. Solo en la primera página. signal_group_totals: type: array description: >- Recuento de señales por tipo, agrupado por día en tu zona horaria. Solo en la primera página. items: type: object signal_type_totals: type: array description: >- Totales históricos de señales por tipo de señal. Solo en la primera página. items: type: object signal_type_recent_totals: type: array description: >- Totales de señales por tipo durante las últimas 12 semanas. Solo en la primera página. items: type: object signal_weekly_totals: type: array description: >- Recuento semanal de señales para el mapa de calor, misma ventana que `signal_type_recent_totals`. Solo en la primera página. items: type: object evidence_breakdown: type: object description: >- Resumen de evidencia por tipo de fuente, calculado a partir de las señales devueltas (redactadas). Solo en la primera página. presence: type: object description: >- Presencia física y digital observada de la empresa en este mercado. Solo en la primera página. suppressions: type: array description: >- Señales excluidas del cálculo de la etapa, con el motivo de cada una. Solo en la primera página. items: type: object timeline: type: array description: >- Historial de transición de etapas para este par empresa/mercado. Solo en la primera página. items: type: object other_markets: type: array description: >- Los otros mercados activos de la empresa. Limitado en planes con restricciones; consulta `other_markets_locked_count`. Solo en la primera página. items: type: object other_markets_locked_count: type: integer description: >- Cuántos mercados adicionales no devolvió tu plan en `other_markets`. `0` cuando no se omitió ninguno. markets_summary: type: array description: >- Conjunto completo de mercados clasificados para esta empresa. Se devuelve únicamente cuando `markets_summary_full` es `true`, en la primera página. items: type: object example: metadata: filters: domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US country_code_auto_picked: false pagination: page: 1 per_page: 25 total_entries: 12 total_pages: 1 total_display_pages: 1 is_timeout: false data: domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US country_name: United States stage_rank: 3 stage_name: Expanding stage: slug: expanding expansion_score: 0.721 scope: entering_new_market direction: advancing freshness: fresh contraction_flag: null mode_change_flag: false signal_count: 5 distinct_type_count: 3 has_known_presence: false first_signal_at: '2026-05-30T09:00:00.000Z' latest_signal_at: '2026-06-20T14:00:00.000Z' last_transition_at: '2026-06-15T09:30:00.000Z' signals: - signal_type_slug: EXEC signal_subtype_slug: country_manager signal_strength_slug: high polarity: expansion event_date: '2026-06-20T14:00:00.000Z' source_type: linkedin display_label: Hired Regional VP for North America evidence_url: https://linkedin.com/company/example-corp source_published_at: '2026-06-20T14:00:00.000Z' lead_time_days: 0 presence: - presence_type: office presence_strength: high address: 123 Market St, San Francisco, CA known_since: '2026-03-15T00:00:00.000Z' timeline: - stage_slug: expanding transitioned_at: '2026-06-15T09:30:00.000Z' transition_kind: advance other_markets: - country_code: CA stage_slug: committing signal_count: 8 first_signal_at: '2026-04-10T00:00:00.000Z' latest_signal_at: '2026-06-22T16:45:00.000Z' last_transition_at: '2026-06-18T00:00:00.000Z' '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: expansion_country_code: type: string example: US description: >- Mercado objetivo como código de país ISO 3166-1 alfa-2 (cca2). Omítelo para seleccionar automáticamente el mercado más activo de la empresa; establece `is_all_markets` para una vista de todos los mercados. expansion_is_all_markets: type: boolean example: false description: >- Devuelve la huella de expansión completa de la empresa en TODOS los mercados en una sola llamada, en lugar de un único mercado. Cuando es `true`, se ignora `country_code`, el mercado de origen se excluye de los agregados de señales cuando puede identificarse, `data` se convierte en un resumen a nivel de empresa (etapa dominante, total de señales, rango de fechas, puntuación de expansión más alta), y `markets_summary` enumera todos los mercados. Por defecto es false. domain: type: string example: pubrio.com description: >- Un dominio de empresa utilizado para operaciones de búsqueda de empresas. Si recibimos una URL como `www.pubrio.com` o `https://docs.pubrio.com/`, el sistema la convertirá a `pubrio.com` para su procesamiento. company_linkedin_url: type: string example: https://www.linkedin.com/company/pubrio description: >- La URL completa del perfil de LinkedIn de la empresa. La URL debe empezar por `http` y contener `linkedin.com/company/` domain_search_id: type: string format: uuid description: Identificador único para la operación de búsqueda de empresas. expansion_is_include_established: type: boolean example: false description: >- Incluye la etapa `established` (operadores consolidados sin señales de expansión activas). Por defecto es false. page: type: integer example: 1 default: 1 description: >- 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](/es/api-reference/endpoint/profile/profile). Superarlo devuelve **HTTP 416**. per_page: type: integer example: 25 default: 25 maximum: 25 description: >- 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](/es/api-reference/endpoint/profile/profile). 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. 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 ````