> ## 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 Notícias de Empresas > Busca notícias sobre empresas. Consulte o [guia de News Search](/pt/developer-guides/search/news-search). ## OpenAPI ````yaml pt-openapi POST /companies/news/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/news/search: post: tags: - Search summary: Buscar notícias de empresas description: >- Busca notícias sobre empresas. Consulte o [guia de News Search](/pt/developer-guides/search/news-search). operationId: companies_search_news parameters: [] requestBody: required: true content: application/json: schema: type: object properties: locations: $ref: '#/components/schemas/locations' company_locations: $ref: '#/components/schemas/company_locations' companies: $ref: '#/components/schemas/companies' news_search_id: allOf: - $ref: '#/components/schemas/news_search_id' description: >- Retorna apenas este registro. Útil para buscar novamente um registro que você armazenou anteriormente, sem precisar paginar. domains: $ref: '#/components/schemas/domains' linkedin_urls: $ref: '#/components/schemas/company_linkedin_urls' search_term: $ref: '#/components/schemas/search_term' search_terms: type: array items: type: string example: - Trump description: >- Array de strings de palavras-chave para filtrar artigos de notícias. Cada termo é comparado com o conteúdo do artigo. Use `search_term` para uma única string ou `search_terms` para várias palavras-chave. categories: $ref: '#/components/schemas/news_categories' news_gallery_ids: $ref: '#/components/schemas/news_gallery_ids' published_dates: $ref: '#/components/schemas/published_dates' published_at: $ref: '#/components/schemas/news_published_at_from' per_page: $ref: '#/components/schemas/per_page' page: $ref: '#/components/schemas/page' is_ascending_order: $ref: '#/components/schemas/is_ascending_order' news_galleries: type: array items: type: string example: - electronic-commerce description: >- Lista de `gallery slugs` para filtrar notícias por galeria. Para encontrar um slug, chame o endpoint `news galleries` na aba Filters. news_languages: type: array items: type: string example: - en description: >- Lista de valores `locale_code` para filtrar notícias por idioma. Para encontrar os códigos disponíveis, chame o endpoint `news languages` na aba Filters. is_expansion_signal_available: $ref: '#/components/schemas/is_expansion_signal_available' expansion_signal_types: $ref: '#/components/schemas/expansion_signal_types' expansion_signal_polarities: $ref: '#/components/schemas/expansion_signal_polarities' responses: '200': description: >- Resposta bem-sucedida contendo os detalhes da busca de notícias de empresas. content: application/json: schema: type: object properties: metadata: $ref: '#/components/schemas/search_metadata' data: type: object properties: pagination: $ref: '#/components/schemas/search_pagination' news: type: array items: $ref: '#/components/schemas/news_search_result' example: metadata: profile: null filters: domains: - stripe.com per_page: 25 language: en ignored_fields: [] data: pagination: page: 1 per_page: 25 total_entries: 351800 total_pages: 14072 is_timeout: false total_display_pages: 250 news: - news_id: 0b0f1c53-7a04-4a46-b5bc-3b17a7c4cfbd news_search_id: 4110b929-17cd-42aa-a159-906ead0c9b56 country_codes: - CN - SG company_country_codes: - CN - FR domains: - insead.edu - digitalchina.com companies: - logo_url: >- https://buckets.pubrio.com/company-logo/MjY5OTY5NDJpbnNlYWQuZWR1bGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: dfbe6797-5311-46f9-9518-bf1a7c3d09bc country_code: FR company_name: Insead linkedin_name: insead domain: insead.edu - logo_url: >- https://buckets.pubrio.com/company-logo/NDA2NTQ5NTFkaWdpdGFsY2hpbmEuY29tbGlua2VkaW5fcF9sb2dvMTU=.jpg domain_search_id: e13a9e24-a07d-4630-9b47-fceb778df74e country_code: CN company_name: Digital China linkedin_name: digital-china domain: digitalchina.com news_galleries: - slug: banking-financial-service news_gallery_id: 7c8ec9cc-66c5-4153-82da-9c8f356c6c99 name: Banking/Financial Service locations: - Singapore - China last_modified: '2025-06-01T08:15:23.945Z' image_url: null url: http://enold.prnasia.com/p/asia-story-125304015-0.shtml published_at: '2025-06-01T08:00:00.000Z' language: id source: prnasia.com category: launches title: >- Digital China's AI-driven transformation showcased at INSEAD summary: >- Guo Wei, Chairman of Digital China, presented on AI-era corporate management at INSEAD 2025 Asia AI Conference, launching a case study on Digital China's AI transformation journey. news_category_name: Launches - ... '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: 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. company_locations: type: array items: type: string example: - US - SG - CN description: >- A localização da sede da empresa. Consulte os endpoints de `location` na aba Filters para mais informações. 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. news_search_id: type: string format: uuid example: 4110b929-17cd-42aa-a159-906ead0c9b56 description: Um identificador único para a operação de busca de notícias de empresas. 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/` search_term: type: string example: pubrio description: Uma string de palavras pela qual queremos filtrar os resultados. 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. news_gallery_ids: type: array items: type: string format: uuid description: >- Uma lista de `news_gallery_id` usada para buscar galerias de notícias específicas. Para encontrar o ID, chame o endpoint `news galleries` 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. news_published_at_from: type: string format: date-time example: '2026-09-01T00:00:00Z' description: >- Publicado neste instante ou depois (UTC). Data ou timestamp ISO. `published_dates` é a forma de janela fechada e usa o fuso horário do seu workspace. 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**. is_ascending_order: type: boolean default: false example: false description: >- Direção da ordenação. Por padrão, os resultados são retornados do mais recente para o mais antigo; defina `true` para do mais antigo para o mais recente. Não há `sort_by` neste endpoint — a chave de ordenação é fixa e está indicada na descrição do endpoint. is_expansion_signal_available: type: boolean description: >- Quando `true`, anexa os sinais de expansão resolvidos (`expansion_signals`) a cada notícia e habilita os filtros `expansion_signal_types` / `expansion_signal_polarities`. Deixe sem definir para a busca mais rápida — a junção de expansão só é adicionada quando este sinalizador está ativado. expansion_signal_types: 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: - HIRE - PARTNER description: >- Retorna apenas notícias que produziram um sinal de expansão de um destes tipos (slugs em maiúsculas). Requer `is_expansion_signal_available: true`. Slugs desconhecidos são ignorados. expansion_signal_polarities: type: array items: type: string enum: - expansion - contraction_leading - contraction_confirming - contraction_lagging example: - expansion description: >- Retorna apenas notícias cujo sinal de expansão tenha uma destas polaridades. Requer `is_expansion_signal_available: true`. Combinado com `expansion_signal_types` como E (AND). search_metadata: type: object description: Contexto da requisição. properties: profile: type: object nullable: true description: >- Bloco de créditos (`credit`, `topup_credit`, `total_credit_cost`) quando a contabilização de créditos é solicitada; `null` no tráfego comum via chave de API. filters: type: object description: >- Eco do corpo da requisição conforme aplicado pelo endpoint, incluindo padrões como `per_page` e `language`. ignored_fields: type: array items: type: string description: >- Chaves do corpo que o endpoint não reconheceu e descartou. Vazio significa que todas as chaves foram aplicadas — um filtro digitado incorretamente amplia a busca em vez de falhar. search_pagination: type: object description: Paginação do conjunto de resultados. properties: page: type: integer description: Número da página atual. per_page: type: integer description: Registros por página. total_entries: type: integer description: >- Total de registros correspondentes. Em buscas amplas e não específicas de empresa, este valor é uma estimativa. total_pages: type: integer description: '`total_entries` dividido por `per_page`.' total_display_pages: type: integer description: >- Páginas que você pode efetivamente solicitar, limitadas pelo `max_search_page` do seu plano. is_timeout: type: boolean description: >- `true` quando a consulta de contagem excedeu o tempo limite e `total_entries` é uma estimativa parcial. news_search_result: type: object description: Um artigo de notícia. properties: news_id: type: string format: uuid description: Identificador do artigo. news_search_id: type: string format: uuid description: Identificador do registro de busca. Informe-o no News Lookup. title: type: string description: Manchete. summary: type: string description: Resumo curto do artigo. nullable: true url: type: string description: Link para o artigo. source: type: string description: Domínio do publicador. nullable: true image_url: type: string description: Imagem principal, quando o artigo possui uma. nullable: true language: type: string description: >- Código de idioma ISO 639-1 do artigo. Mesmo vocabulário do filtro `news_languages`. nullable: true published_at: type: string format: date-time description: >- Data e hora de publicação. Esta é a chave de ordenação padrão (artigos sem data aparecem por último). nullable: true last_modified: type: string format: date-time description: Quando o registro foi atualizado pela última vez. category: type: string description: >- Slug da categoria da notícia. Mesmo vocabulário do filtro `categories` e do endpoint News Categories. nullable: true news_category_name: type: string description: >- Nome da categoria em formato legível, localizado conforme `language`. nullable: true news_galleries: type: array nullable: true items: type: object properties: news_gallery_id: type: string format: uuid slug: type: string name: type: string description: Galerias às quais o artigo pertence; `null` quando não há nenhuma. country_codes: type: array nullable: true items: type: string description: >- Países sobre os quais o artigo trata (ISO 3166-1 alfa-2); `null` quando não detectado. Mesmo vocabulário do filtro `locations`. company_country_codes: type: array nullable: true items: type: string description: >- Países de sede das empresas mencionadas. Mesmo vocabulário do filtro `company_locations`. locations: type: array nullable: true items: type: string description: Nomes de lugares mencionados no artigo; `null` quando não há nenhum. domains: type: array items: type: string description: Domínios de todas as empresas mencionadas no artigo. companies: type: array items: $ref: '#/components/schemas/search_result_company' description: >- Todas as empresas mencionadas no artigo, na mesma ordem de `domains`. expansion_signals: type: array items: type: object properties: signal_type_slug: type: string description: Tipo de sinal, por exemplo `HIRE`, `PARTNER`, `PRODUCT`. signal_subtype_slug: type: string description: Subtipo do sinal, quando o tipo possui um. nullable: true signal_strength_slug: type: string description: 'Força do sinal: `low`, `medium`, `high`, `very_high`.' polarity: type: string description: >- `expansion`, `contraction_leading`, `contraction_confirming` ou `contraction_lagging`. country_code: type: string description: Mercado ao qual o sinal se refere. nullable: true domain_search_id: type: string format: uuid description: Empresa à qual o sinal pertence. event_date: type: string format: date-time description: Quando o sinal ocorreu. description: >- Somente quando `is_expansion_signal_available: true`: os sinais de expansão que este artigo produziu. Array vazio quando não há nenhum. search_result_company: type: object description: A empresa à qual o registro está vinculado. properties: domain_search_id: type: string format: uuid description: >- Identificador de empresa da Pubrio. Informe-o em `companies` em qualquer busca, ou no Company Lookup. company_name: type: string description: Nome da empresa. linkedin_name: type: string nullable: true description: Slug da empresa no LinkedIn (a parte após `linkedin.com/company/`). country_code: type: string nullable: true description: Código ISO 3166-1 alfa-2 da sede da empresa. company_url: type: string nullable: true description: URL do site da empresa. domain: type: string description: Domínio da empresa, normalizado (`stripe.com`). logo_url: type: string nullable: true description: URL do logotipo da empresa. 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 ````