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

# Company News Search

> Search for news articles related to companies matching specified criteria such as categories, locations, and keywords.



## OpenAPI

````yaml en-openapi POST /companies/news/search
openapi: 3.0.0
info:
  description: >-
    The Pubrio API is used to search, preview and enrich Contacts and Accounts.
    Pubrio database provides extensive B2B contacts and sales intelligence data.
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/en/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/en/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: Workspace profile information and usage statistics
  - name: Enrichment
    description: Enrich people and company records with detailed B2B data
  - name: Lookalike
    description: Find companies similar to a given company
  - name: Search
    description: Search for people, companies, jobs, news, and advertisements with filters
  - name: Lookup
    description: >-
      Look up detailed information for specific people, companies, jobs, news,
      advertisements, and technologies
  - name: LinkedIn
    description: Look up people and company data via LinkedIn profile URLs
  - name: Redeem
    description: Redeem credits to unlock people contact details (single and batch)
  - name: Channels
    description: Manage outreach channel templates (create, update, delete, list)
  - name: Monitor
    description: Create and manage data monitors with webhooks, statistics, and processing
  - name: Filters
    description: >-
      Retrieve available filter values for search parameters (technologies,
      locations, verticals, etc.)
externalDocs:
  description: >-
    The Pubrio API is used to search, preview and enrich Contacts and Accounts.
    Pubrio database provides extensive B2B contacts and sales intelligence data.
  url: https://docs.pubrio.com
paths:
  /companies/news/search:
    post:
      tags:
        - Search
      summary: Search for company news
      description: >-
        Search for news articles related to companies matching specified
        criteria such as categories, locations, and keywords.
      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'
                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 of keyword strings to filter news articles. Each term
                    is matched against article content. Use `search_term` for a
                    single string or `search_terms` for multiple keywords.
                categories:
                  $ref: '#/components/schemas/news_categories'
                news_gallery_ids:
                  $ref: '#/components/schemas/news_gallery_ids'
                published_dates:
                  $ref: '#/components/schemas/published_dates'
                per_page:
                  $ref: '#/components/schemas/per_page'
                page:
                  $ref: '#/components/schemas/page'
                news_galleries:
                  type: array
                  items:
                    type: string
                  example:
                    - electronic-commerce
                  description: >-
                    List of `gallery slugs` for filtering news by gallery. To
                    find a slug, call the `news galleries` endpoint under the
                    Filters tab.
                news_languages:
                  type: array
                  items:
                    type: string
                  example:
                    - en
                  description: >-
                    List of `locale_code` values for filtering news by language.
                    To find available codes, call the `news languages` endpoint
                    under the Filters tab.
                profile_id:
                  $ref: '#/components/schemas/profile_id'
      responses:
        '200':
          description: Successful response containing company news search details.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/data'
              example:
                data:
                  pagination:
                    page: 1
                    per_page: 25
                    total_entries: 351800
                    total_pages: 14072
                    is_timeout: false
                  news:
                    - news_id: 0b0f1c53-7a04-4a46-b5bc-3b17a7c4cfbd
                      news_search_id: 4110b929-17cd-42aa-a159-906ead0c9b56
                      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: >-
        ISO 3166-1 alpha-2 (cca2) is used for filtering locations. Check out
        `location` endpoints under the Filters tab for more information.
    company_locations:
      type: array
      items:
        type: string
      example:
        - US
        - SG
        - CN
      description: >-
        The location of the company headquarters. Check out `location` endpoints
        under the Filters tab for more information.
    companies:
      type: array
      items:
        type: string
        format: uuid
      description: >-
        A list of unique identifiers (domain_search_id) used for company and
        people search operations.
    domains:
      type: array
      items:
        type: string
      example:
        - pubrio.com
      description: >-
        List of company domains used for company and people search operations.
        If we receive a URL such as `www.pubrio.com` or
        `https://docs.pubrio.com/`, the system will convert it to `pubrio.com`
        for processing.
    company_linkedin_urls:
      type: array
      items:
        type: string
      example:
        - https://www.linkedin.com/company/pubrio
      description: >-
        The fully formed URL of the LinkedIn company profile. URL begin with
        `http` and contain `linkedin.com/company/`
    search_term:
      type: string
      example: pubrio
      description: A string of words over which we want to filter the results.
    news_categories:
      type: array
      items:
        type: string
      example:
        - launches
      description: >-
        List of `category slugs` for searching for specific news categories. To
        find a slug, call the `news categories` endpoint under the Filters tab.
    news_gallery_ids:
      type: array
      items:
        type: string
        format: uuid
      description: >-
        A list of `news_gallery_id` used to search for specific news galleries.
        To find the ID, call the `news galleries` endpoint under the Filters
        tab.
    published_dates:
      type: array
      items:
        type: string
      example:
        - '2025-01-01'
        - '2025-01-10'
      description: Date range of the published date. The maximum value is the current day.
    per_page:
      type: integer
      example: 25
      description: >-
        The number of search results that should be returned for each page.
        Limited the number of results per page improves the endpoint's
        performance.
    page:
      type: integer
      example: 1
      description: The page number of the Pubrio data that you want to retrieve.
    profile_id:
      type: integer
      description: >-
        Optional. An identifier for the user profile (workspace) making the
        request. This is no longer required as the API key already includes your
        workspace information. If provided, it helps in associating the lookup
        with a specific user, allowing for data retrieval and credit tracking. 

         Check out `user details` endpoints under the Profile tab for more information.
    data:
      type: object
      nullable: true
      description: Response info depends on specific endpoint.
  responses:
    general_error:
      description: >-
        Bad request. The request was malformed or contained invalid parameters.
        Check the error code and message for details.
      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: >-
        Rate limit exceeded. Too many requests were made in a given time period.
        Retry after the rate limit window resets.
      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: >-
        Internal server error. An unexpected error occurred on the server.
        Contact support if the error persists.
      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: >-
        A unique API token that represents the actions you perform through the
        API and the corresponding permissions and operations. You can create it
        through the [Settings](https://dashboard.pubrio.com/#/settings/)
        section.
      in: header

````