> ## 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. # Clasificación de expansión > Lista clasificada y ligera de pares empresa/mercado por puntuación de expansión, apta para representarse en mapas o mapas de calor. ## OpenAPI ````yaml es-openapi POST /expansions/companies/rankings 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/rankings: post: tags: - Expansion summary: Clasificación de expansión description: >- Lista clasificada y ligera de pares empresa/mercado por puntuación de expansión, apta para representarse en mapas o mapas de calor. operationId: expansions_company_rankings 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 entre mayúsculas y 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 en [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_types: allOf: - $ref: '#/components/schemas/expansion_signal_type_slugs' description: >- Los valores distinguen entre mayúsculas y 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 en [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 entre mayúsculas y 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 en [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 dentro de la ventana: "muy activa / con una presencia considerable". only_contraction: $ref: '#/components/schemas/only_contraction' domain_search_ids: allOf: - $ref: '#/components/schemas/expansion_domain_search_ids' description: Empresas a las que restringir, por `domain_search_id`. 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' is_include_established: $ref: '#/components/schemas/expansion_is_include_established' select_size: $ref: '#/components/schemas/expansion_select_size' is_include_metadata: type: boolean description: >- Devuelve la carga útil completa con todos los detalles. El tráfico con clave de API es ligero de forma predeterminada: 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 esto sea `true`. example: true is_enable_similarity_search: type: boolean description: >- Activa la coincidencia de texto libre para `verticals`, `vertical_categories`, `vertical_sub_categories` y `technologies`; esos filtros se descartan a menos que esto sea `true`. example: true responses: '200': description: Marcadores clasificados de empresa/mercado. content: application/json: schema: type: object properties: metadata: type: object data: type: object description: Contenedor de resultados. properties: markers: type: array description: >- Una fila por cada par empresa/mercado, clasificada por puntuación de expansión. items: type: object properties: domain_search_id: type: string description: Identificador de empresa de Pubrio. country_code: type: string description: Mercado de destino, ISO 3166-1 alfa-2. stage_slug: type: string description: Etapa de expansión actual. expansion_score: type: integer description: >- Puntuación de expansión para este par empresa/mercado. freshness: type: string description: Qué tan recientes son las señales subyacentes. direction: type: string description: Trayectoria de la etapa. example: metadata: filters: froms: - CN tos: - GB select_size: 250 count: 1 data: markers: - domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US stage_slug: expanding expansion_score: 0.721 freshness: fresh direction: advancing '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_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). expansion_domain_search_ids: type: array items: type: string example: - 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c description: Identificadores de empresa (UUID de domain_search_id) a incluir. 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. 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. expansion_select_size: type: integer example: 50 description: Número máximo de registros a devolver. Limitado por tu plan. 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 ````