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

# Unternehmensnachrichten durchsuchen

> Nachrichten über Unternehmen durchsuchen. Siehe den [News-Search-Leitfaden](/de/developer-guides/search/news-search).



## OpenAPI

````yaml de-openapi POST /companies/news/search
openapi: 3.0.0
info:
  description: >-
    Die Pubrio API liefert Market-Expansion-Intelligence – Echtzeit-Signale, die
    anzeigen, wenn ein Unternehmen in einen neuen Markt eintritt – zusammen mit
    den zugrunde liegenden Unternehmens- und Personendaten. Durchsuchen,
    schlagen Sie nach und reichern Sie Accounts und Kontakte an, und abonnieren
    Sie typisierte, datierte Bewegungssignale in über 200 Märkten.
  version: 1.0.0
  title: Pubrio OpenAPI
  termsOfService: https://pubrio.com/de/terms-of-service
  contact:
    email: king.lai@pubrio.com
    name: King Lai
    url: https://pubrio.com/de/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-Profilinformationen und Nutzungsstatistiken
  - name: Enrichment
    description: >-
      Personen- und Unternehmensdatensätze mit detaillierten B2B-Daten
      anreichern
  - name: Lookalike
    description: Unternehmen finden, die einem bestimmten Unternehmen ähnlich sind
  - name: Search
    description: >-
      Personen, Unternehmen, Stellenanzeigen, Nachrichten und Werbeanzeigen mit
      Filtern durchsuchen
  - name: Lookup
    description: >-
      Detaillierte Informationen zu bestimmten Personen, Unternehmen,
      Stellenanzeigen, Nachrichten, Werbeanzeigen und Technologien nachschlagen
  - name: LinkedIn
    description: Personen- und Unternehmensdaten über LinkedIn-Profil-URLs nachschlagen
  - name: Redeem
    description: >-
      Credits einlösen, um Kontaktdaten von Personen freizuschalten (einzeln und
      im Batch)
  - name: Channels
    description: >-
      Outreach-Kanalvorlagen verwalten (erstellen, aktualisieren, löschen,
      auflisten)
  - name: Monitor
    description: >-
      Daten-Monitore mit Webhooks, Statistiken und Verarbeitung erstellen und
      verwalten
  - name: Filters
    description: >-
      Verfügbare Filterwerte für Suchparameter abrufen (Technologien, Standorte,
      Branchen usw.)
  - name: API Keys
    description: >-
      API-Anfrageprotokolle und Nutzungsanalysen für API-Schlüssel auflisten und
      einsehen
  - name: Insights
    description: >-
      Aggregierte Signal-Insights für Unternehmen (Stellenanzeigen, Nachrichten,
      Werbeanzeigen).
  - name: Export
    description: Massendatenexporte (kreditpflichtig).
  - name: Expansion
    description: >-
      Market-Expansion-Intelligence für Unternehmen: Signale, Phasen, Märkte und
      Exporte.
externalDocs:
  description: >-
    Die Pubrio-API dient zum Suchen, Anzeigen einer Vorschau und Anreichern von
    Kontakten und Accounts. Die Pubrio-Datenbank bietet umfangreiche
    B2B-Kontakt- und Sales-Intelligence-Daten.
  url: https://docs.pubrio.com
