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

> Busca en la base de datos de Pubrio empresas que coincidan con criterios específicos como industria, tamaño, ubicación y tecnologías.



## OpenAPI

````yaml es-openapi POST /companies/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:
  /companies/search:
    post:
      tags:
        - Search
      summary: Buscar empresas
      description: >-
        Busca en la base de datos de Pubrio empresas que coincidan con criterios
        específicos como industria, tamaño, ubicación y tecnologías.
      operationId: companies_search
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                company_name:
                  $ref: '#/components/schemas/company_name'
                companies:
                  $ref: '#/components/schemas/companies'
                domains:
                  $ref: '#/components/schemas/domains'
                linkedin_urls:
                  $ref: '#/components/schemas/company_linkedin_urls'
                company_filters:
                  $ref: '#/components/schemas/company_filters'
                locations:
                  $ref: '#/components/schemas/locations'
                exclude_locations:
                  $ref: '#/components/schemas/exclude_locations'
                places:
                  $ref: '#/components/schemas/places'
                exclude_places:
                  $ref: '#/components/schemas/exclude_places'
                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'
                verticals:
                  $ref: '#/components/schemas/verticals'
                vertical_categories:
                  $ref: '#/components/schemas/vertical_categories'
                vertical_sub_categories:
                  $ref: '#/components/schemas/vertical_sub_categories'
                categories:
                  $ref: '#/components/schemas/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'
                social_media:
                  $ref: '#/components/schemas/company_social_media'
                news_categories:
                  $ref: '#/components/schemas/news_categories'
                news_published_dates:
                  $ref: '#/components/schemas/published_dates'
                advertisement_search_terms:
                  $ref: '#/components/schemas/advertisement_search_terms'
                advertisement_target_locations:
                  $ref: '#/components/schemas/advertisement_target_locations'
                advertisement_exclude_target_locations:
                  $ref: '#/components/schemas/advertisement_exclude_target_locations'
                advertisement_start_dates:
                  $ref: '#/components/schemas/advertisement_start_dates'
                advertisement_end_dates:
                  $ref: '#/components/schemas/advertisement_end_dates'
                advertisement_active_dates:
                  $ref: '#/components/schemas/advertisement_active_dates'
                advertisement_status:
                  $ref: '#/components/schemas/advertisement_status'
                advertisement_headlines:
                  $ref: '#/components/schemas/advertisement_headlines'
                advertisement_platforms:
                  $ref: '#/components/schemas/advertisement_platforms'
                advertisement_publisher_platforms:
                  $ref: '#/components/schemas/advertisement_publisher_platforms'
                advertisement_exclude_publisher_platforms:
                  $ref: >-
                    #/components/schemas/advertisement_exclude_publisher_platforms
                advertisement_formats:
                  $ref: '#/components/schemas/advertisement_formats'
                advertisement_active_ads:
                  $ref: '#/components/schemas/advertisement_active_ads'
                advertisement_running_ads:
                  $ref: '#/components/schemas/advertisement_running_ads'
                advertisement_total_ads:
                  $ref: '#/components/schemas/advertisement_total_ads'
                advertisement_platform_count:
                  $ref: '#/components/schemas/advertisement_platform_count'
                advertisement_format_count:
                  $ref: '#/components/schemas/advertisement_format_count'
                advertisement_impressions_estimate:
                  $ref: '#/components/schemas/advertisement_impressions_estimate'
                advertisement_country_activity:
                  $ref: '#/components/schemas/advertisement_country_activity'
                filter_conditions:
                  $ref: '#/components/schemas/company_filter_conditions'
                is_enable_similarity_search:
                  $ref: '#/components/schemas/is_enable_similarity_search'
                similarity_score:
                  $ref: '#/components/schemas/similarity_score'
                exclude_fields:
                  $ref: '#/components/schemas/exclude_fields'
                is_parameter_metadata_available:
                  $ref: '#/components/schemas/is_parameter_metadata_available'
                is_profile_metadata_available:
                  $ref: '#/components/schemas/is_profile_metadata_available'
                per_page:
                  $ref: '#/components/schemas/per_page'
                page:
                  $ref: '#/components/schemas/page'
      responses:
        '200':
          description: >-
            Respuesta exitosa que contiene los detalles de la búsqueda de
            empresas.
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    description: >-
                      Contexto de la solicitud: `recent_search_log_identifier`,
                      `parameters` y `filters` reflejados, un bloque de crédito
                      `profile` opcional, e `ignored_fields` (claves del cuerpo
                      que el endpoint descartó).
                  data:
                    $ref: '#/components/schemas/data'
              example:
                data:
                  pagination:
                    page: 1
                    per_page: 25
                    total_entries: 45234700
                    total_pages: 1809388
                  companies:
                    - logo_url: >-
                        https://buckets.pubrio.com/company-logo/MjI0NDc1OTMxaWxqOXNzbmoxdHdpdHRlci5jb20=.jpg
                      company_name: Twitter
                      emails:
                        - ...
                      phones:
                        - ...
                      contacts:
                        - ...
                      founded_year: 2006
                      specialties:
                        - Software Development
                      industry: Software Development
                      domain: twitter.com
                      domain_search_id: 61a73da7-2efc-41a5-a252-a8a8df29925a
                      domain_id: 224475931
                      linkedin_company_id: 44005587
                      linkedin_name: twitter
                      is_company_url_active: true
                      domain_ids:
                        - 224475931
                        - 1758889566
                        - 368242865
                      company_keywords:
                        - realtime information
                        - social commerce
                        - online shopping
                        - classifieds
                        - craigslist killers
                        - e-commerce
                        - killers
                        - consumer internet
                        - internet
                        - information technology
                        - edp services
                        - technology
                        - software development
                        - microblogging
                        - social networking
                        - public conversation
                        - user engagement
                        - content sharing
                        - advertising solutions
                        - monetization
                        - community building
                        - digital wallet
                        - ai integration
                        - user safety
                      company_size: 1500
                      youtube_url: null
                      crunchbase_url: null
                      linkedin_url: http://www.linkedin.com/company/twitter
                      instagram_url: null
                      facebook_url: http://facebook.com/twitterinc
                      twitter_url: https://twitter.com/x
                      github_url: null
                      x_url: null
                      location: United States
                      company_ranking: null
                      company_url: http://twitter.com
                      saved_lists: null
                      company_size_printed: 1,500
                    - ...
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  schemas:
    company_name:
      type: string
      example: pubrio
      description: >-
        Filtra los resultados de búsqueda para incluir un nombre de empresa
        específico.

         Si el valor que introduces para este parámetro no coincide con el nombre de una empresa, esta no aparecerá en los resultados de búsqueda, aunque coincida con otros parámetros. Se aceptan coincidencias parciales.
    companies:
      type: array
      items:
        type: string
        format: uuid
      description: >-
        Una lista de identificadores únicos (domain_search_id) utilizada para
        operaciones de búsqueda de empresas y personas.
    domains:
      type: array
      items:
        type: string
      example:
        - pubrio.com
      description: >-
        Lista de dominios de empresa utilizada para operaciones de búsqueda de
        empresas y personas. 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_urls:
      type: array
      items:
        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/`
    company_filters:
      type: object
      description: >-
        Objeto contenedor para filtros a nivel de empresa. Agrupación
        recomendada que separa visualmente qué claves filtran a la *persona*
        (nivel superior) de cuáles filtran a la *empresa*. Acepta las mismas
        claves que los filtros de empresa de nivel superior (por ejemplo,
        `technologies`, `verticals`, `vertical_categories`,
        `vertical_sub_categories`, `categories`, `keywords`, `founded_dates`,
        `employees`, `revenues`, `company_locations`,
        `company_exclude_locations`, `company_places`, `company_exclude_places`,
        `companies`, `domains`, `company_linkedin_urls`,
        `is_enable_similarity_search`, `similarity_score`, además de
        `filter_conditions`). El motor aplana este objeto al nivel superior
        antes de procesarlo — las claves de nivel superior prevalecen en caso de
        conflicto. Misma estructura que usa `company_filters` en Monitor.
        Consulta la guía para desarrolladores sobre filtros para ver ejemplos.
      example:
        company_locations:
          - US
        technologies:
          - 37
          - 152
        founded_dates:
          - 2015
          - 2023
        filter_conditions:
          - key: technologies
            operator: and
    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.
    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.
    places:
      type: array
      items:
        type: string
      example:
        - Tokyo
      description: >-
        Nombres de lugares (ciudad, región) utilizados para filtrar resultados.
        Acepta nombres de lugares localizados o en inglés.
    exclude_places:
      type: array
      items:
        type: string
      example:
        - Tokyo
      description: >-
        Nombres de lugares (ciudad, región) a excluir de los resultados. Acepta
        nombres de lugares localizados o en inglés.
    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`.
    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"]`.
    categories:
      type: array
      items:
        type: integer
      description: >-
        Una lista de `category_id` utilizada para buscar categorías específicas
        de tecnología usadas por las empresas. Para encontrar el ID, llama al
        endpoint `category` en la pestaña Filters.


        Este filtro admite `is_enable_similarity_search`; una vez habilitado,
        puedes introducir texto libre, por ejemplo `["CDN"]`.
    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.
    company_social_media:
      type: array
      items:
        type: string
        enum:
          - linkedin
          - facebook
          - instagram
          - tiktok
          - twitter
          - x
          - github
          - wantedly
          - rocketpunch
      example:
        - tiktok
      description: >-
        Empresas con perfil en alguna de estas redes: `linkedin`, `facebook`,
        `instagram`, `tiktok`, `twitter`, `x`, `github`, `wantedly`,
        `rocketpunch`. Conviértelo en AND con `filter_conditions`.
    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.
    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_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_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.
    advertisement_active_dates:
      type: array
      items:
        type: string
        format: date
      example:
        - '2026-01-01'
        - '2026-01-31'
      description: >-
        Encuentra anuncios que estuvieron activos en algún momento dentro de
        este rango de fechas (basado en solapamiento: incluye anuncios que
        empezaron antes del rango y siguen activos, no solo los que empezaron
        dentro de él).
    advertisement_status:
      type: array
      items:
        type: string
        enum:
          - currently_running
          - active_last_30_min
      example:
        - currently_running
      description: >-
        `currently_running`: empresas con publicidad registrada.
        `active_last_30_min`: empresas cuya publicidad cambió en los últimos 30
        minutos.
    advertisement_headlines:
      type: array
      items:
        type: string
      example:
        - limited time offer
      description: Palabras clave a buscar dentro del texto del titular del anuncio.
    advertisement_platforms:
      type: array
      items:
        type: string
        enum:
          - linkedin
          - facebook
          - google
          - tiktok
          - apple
      example:
        - linkedin
        - facebook
      description: >-
        Filtra según de qué biblioteca de anuncios proviene el anuncio. En
        minúsculas, sin distinción entre mayúsculas y minúsculas. Se acepta
        `meta` como alias de `facebook`.
    advertisement_publisher_platforms:
      type: array
      items:
        type: string
        enum:
          - facebook
          - instagram
          - messenger
          - threads
          - audience_network
      example:
        - facebook
        - instagram
      description: >-
        Filtra anuncios de Facebook/Meta según la superficie de plataforma en la
        que se entregaron. En minúsculas y sin distinción entre mayúsculas y
        minúsculas. Solo se aplica a la fuente `facebook` (las demás fuentes son
        de plataforma única).
    advertisement_exclude_publisher_platforms:
      type: array
      items:
        type: string
        enum:
          - facebook
          - instagram
          - messenger
          - threads
          - audience_network
      example:
        - audience_network
      description: >-
        Excluye anuncios de Facebook/Meta entregados en estas superficies de
        plataforma.
    advertisement_formats:
      type: array
      items:
        type: string
        enum:
          - image
          - video
          - text
          - carousel
          - dynamic_product
          - document
          - message
          - event
          - article
          - spotlight
          - follow
          - job
          - engagement
      example:
        - image
        - video
      description: >-
        Encuentra empresas con al menos un anuncio en cualquiera de estos
        formatos creativos.
    advertisement_active_ads:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Recuento mínimo y máximo de anuncios actualmente activos de la empresa,
        en todos los países. Usa `null` para un límite abierto, por ejemplo `[1,
        null]` para "al menos un anuncio activo".
    advertisement_running_ads:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Recuento mínimo y máximo de anuncios de la empresa que siguen activos
        (sin fecha de fin, o con fecha de fin futura). Actualmente solo se
        completa para anuncios de LinkedIn.
    advertisement_total_ads:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 10
        - null
      description: >-
        Recuento mínimo y máximo del total de anuncios registrados de la
        empresa, en todos los países.
    advertisement_platform_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 2
        - null
      description: >-
        Número mínimo y máximo de plataformas publicitarias distintas (linkedin,
        facebook, google, tiktok, apple) en las que la empresa está anunciando
        activamente.
    advertisement_format_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 2
        - null
      description: >-
        Número mínimo y máximo de formatos creativos de anuncio distintos que la
        empresa está utilizando activamente.
    advertisement_impressions_estimate:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1000
        - null
      description: >-
        Impresiones estimadas de anuncios, mínimas y máximas, sumadas en todos
        los países. Solo se cuentan los anuncios con un rango de impresiones
        reportado.
    advertisement_country_activity:
      type: object
      properties:
        country:
          type: string
          example: US
          description: >-
            Código de país ISO 3166-1 alfa-2 al que se limita este filtro.
            Obligatorio.
        rank:
          type: array
          items:
            type: integer
            nullable: true
          minItems: 2
          maxItems: 2
          example:
            - null
            - 500
          description: >-
            Posición dentro de ese país según el volumen publicitario. 1 es el
            mayor anunciante, y el número aumenta a medida que disminuye el
            volumen publicitario. Usa `[null, 500]` para encontrar a los 500
            mayores anunciantes de ese país; usa `[500, null]` para encontrar a
            todos los que ocupan la posición 500 o inferior.
        percentile:
          type: array
          items:
            type: number
            nullable: true
          minItems: 2
          maxItems: 2
          example:
            - 90
            - null
          description: >-
            Percentil dentro de ese país según el volumen publicitario, de 0 a
            100. Un valor más alto indica un mayor anunciante. Usa `[90, null]`
            para el 10% superior de anunciantes de ese país.
        volume_score:
          type: array
          items:
            type: number
            nullable: true
          minItems: 2
          maxItems: 2
          example:
            - 0.5
            - null
          description: >-
            La puntuación subyacente de volumen publicitario, de 0 a 1, a partir
            de la cual se calculan tanto `rank` como `percentile`.
        active_ads:
          type: array
          items:
            type: integer
            nullable: true
          minItems: 2
          maxItems: 2
          example:
            - 1
            - null
          description: Anuncios activos mínimos y máximos, limitados a este país.
        running_ads:
          type: array
          items:
            type: integer
            nullable: true
          minItems: 2
          maxItems: 2
          example:
            - 1
            - null
          description: >-
            Anuncios en curso mínimos y máximos, limitados a este país.
            Actualmente solo se completa para anuncios de LinkedIn.
        total_ads:
          type: array
          items:
            type: integer
            nullable: true
          minItems: 2
          maxItems: 2
          example:
            - 10
            - null
          description: Total de anuncios mínimo y máximo, limitado a este país.
        impressions:
          type: array
          items:
            type: integer
            nullable: true
          minItems: 2
          maxItems: 2
          example:
            - 1000
            - null
          description: Impresiones estimadas mínimas y máximas, limitadas a este país.
      required:
        - country
      example:
        country: US
        rank:
          - null
          - 500
      description: >-
        Actividad publicitaria para un país específico. `country` es
        obligatorio, y debe establecerse al menos otro campo (un país por sí
        solo no coincide con nada). Para un total de todos los países, usa en su
        lugar los filtros de nivel superior `advertisement_active_ads` /
        `advertisement_total_ads` / `advertisement_impressions_estimate`.
    company_filter_conditions:
      type: array
      items:
        type: object
        properties:
          key:
            type: string
            enum:
              - keywords
              - verticals
              - vertical_categories
              - vertical_sub_categories
              - technologies
              - categories
              - advertisement_target_locations
              - advertisement_exclude_target_locations
              - advertisement_search_terms
              - places
              - exclude_places
              - job_exclude_locations
            example: keywords
            description: >-
              La clave de filtro que especifica a qué propiedad aplicar el
              operador.
          operator:
            type: string
            enum:
              - or
              - and
            example: or
            description: >-
              El operador lógico a aplicar. Usa 'or' para coincidir con
              cualquiera de los valores especificados, o 'and' para requerir
              todos los valores especificados.
      description: >-
        Opciones de filtrado avanzado para búsquedas de empresas. Especifica
        condiciones combinando claves y operadores lógicos para refinar los
        resultados de búsqueda.
    is_enable_similarity_search:
      type: boolean
      description: >-
        Cuando está habilitado, los filtros indicados anteriormente que admiten
        búsquedas por similitud pueden completarse con texto libre en lugar de
        IDs específicos.
    similarity_score:
      type: number
      format: float
      example: 0.7
      description: >-
        Se usa junto con `is_enable_similarity_search`. Este número se utiliza
        para analizar si un slug específico (por ejemplo, vertical de industria,
        tecnología) es similar a la entrada del usuario, y cuanto mayor es el
        número, más estricto es.
    exclude_fields:
      type: array
      items:
        type: string
      example:
        - emails
        - phones
        - contacts
      description: Lista de campos a excluir de la carga útil de la respuesta.
    is_parameter_metadata_available:
      type: boolean
      description: Indica si hay metadatos de parámetros disponibles para la solicitud.
    is_profile_metadata_available:
      type: boolean
      description: Indica si hay metadatos de perfil disponibles para la solicitud.
    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.
    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**.
    data:
      type: object
      nullable: true
      description: La información de la respuesta depende del endpoint específico.
    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

````