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

# Busca de Empresas

> Busca no banco de dados da Pubrio por empresas que correspondam a critérios especificados, como setor, tamanho, localização e tecnologias.



## OpenAPI

````yaml pt-openapi POST /companies/search
openapi: 3.0.0
info:
  description: >-
    A API Pubrio entrega inteligência de expansão de mercado — sinais em tempo
    real que indicam quando uma empresa entra em um novo mercado — além dos
    dados de empresas e pessoas por trás desses sinais. Pesquise, consulte e
    enriqueça contas e contatos, e assine sinais de movimentação tipados e
    datados em mais de 200 mercados.
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/pt-BR/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/pt-BR/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: Informações do perfil da equipe e estatísticas de uso
  - name: Enrichment
    description: Enriqueça registros de pessoas e empresas com dados B2B detalhados
  - name: Lookalike
    description: Encontre empresas semelhantes a uma empresa específica
  - name: Search
    description: Pesquise pessoas, empresas, vagas, notícias e anúncios com filtros
  - name: Lookup
    description: >-
      Consulte informações detalhadas de pessoas, empresas, vagas, notícias,
      anúncios e tecnologias específicas
  - name: LinkedIn
    description: >-
      Consulte dados de pessoas e empresas por meio de URLs de perfil do
      LinkedIn
  - name: Redeem
    description: >-
      Resgate créditos para desbloquear detalhes de contato de pessoas
      (individual e em lote)
  - name: Channels
    description: >-
      Gerencie templates de canais de outreach (criar, atualizar, excluir,
      listar)
  - name: Monitor
    description: >-
      Crie e gerencie monitores de dados com webhooks, estatísticas e
      processamento
  - name: Filters
    description: >-
      Obtenha os valores de filtro disponíveis para os parâmetros de busca
      (tecnologias, localizações, verticais etc.)
  - name: API Keys
    description: >-
      Liste e inspecione logs de requisições da API e análises de uso das chaves
      de API
  - name: Insights
    description: Insights agregados de sinais para empresas (vagas, notícias, anúncios).
  - name: Export
    description: Exportações de dados em massa (consomem créditos).
  - name: Expansion
    description: >-
      Inteligência de expansão de mercado de empresas: sinais, estágios,
      mercados e exportações.
externalDocs:
  description: >-
    A API Pubrio é usada para pesquisar, pré-visualizar e enriquecer contatos e
    contas. O banco de dados Pubrio oferece dados extensos de contatos B2B e
    inteligência de vendas.
  url: https://docs.pubrio.com