paths:
  /companies/news/search:
    post:
      tags:
        - Search
      summary: Nach Unternehmensnachrichten suchen
      description: >-
        Nachrichten über Unternehmen durchsuchen. Siehe den
        [News-Search-Leitfaden](/de/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: >-
                    Nur diesen einen Datensatz zurückgeben. Praktisch, um eine
                    zuvor gespeicherte Zeile ohne Paginierung erneut abzurufen.
                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 von Schlüsselwort-Zeichenfolgen zum Filtern von
                    Nachrichtenartikeln. Jeder Begriff wird mit dem Inhalt des
                    Artikels abgeglichen. Verwenden Sie `search_term` für eine
                    einzelne Zeichenfolge oder `search_terms` für mehrere
                    Schlüsselwörter.
                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: >-
                    Liste von `gallery slugs` zum Filtern von Nachrichten nach
                    Galerie. Einen Slug finden Sie über den `news
                    galleries`-Endpunkt im Filters-Tab.
                news_languages:
                  type: array
                  items:
                    type: string
                  example:
                    - en
                  description: >-
                    Liste von `locale_code`-Werten zum Filtern von Nachrichten
                    nach Sprache. Verfügbare Codes finden Sie über den `news
                    languages`-Endpunkt im Filters-Tab.
                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: Erfolgreiche Antwort mit Details zur Unternehmens-Nachrichtensuche.
          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 von Digital China, hielt auf der
                        INSEAD 2025 Asia AI Conference einen Vortrag über
                        Unternehmensführung im KI-Zeitalter und stellte eine
                        Fallstudie zur KI-Transformation von Digital China vor.
                      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) wird zum Filtern von Standorten verwendet.
        Weitere Informationen finden Sie über die Endpunkte `location` im
        Filters-Tab.
    company_locations:
      type: array
      items:
        type: string
      example:
        - US
        - SG
        - CN
      description: >-
        Der Standort des Unternehmenshauptsitzes. Weitere Informationen finden
        Sie über die Endpunkte `location` im Filters-Tab.
    companies:
      type: array
      items:
        type: string
        format: uuid
      description: >-
        Eine Liste eindeutiger Kennungen (domain_search_id) für Unternehmens-
        und Personensuchvorgänge.
    news_search_id:
      type: string
      format: uuid
      example: 4110b929-17cd-42aa-a159-906ead0c9b56
      description: Eine eindeutige Kennung für den Vorgang der Unternehmens-News-Suche.
    domains:
      type: array
      items:
        type: string
      example:
        - pubrio.com
      description: >-
        Liste von Unternehmensdomains für Unternehmens- und
        Personensuchvorgänge. Erhalten wir eine URL wie `www.pubrio.com` oder
        `https://docs.pubrio.com/`, wandelt das System diese zur Verarbeitung in
        `pubrio.com` um.
    company_linkedin_urls:
      type: array
      items:
        type: string
      example:
        - https://www.linkedin.com/company/pubrio
      description: >-
        Die vollständige URL des LinkedIn-Unternehmensprofils. Die URL beginnt
        mit `http` und enthält `linkedin.com/company/`
    search_term:
      type: string
      example: pubrio
      description: Eine Wortfolge, nach der die Ergebnisse gefiltert werden sollen.
    news_categories:
      type: array
      items:
        type: string
      example:
        - launches
      description: >-
        Liste von `category slugs` zur Suche nach bestimmten News-Kategorien.
        Den Slug finden Sie über den Endpunkt `news categories` im Filters-Tab.
    news_gallery_ids:
      type: array
      items:
        type: string
        format: uuid
      description: >-
        Eine Liste von `news_gallery_id`, mit der nach bestimmten News-Galerien
        gesucht wird. Die ID finden Sie über den Endpunkt `news galleries` im
        Filters-Tab.
    published_dates:
      type: array
      items:
        type: string
      example:
        - '2025-01-01'
        - '2025-01-10'
      description: >-
        Datumsbereich des Publikationsdatums. Der Maximalwert ist der aktuelle
        Tag. Tagesgrenzen richten sich nach der Zeitzone Ihres Workspace.
    news_published_at_from:
      type: string
      format: date-time
      example: '2026-09-01T00:00:00Z'
      description: >-
        Veröffentlicht zu oder nach diesem Zeitpunkt (UTC). Datum oder
        ISO-Zeitstempel. `published_dates` ist die geschlossene Fensterform und
        verwendet die Zeitzone Ihres Workspace.
    per_page:
      type: integer
      example: 25
      default: 25
      maximum: 25
      description: >-
        Datensätze pro Seite. Standardmäßig 25, was bei den meisten Tarifen auch
        die Obergrenze ist — das Limit ist der `max_search_per_page`-Wert Ihres
        Abonnements, zurückgegeben von
        [Profile](/de/api-reference/endpoint/profile/profile). Bei
        Überschreitung wird **HTTP 416** mit dem Code `41676` (oder `41613` bei
        der Unternehmens- und Personensuche) zurückgegeben, keine begrenzte
        Ergebnismenge.
    page:
      type: integer
      example: 1
      default: 1
      description: >-
        Seitenzahl, beginnend bei 1. Die Obergrenze ist der
        `max_search_page`-Wert Ihres Abonnements (`max_company_search_page` für
        die Unternehmenssuche), zurückgegeben von
        [Profile](/de/api-reference/endpoint/profile/profile). Bei
        Überschreitung wird **HTTP 416** zurückgegeben.
    is_ascending_order:
      type: boolean
      default: false
      example: false
      description: >-
        Sortierrichtung. Ergebnisse werden standardmäßig neueste zuerst
        zurückgegeben; setzen Sie `true` für älteste zuerst. Dieser Endpunkt
        kennt kein `sort_by` – der Sortierschlüssel ist fest und in der
        Endpunktbeschreibung angegeben.
    is_expansion_signal_available:
      type: boolean
      description: >-
        Bei `true` werden die aufgelösten Expansionssignale
        (`expansion_signals`) an jeden News-Eintrag angehängt und die Filter
        `expansion_signal_types` / `expansion_signal_polarities` aktiviert. Für
        die schnellste Suche nicht setzen – der Expansions-Join wird nur
        hinzugefügt, wenn dieses Flag aktiviert ist.
    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: >-
        Gibt nur News zurück, die ein Expansionssignal eines dieser Typen (Slugs
        in Großbuchstaben) erzeugt haben. Erfordert
        `is_expansion_signal_available: true`. Unbekannte Slugs werden
        ignoriert.
    expansion_signal_polarities:
      type: array
      items:
        type: string
        enum:
          - expansion
          - contraction_leading
          - contraction_confirming
          - contraction_lagging
      example:
        - expansion
      description: >-
        Gibt nur News zurück, deren Expansionssignal eine dieser Polaritäten
        trägt. Erfordert `is_expansion_signal_available: true`. Wird mit
        `expansion_signal_types` als AND kombiniert.
    search_metadata:
      type: object
      description: Anfragekontext.
      properties:
        profile:
          type: object
          nullable: true
          description: >-
            Credit-Block (`credit`, `topup_credit`, `total_credit_cost`), wenn
            eine Credit-Abrechnung angefordert wird; `null` bei reinem
            API-Key-Traffic.
        filters:
          type: object
          description: >-
            Rückgabe des Request-Bodys so, wie der Endpunkt ihn angewendet hat,
            einschließlich Standardwerten wie `per_page` und `language`.
        ignored_fields:
          type: array
          items:
            type: string
          description: >-
            Body-Schlüssel, die der Endpunkt nicht erkannt und verworfen hat.
            Leer bedeutet, dass jeder Schlüssel angewendet wurde – ein falsch
            geschriebener Filter erweitert die Suche, statt fehlzuschlagen.
    search_pagination:
      type: object
      description: Paginierung für die Ergebnismenge.
      properties:
        page:
          type: integer
          description: Aktuelle Seitenzahl.
        per_page:
          type: integer
          description: Datensätze pro Seite.
        total_entries:
          type: integer
          description: >-
            Gesamtzahl der passenden Datensätze. Bei breiten,
            unternehmensunabhängigen Suchen handelt es sich um eine Schätzung.
        total_pages:
          type: integer
          description: '`total_entries` geteilt durch `per_page`.'
        total_display_pages:
          type: integer
          description: >-
            Seiten, die Sie tatsächlich anfordern können, begrenzt durch
            `max_search_page` Ihres Tarifs.
        is_timeout:
          type: boolean
          description: >-
            `true`, wenn die Zählabfrage ein Timeout hatte und `total_entries`
            eine teilweise Schätzung ist.
    news_search_result:
      type: object
      description: Ein News-Artikel.
      properties:
        news_id:
          type: string
          format: uuid
          description: Artikelkennung.
        news_search_id:
          type: string
          format: uuid
          description: Kennung des Suchdatensatzes. Übergeben Sie sie an News Lookup.
        title:
          type: string
          description: Schlagzeile.
        summary:
          type: string
          description: Kurze Zusammenfassung des Artikels.
          nullable: true
        url:
          type: string
          description: Link zum Artikel.
        source:
          type: string
          description: Domain des Publishers.
          nullable: true
        image_url:
          type: string
          description: Titelbild, sofern der Artikel eines hat.
          nullable: true
        language:
          type: string
          description: >-
            ISO-639-1-Sprachcode des Artikels. Gleiches Vokabular wie der Filter
            `news_languages`.
          nullable: true
        published_at:
          type: string
          format: date-time
          description: >-
            Veröffentlichungszeitpunkt. Dies ist der Standard-Sortierschlüssel
            (undatierte Artikel werden zuletzt sortiert).
          nullable: true
        last_modified:
          type: string
          format: date-time
          description: Wann der Datensatz zuletzt aktualisiert wurde.
        category:
          type: string
          description: >-
            News-Kategorie-Slug. Gleiches Vokabular wie der Filter `categories`
            und der Endpunkt News Categories.
          nullable: true
        news_category_name:
          type: string
          description: Für Menschen lesbarer Kategoriename, lokalisiert in `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: Galerien, zu denen der Artikel gehört; `null`, wenn keine.
        country_codes:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            Länder, um die es in dem Artikel geht (ISO 3166-1 Alpha-2); `null`,
            wenn nicht erkannt. Gleiches Vokabular wie der Filter `locations`.
        company_country_codes:
          type: array
          nullable: true
          items:
            type: string
          description: >-
            Hauptsitzländer der erwähnten Unternehmen. Gleiches Vokabular wie
            der Filter `company_locations`.
        locations:
          type: array
          nullable: true
          items:
            type: string
          description: Im Artikel erwähnte Ortsnamen; `null`, wenn keine.
        domains:
          type: array
          items:
            type: string
          description: Domains aller im Artikel erwähnten Unternehmen.
        companies:
          type: array
          items:
            $ref: '#/components/schemas/search_result_company'
          description: >-
            Alle im Artikel erwähnten Unternehmen, in derselben Reihenfolge wie
            `domains`.
        expansion_signals:
          type: array
          items:
            type: object
            properties:
              signal_type_slug:
                type: string
                description: Signaltyp, z. B. `HIRE`, `PARTNER`, `PRODUCT`.
              signal_subtype_slug:
                type: string
                description: Signal-Subtyp, sofern der Typ einen hat.
                nullable: true
              signal_strength_slug:
                type: string
                description: 'Signalstärke: `low`, `medium`, `high`, `very_high`.'
              polarity:
                type: string
                description: >-
                  `expansion`, `contraction_leading`, `contraction_confirming`
                  oder `contraction_lagging`.
              country_code:
                type: string
                description: Markt, auf den das Signal verweist.
                nullable: true
              domain_search_id:
                type: string
                format: uuid
                description: Unternehmen, zu dem das Signal gehört.
              event_date:
                type: string
                format: date-time
                description: Wann das Signal aufgetreten ist.
          description: >-
            Nur wenn `is_expansion_signal_available: true`: die
            Expansionssignale, die dieser Artikel erzeugt hat. Leeres Array,
            wenn keine.
    search_result_company:
      type: object
      description: Das Unternehmen, mit dem der Datensatz verknüpft ist.
      properties:
        domain_search_id:
          type: string
          format: uuid
          description: >-
            Pubrio-Unternehmenskennung. Übergeben Sie sie an `companies` bei
            jeder Suche oder an Company Lookup.
        company_name:
          type: string
          description: Unternehmensname.
        linkedin_name:
          type: string
          nullable: true
          description: LinkedIn-Unternehmens-Slug (der Teil nach `linkedin.com/company/`).
        country_code:
          type: string
          nullable: true
          description: ISO-3166-1-Alpha-2-Code des Unternehmenshauptsitzes.
        company_url:
          type: string
          nullable: true
          description: URL der Unternehmenswebsite.
        domain:
          type: string
          description: Unternehmensdomain, normalisiert (`stripe.com`).
        logo_url:
          type: string
          nullable: true
          description: URL des Unternehmenslogos.
  responses:
    general_error:
      description: >-
        Ungültige Anfrage. Die Anfrage war fehlerhaft formatiert oder enthielt
        ungültige Parameter. Prüfen Sie den Fehlercode und die Meldung für
        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 überschritten. Es wurden zu viele Anfragen in einem
        bestimmten Zeitraum gestellt. Versuchen Sie es erneut, nachdem das
        Rate-Limit-Fenster zurückgesetzt wurde.
      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: >-
        Interner Serverfehler. Auf dem Server ist ein unerwarteter Fehler
        aufgetreten. Wenden Sie sich an den Support, falls der Fehler weiterhin
        besteht.
      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: >-
        Ein eindeutiges API-Token, das die von Ihnen über die API durchgeführten
        Aktionen sowie die zugehörigen Berechtigungen und Vorgänge
        repräsentiert. Sie können es über den Bereich
        [Settings](https://dashboard.pubrio.com/#/settings/) erstellen.
      in: header

````