> ## 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.

# Búsqueda de expansión

> 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.



## OpenAPI

````yaml es-openapi POST /expansions/search
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/search:
    post:
      tags:
        - Expansion
      summary: Expansion Search
      description: >-
        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.
      operationId: expansions_search
      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 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'
                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.
                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'
                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-04-01'
                    - '2026-06-29'
                  description: >-
                    Rango de fechas ISO para la ventana de la línea temporal. El
                    valor predeterminado son los últimos 90 días. Una `query` en
                    lenguaje natural también puede definir esto a partir de
                    frases de calendario ("this year", "last year", "Q2 2026").
                window_days:
                  $ref: '#/components/schemas/window_days'
                query:
                  type: string
                  example: fintech companies expanding into the UK
                  description: >-
                    Consulta en lenguaje natural que Pubrio interpreta como
                    filtros de expansión y de empresa.
                is_explain_match:
                  type: boolean
                  example: true
                  description: >-
                    Incluye explicaciones generadas por IA sobre por qué cada
                    empresa coincide con la búsqueda, basadas en las señales
                    reales de la empresa. Funciona mejor combinado con una
                    consulta en lenguaje natural. Tanto el número de señales
                    citadas como el tamaño del lote escalan con `per_page`; las
                    fuentes de alto volumen (ofertas de empleo, campañas
                    publicitarias) se resumen como un recuento acotado a la
                    ventana de tiempo (por ejemplo, "12 job postings") en lugar
                    de enumerarse individualmente.
                sort_by:
                  $ref: '#/components/schemas/expansion_sort_by'
                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`.
                page:
                  $ref: '#/components/schemas/page'
                per_page:
                  $ref: '#/components/schemas/per_page'
                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
              anyOf:
                - title: Mercados de origen
                  required:
                    - froms
                - title: Mercados de destino
                  required:
                    - tos
                - title: Consulta en lenguaje natural
                  required:
                    - query
                - title: Empresas
                  required:
                    - companies
      responses:
        '200':
          description: >-
            Lista paginada de empresas que se están expandiendo en el/los
            mercado(s). `filters` refleja los criterios aplicados (o
            interpretados a partir del lenguaje natural); cada empresa incluye
            un `match_summary` cuando `is_explain_match` es true.
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    description: >-
                      Metadatos de la búsqueda: los filtros realmente aplicados,
                      además del resumen del mercado (agregado, alcance
                      geográfico, principales orígenes/destinos/industrias,
                      línea temporal). Las respuestas con clave de API incluyen
                      el resumen solo cuando `is_include_metadata` es true.
                    properties:
                      filters:
                        type: object
                        description: >-
                          Filtros realmente aplicados (refleja una consulta en
                          lenguaje natural interpretada cuando se usó `query`).
                      relaxed_filters:
                        type: array
                        description: >-
                          Filtros flexibles descartados automáticamente cuando
                          una consulta en lenguaje natural no coincidió con
                          nada; null en caso contrario.
                        items:
                          type: string
                      nl_note:
                        type: string
                        description: >-
                          Nota legible para humanos cuando una consulta en
                          lenguaje natural no expresó ningún criterio
                          reconocible; en ese caso, la lista está vacía.
                      nl_note_code:
                        type: string
                        description: >-
                          Código legible por máquina para `nl_note` (por
                          ejemplo, expansion.search.no_criteria).
                      aggregate:
                        type: object
                        description: >-
                          Resumen a nivel de mercado. Presente cuando se
                          solicitan los metadatos.
                      country_code:
                        type: string
                      country_codes:
                        type: array
                        items:
                          type: string
                      direction:
                        type: string
                      is_global:
                        type: boolean
                      is_multi:
                        type: boolean
                      transitioned_dates:
                        type: array
                        items:
                          type: string
                      top_origins:
                        type: array
                        items:
                          type: object
                      top_destinations:
                        type: array
                        items:
                          type: object
                      top_industries:
                        type: array
                        items:
                          type: object
                      timeline:
                        type: array
                        items:
                          type: object
                  data:
                    type: object
                    description: >-
                      Contenedor de resultados (envoltorio estándar de
                      búsqueda): la lista de empresas más la paginación.
                    properties:
                      pagination:
                        type: object
                        description: >-
                          Página, elementos por página, total de entradas y
                          total de páginas.
                      companies:
                        type: array
                        description: >-
                          La lista de empresas. Cada elemento incluye un `stage`
                          anidado; `match_summary` se incluye cuando
                          `is_explain_match` es true. Las respuestas con clave
                          de API también incluyen `presence` (`level`:
                          established | emerging | none | no_data;
                          `matched_rule`: office | headcount | share) y un
                          objeto `read` cuyo `code` es scaling | deepening |
                          active | establishing (null cuando no hay presencia
                          local que reportar).
                        items:
                          type: object
              example:
                metadata:
                  filters:
                    tos:
                      - GB
                    verticals:
                      - Financial Services
                data:
                  pagination:
                    page: 1
                    per_page: 25
                    total_entries: 87
                    total_pages: 4
                    total_display_pages: 4
                    is_timeout: false
                  companies:
                    - expansion_id: '6845525'
                      domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c
                      country_code: GB
                      target_country_code: GB
                      domain: example.com
                      company_name: Example Corp
                      home_country_code: CN
                      industry: Consumer Electronics
                      founded_year: 2015
                      employees_count: 320
                      stage:
                        slug: expanding
                        expansion_score: 0.72
                        scope: entering_new_market
                        direction: advancing
                        freshness: fresh
                        signal_count: 27
                        distinct_type_count: 3
                        last_transition_at: '2026-06-27T14:32:10.000Z'
                      presence:
                        level: established
                        local_people_count: 12
                        matched_rule: headcount
                        has_known_office: true
                        established_min: 10
                        share_of_detected: 0.54
                      read:
                        code: establishing
        '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).
    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).
    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.
    expansion_sort_by:
      type: string
      enum:
        - recent
        - expansion_score
        - signal_count
        - company_ranking
      example: expansion_score
      description: >-
        Orden de los resultados. Omítelo para el orden de relevancia
        predeterminado: primero los pares corroborados (2 o más tipos de señal
        distintos), luego los pares con evidencia repetida (3 o más señales), y
        después el resto — dentro de cada nivel, primero los transicionados más
        recientemente. `recent` — orden puramente cronológico (los
        transicionados más recientemente primero). `expansion_score` — primero
        la puntuación de expansión más alta. `signal_count` — primero el par con
        más señales. `company_ranking` — clasificación general de empresas de
        Pubrio (un valor más bajo indica mayor relevancia), ascendente.
    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.
    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.
    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

````