paths:
  /companies/search:
    post:
      tags:
        - Search
      summary: Buscar empresas
      description: >-
        Busca no banco de dados da Pubrio por empresas que correspondam a
        critérios especificados, como setor, tamanho, localização e tecnologias.
      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: Resposta bem-sucedida contendo os detalhes da busca de empresas.
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                    description: >-
                      Contexto da solicitação: `recent_search_log_identifier`,
                      os `parameters` e `filters` informados são retornados, um
                      bloco opcional de créditos `profile`, e `ignored_fields`
                      (chaves do corpo da requisição que o endpoint descartou).
                  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 os resultados da busca para incluir um nome de empresa
        específico. 
         
         Se o valor inserido neste parâmetro não corresponder ao nome de uma empresa, ela não aparecerá nos resultados da busca, mesmo que corresponda a outros parâmetros. Correspondências parciais são aceitas.
    companies:
      type: array
      items:
        type: string
        format: uuid
      description: >-
        Uma lista de identificadores únicos (domain_search_id) usada para
        operações de busca de empresas e pessoas.
    domains:
      type: array
      items:
        type: string
      example:
        - pubrio.com
      description: >-
        Lista de domínios de empresas usada para operações de busca de empresas
        e pessoas. Se recebermos uma URL como `www.pubrio.com` ou
        `https://docs.pubrio.com/`, o sistema a converterá para `pubrio.com`
        para processamento.
    company_linkedin_urls:
      type: array
      items:
        type: string
      example:
        - https://www.linkedin.com/company/pubrio
      description: >-
        A URL completa do perfil da empresa no LinkedIn. A URL começa com `http`
        e contém `linkedin.com/company/`
    company_filters:
      type: object
      description: >-
        Objeto wrapper para filtros em nível de empresa. Agrupamento recomendado
        que separa visualmente quais chaves filtram a *pessoa* (nível superior)
        das que filtram a *empresa*. Aceita as mesmas chaves dos filtros de
        empresa de nível superior (por exemplo, `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`, além de `filter_conditions`). O mecanismo achata
        esse objeto para o nível superior antes de processar — as chaves de
        nível superior prevalecem em caso de conflito. Mesma estrutura usada
        pelo `company_filters` do Monitor. Consulte o guia do desenvolvedor
        Visão Geral dos Filtros para ver exemplos.
      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: >-
        O padrão ISO 3166-1 alpha-2 (cca2) é usado para filtrar localizações.
        Consulte os endpoints `location` na aba Filters para mais informações.
    exclude_locations:
      type: array
      items:
        type: string
      example:
        - CN
        - US
        - RU
        - CA
      description: >-
        O padrão ISO 3166-1 alpha-2 (cca2) é usado para excluir localizações que
        não precisam ser retornadas. Consulte os endpoints `location` na aba
        Filters para mais informações.
    places:
      type: array
      items:
        type: string
      example:
        - Tokyo
      description: >-
        Nomes de lugares (cidade, região) usados para filtrar resultados. Aceita
        nomes de lugares localizados ou em inglês.
    exclude_places:
      type: array
      items:
        type: string
      example:
        - Tokyo
      description: >-
        Nomes de lugares (cidade, região) a serem excluídos dos resultados.
        Aceita nomes de lugares localizados ou em inglês.
    job_exclude_locations:
      allOf:
        - $ref: '#/components/schemas/exclude_locations'
      description: >-
        Localizações geográficas a serem excluídas dos resultados de vagas de
        emprego.
    posted_dates:
      type: array
      items:
        type: string
      example:
        - '2025-01-01'
        - '2025-01-10'
      description: >-
        Intervalo de datas de publicação. O valor máximo é o dia atual. Os
        limites do dia seguem o fuso horário do seu workspace.
    people_titles:
      type: array
      items:
        type: string
      example:
        - sales manager
        - marketing manager
      description: |-
        Cargos associados aos indivíduos que você deseja localizar. 

         Os resultados também incluirão cargos que contenham terminologia semelhante, mesmo que não correspondam exatamente. Por exemplo, buscar por `software engineer` pode retornar resultados de indivíduos com o cargo `senior software engineer`.
    verticals:
      type: array
      items:
        type: integer
      description: >-
        Uma lista de `vertical_id` usada para buscar empresas em um vertical ou
        setor específico. Para encontrar o ID, chame o endpoint `vertical` na
        aba Filters.


        Este filtro suporta `is_enable_similarity_search`; uma vez habilitado,
        você pode inserir qualquer texto livre, por exemplo `["AI"]`.
    vertical_categories:
      type: array
      items:
        type: integer
      description: >-
        Uma lista de `vertical_category_id` usada para buscar empresas em uma
        categoria vertical específica. Para encontrar o ID, chame o endpoint
        `vertical category` na aba Filters.


        Este filtro suporta `is_enable_similarity_search`; uma vez habilitado,
        você pode inserir qualquer texto livre, por exemplo `["Information
        Technology"]`.
    vertical_sub_categories:
      type: array
      items:
        type: integer
      description: >-
        Uma lista de `vertical_sub_category_id` usada para buscar empresas em
        uma subcategoria vertical específica. Para encontrar o ID, chame o
        endpoint `vertical sub category` na aba Filters.


        Este filtro suporta `is_enable_similarity_search`; uma vez habilitado,
        você pode inserir qualquer texto livre, por exemplo `["Software"]`.
    categories:
      type: array
      items:
        type: integer
      description: >-
        Uma lista de `category_id` usada para buscar categorias específicas de
        tecnologia utilizadas pelas empresas. Para encontrar o ID, chame o
        endpoint `category` na aba Filters.


        Este filtro suporta `is_enable_similarity_search`; uma vez habilitado,
        você pode inserir qualquer texto livre, por exemplo `["CDN"]`.
    technologies:
      type: array
      items:
        type: integer
      description: >-
        Uma lista de `tag_id` usada para buscar tecnologias específicas
        utilizadas pelas empresas. Para encontrar o ID, chame o endpoint
        `technology` na aba Filters.


        Este filtro suporta `is_enable_similarity_search`; uma vez habilitado,
        você pode inserir qualquer texto livre, por exemplo `["Shopify"]`.
    employees:
      type: array
      items:
        type: array
        items:
          type: string
      example:
        - - 1
          - 10
        - - 11
          - 20
        - - 10001
      description: >-
        O intervalo numérico de funcionários que trabalham na empresa. Isso
        permite encontrar empresas com base no número de funcionários. Você pode
        adicionar múltiplos intervalos para expandir os resultados da busca. 

         Consulte os endpoints de `company size` na aba Filters para mais informações.
    revenues:
      type: array
      items:
        type: integer
      example:
        - 0
        - 100000
      description: Intervalo mínimo e máximo da receita da empresa.
    founded_dates:
      type: array
      items:
        type: integer
      example:
        - 2018
        - 2024
      description: >-
        Intervalo de anos de fundação da empresa. O valor máximo de fundação é o
        ano atual.
    keywords:
      type: array
      items:
        type: string
      example:
        - ecommerce
        - ai
        - fintech
      description: >-
        Uma lista de palavras-chave para filtrar empresas por relevância,
        especialidades ou descrições.
    company_social_media:
      type: array
      items:
        type: string
        enum:
          - linkedin
          - facebook
          - instagram
          - tiktok
          - twitter
          - x
          - github
          - wantedly
          - rocketpunch
      example:
        - tiktok
      description: >-
        Empresas com perfil em qualquer um destes: `linkedin`, `facebook`,
        `instagram`, `tiktok`, `twitter`, `x`, `github`, `wantedly`,
        `rocketpunch`. Promova para E (AND) com `filter_conditions`.
    news_categories:
      type: array
      items:
        type: string
      example:
        - launches
      description: >-
        Lista de `category slugs` para buscar categorias de notícias
        específicas. Para encontrar um slug, chame o endpoint `news categories`
        na aba Filters.
    published_dates:
      type: array
      items:
        type: string
      example:
        - '2025-01-01'
        - '2025-01-10'
      description: >-
        Intervalo de datas de publicação. O valor máximo é o dia atual. Os
        limites do dia seguem o fuso horário do seu workspace.
    advertisement_search_terms:
      type: array
      items:
        type: string
      example:
        - asus
      description: >-
        Palavras-chave usadas para buscar no conteúdo ou nos títulos dos
        anúncios.
    advertisement_target_locations:
      allOf:
        - $ref: '#/components/schemas/target_locations'
      description: Localizações geográficas alvo para anúncios.
    advertisement_exclude_target_locations:
      allOf:
        - $ref: '#/components/schemas/exclude_target_locations'
      description: Localizações geográficas a serem excluídas da segmentação de anúncios.
    advertisement_start_dates:
      type: array
      items:
        type: string
        format: date
      example:
        - '2025-12-25'
        - '2025-12-25'
      description: Intervalo de data de início para filtragem de anúncios.
    advertisement_end_dates:
      type: array
      items:
        type: string
        format: date
      example:
        - '2025-12-25'
        - '2025-12-25'
      description: Intervalo de data de término para filtragem de anúncios.
    advertisement_active_dates:
      type: array
      items:
        type: string
        format: date
      example:
        - '2026-01-01'
        - '2026-01-31'
      description: >-
        Encontra anúncios que estavam em veiculação em algum momento dentro
        deste intervalo de datas (baseado em sobreposição: inclui anúncios que
        começaram antes do intervalo e ainda estão em veiculação, não apenas
        anúncios que começaram dentro dele).
    advertisement_status:
      type: array
      items:
        type: string
        enum:
          - currently_running
          - active_last_30_min
      example:
        - currently_running
      description: >-
        `currently_running`: empresas com anúncios registrados.
        `active_last_30_min`: empresas cujos anúncios foram alterados nos
        últimos 30 minutos.
    advertisement_headlines:
      type: array
      items:
        type: string
      example:
        - limited time offer
      description: Palavras-chave para buscar no texto do título dos anúncios.
    advertisement_platforms:
      type: array
      items:
        type: string
        enum:
          - linkedin
          - facebook
          - google
          - tiktok
          - apple
      example:
        - linkedin
        - facebook
      description: >-
        Filtra pela biblioteca de anúncios da qual o anúncio foi obtido.
        Minúsculas, sem distinção entre maiúsculas e minúsculas. `meta` é aceito
        como um alias para `facebook`.
    advertisement_publisher_platforms:
      type: array
      items:
        type: string
        enum:
          - facebook
          - instagram
          - messenger
          - threads
          - audience_network
      example:
        - facebook
        - instagram
      description: >-
        Filtra anúncios do Facebook/Meta pela superfície de plataforma em que
        foram veiculados. Minúsculas e sem diferenciação entre maiúsculas e
        minúsculas. Aplica-se apenas à fonte `facebook` (as demais fontes têm
        plataforma única).
    advertisement_exclude_publisher_platforms:
      type: array
      items:
        type: string
        enum:
          - facebook
          - instagram
          - messenger
          - threads
          - audience_network
      example:
        - audience_network
      description: >-
        Exclui anúncios do Facebook/Meta veiculados nessas superfícies 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: >-
        Encontra empresas com pelo menos um anúncio em qualquer um destes
        formatos criativos.
    advertisement_active_ads:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Contagem mínima e máxima de anúncios atualmente ativos da empresa, em
        todos os países. Use `null` para um limite aberto, por exemplo `[1,
        null]` para "pelo menos um anúncio ativo".
    advertisement_running_ads:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1
        - null
      description: >-
        Contagem mínima e máxima de anúncios da empresa que ainda estão em
        veiculação (sem data de término, ou com data de término no futuro).
        Atualmente preenchido apenas para anúncios do LinkedIn.
    advertisement_total_ads:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 10
        - null
      description: >-
        Contagem mínima e máxima do total de anúncios já registrados pela
        empresa, em todos os países.
    advertisement_platform_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 2
        - null
      description: >-
        Número mínimo e máximo de plataformas de anúncios distintas (linkedin,
        facebook, google, tiktok, apple) nas quais a empresa está ativamente
        anunciando.
    advertisement_format_count:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 2
        - null
      description: >-
        Número mínimo e máximo de formatos criativos de anúncio distintos que a
        empresa está veiculando ativamente.
    advertisement_impressions_estimate:
      type: array
      items:
        type: integer
        nullable: true
      minItems: 2
      maxItems: 2
      example:
        - 1000
        - null
      description: >-
        Estimativa mínima e máxima de impressões de anúncios, somadas em todos
        os países. Apenas anúncios com um intervalo de impressões reportado são
        contabilizados.
    advertisement_country_activity:
      type: object
      properties:
        country:
          type: string
          example: US
          description: >-
            Código de país ISO 3166-1 alpha-2 ao qual este filtro deve ser
            restrito. Obrigatório.
        rank:
          type: array
          items:
            type: integer
            nullable: true
          minItems: 2
          maxItems: 2
          example:
            - null
            - 500
          description: >-
            Classificação dentro daquele país por volume de investimento em
            anúncios. 1 é o maior investidor, e o número aumenta conforme o
            volume de investimento diminui. Use `[null, 500]` para encontrar os
            500 maiores investidores naquele país; use `[500, null]` para
            encontrar todos classificados na posição 500 ou inferior.
        percentile:
          type: array
          items:
            type: number
            nullable: true
          minItems: 2
          maxItems: 2
          example:
            - 90
            - null
          description: >-
            Percentil dentro daquele país por volume de investimento em
            anúncios, de 0 a 100. Quanto maior, maior o investidor. Use `[90,
            null]` para os 10% maiores investidores naquele país.
        volume_score:
          type: array
          items:
            type: number
            nullable: true
          minItems: 2
          maxItems: 2
          example:
            - 0.5
            - null
          description: >-
            A pontuação subjacente de volume de anúncios, de 0 a 1, a partir da
            qual tanto `rank` quanto `percentile` são calculados.
        active_ads:
          type: array
          items:
            type: integer
            nullable: true
          minItems: 2
          maxItems: 2
          example:
            - 1
            - null
          description: Mínimo e máximo de anúncios ativos, restrito a este país.
        running_ads:
          type: array
          items:
            type: integer
            nullable: true
          minItems: 2
          maxItems: 2
          example:
            - 1
            - null
          description: >-
            Mínimo e máximo de anúncios em veiculação, restrito a este país.
            Atualmente preenchido apenas para anúncios do LinkedIn.
        total_ads:
          type: array
          items:
            type: integer
            nullable: true
          minItems: 2
          maxItems: 2
          example:
            - 10
            - null
          description: Mínimo e máximo do total de anúncios, restrito a este país.
        impressions:
          type: array
          items:
            type: integer
            nullable: true
          minItems: 2
          maxItems: 2
          example:
            - 1000
            - null
          description: Mínimo e máximo de impressões estimadas, restrito a este país.
      required:
        - country
      example:
        country: US
        rank:
          - null
          - 500
      description: >-
        Atividade de anúncios para um país específico. `country` é obrigatório,
        e pelo menos um outro campo deve ser definido (um país sozinho não
        corresponde a nada). Para um total considerando todos os países, use os
        filtros de nível 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: >-
              A chave de filtro que especifica a qual propriedade o operador
              deve ser aplicado.
          operator:
            type: string
            enum:
              - or
              - and
            example: or
            description: >-
              O operador lógico a ser aplicado. Use 'or' para corresponder a
              qualquer um dos valores especificados, ou 'and' para exigir todos
              os valores especificados.
      description: >-
        Opções avançadas de filtragem para buscas de empresas. Especifique
        condições combinando chaves e operadores lógicos para refinar os
        resultados da busca.
    is_enable_similarity_search:
      type: boolean
      description: >-
        Quando habilitado, os filtros listados acima que suportam buscas por
        similaridade podem ser preenchidos com texto livre para IDs específicos.
    similarity_score:
      type: number
      format: float
      example: 0.7
      description: >-
        Usado em conjunto com `is_enable_similarity_search`. Esse número é usado
        para analisar se um slug específico (por exemplo, setor vertical,
        tecnologia) é semelhante à entrada do usuário, e quanto maior o número,
        mais rigoroso é o critério.
    exclude_fields:
      type: array
      items:
        type: string
      example:
        - emails
        - phones
        - contacts
      description: Lista de campos a serem excluídos do payload de resposta.
    is_parameter_metadata_available:
      type: boolean
      description: Indica se os metadados de parâmetro estão disponíveis para a requisição.
    is_profile_metadata_available:
      type: boolean
      description: Indica se os metadados de perfil estão disponíveis para a requisição.
    per_page:
      type: integer
      example: 25
      default: 25
      maximum: 25
      description: >-
        Registros por página. O padrão é 25, que também é o teto na maioria dos
        planos — o limite é o `max_search_per_page` da sua assinatura, retornado
        por [Profile](/pt/api-reference/endpoint/profile/profile). Excedê-lo
        retorna **HTTP 416** com o código `41676` (ou `41613` na busca de
        empresas e pessoas), não um conjunto de resultados limitado.
    page:
      type: integer
      example: 1
      default: 1
      description: >-
        Número da página, começando em 1. O teto é o `max_search_page` da sua
        assinatura (`max_company_search_page` para busca de empresas), retornado
        por [Profile](/pt/api-reference/endpoint/profile/profile). Excedê-lo
        retorna **HTTP 416**.
    data:
      type: object
      nullable: true
      description: As informações da resposta dependem do endpoint específico.
    target_locations:
      type: array
      items:
        type: string
      example:
        - TW
        - AE
        - 'NO'
      description: >-
        Filtra anúncios para incluir aqueles direcionados a localizações
        específicas por código de país. Use isso para encontrar anúncios que
        estão sendo exibidos em países específicos. Combina-se com
        `filter_conditions` usando o operador OR - o anúncio deve ter como alvo
        pelo menos uma das localizações especificadas.
    exclude_target_locations:
      type: array
      items:
        type: string
      example:
        - IS
        - GB
        - FR
        - IE
        - ES
      description: >-
        Filtra anúncios para excluir aqueles direcionados a localizações
        específicas por código de país. Use isso para excluir anúncios que estão
        sendo exibidos em países específicos. Quando especificado em
        `filter_conditions` com o operador 'or', o anúncio não deve ter como
        alvo nenhuma das localizações excluídas.
  responses:
    general_error:
      description: >-
        Requisição inválida. A requisição estava malformada ou continha
        parâmetros inválidos. Verifique o código de erro e a mensagem para mais
        detalhes.
      content:
        application/json:
          schema:
            required:
              - code
              - message
              - details
            type: object
            properties:
              code:
                example: 40001
                type: integer
              message:
                example: >-
                  Os erros e códigos variam de acordo com o cenário; consulte a
                  documentação para mais informações.
                type: string
              details:
                type: object
    rate_limit_error:
      description: >-
        Limite de requisições excedido. Foram feitas requisições em excesso em
        um determinado período de tempo. Tente novamente após a janela do limite
        de requisições ser reiniciada.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: >-
                  Limite de requisições excedido. Aguarde e tente novamente mais
                  tarde.
                type: string
    server_error:
      description: >-
        Erro interno do servidor. Ocorreu um erro inesperado no servidor. Entre
        em contato com o suporte caso o erro persista.
      content:
        application/json:
          schema:
            required:
              - error
            type: object
            properties:
              error:
                example: Ocorreu um erro inesperado no servidor.
                type: string
  securitySchemes:
    pubrio_api_key:
      type: apiKey
      name: pubrio-api-key
      description: >-
        Um token de API exclusivo que representa as ações que você realiza por
        meio da API e as permissões e operações correspondentes. Você pode
        criá-lo na seção
        [Configurações](https://dashboard.pubrio.com/#/settings/).
      in: header

````