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

# Expansions-Übersicht

> Expansions-KPIs auf Marktebene — Stage-Zählungen pro Markt und wichtigste grenzüberschreitende Ströme. Aggregiert, nicht paginiert.



## OpenAPI

````yaml de-openapi POST /expansions/dashboard
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:
  /expansions/dashboard:
    post:
      tags:
        - Expansion
      summary: Expansionsübersicht
      description: >-
        Expansions-KPIs auf Marktebene — Stage-Zählungen pro Markt und
        wichtigste grenzüberschreitende Ströme. Aggregiert, nicht paginiert.
      operationId: expansions_dashboard
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                froms:
                  $ref: '#/components/schemas/expansion_froms'
                tos:
                  $ref: '#/components/schemas/expansion_tos'
                exclude_froms:
                  $ref: '#/components/schemas/expansion_exclude_froms'
                exclude_tos:
                  $ref: '#/components/schemas/expansion_exclude_tos'
                stages:
                  allOf:
                    - $ref: '#/components/schemas/expansion_stages'
                  description: >-
                    Werte unterscheiden zwischen Groß- und Kleinschreibung und
                    werden **nicht validiert**. Ein nicht erkannter Wert wird
                    stillschweigend verworfen statt abgelehnt: Bei `stages`,
                    `freshness`, `scopes` und `momentum` wird der gesamte Filter
                    fallen gelassen, und Sie erhalten *ungefilterte* Ergebnisse,
                    während bei `signal_types` und `signal_strengths` der Filter
                    angewendet wird und *nichts* trifft. So oder so wirkt die
                    Antwort normal. Lösen Sie gültige Slugs über die
                    [Expansion-Referenz](/de/api-reference/endpoint/expansions/types)
                    auf und vergleichen Sie `data.pagination.total_entries` mit
                    einem ungefilterten Aufruf, wenn ein Ergebnis falsch
                    erscheint.
                momentum:
                  allOf:
                    - $ref: '#/components/schemas/expansion_momentum'
                  description: >-
                    Verlauf der Bewegung des Unternehmens im Markt. `advancing`
                    bedeutet Fortschritt, `steady` bedeutet Halten,
                    `pulling_back` umfasst Rückzug und Kontraktion.


                    Verwenden Sie hier **nicht** die Werte aus `directions` in
                    der
                    [Expansion-Referenz](/de/api-reference/endpoint/expansions/types).
                    Diese (`advancing`, `steady`, `retreating`, `new`) sind die
                    *Antwort*-Werte, die Sie bei `stage.direction`
                    zurückerhalten; nur die drei oben genannten werden als
                    *Filter* akzeptiert. Das Senden von `retreating` oder `new`
                    deaktiviert den Filter stillschweigend und liefert
                    ungefilterte Ergebnisse.
                freshness:
                  allOf:
                    - $ref: '#/components/schemas/expansion_freshness'
                  description: >-
                    Werte unterscheiden zwischen Groß- und Kleinschreibung und
                    werden **nicht validiert**. Ein nicht erkannter Wert wird
                    stillschweigend verworfen statt abgelehnt: Bei `stages`,
                    `freshness`, `scopes` und `momentum` wird der gesamte Filter
                    fallen gelassen, und Sie erhalten *ungefilterte* Ergebnisse,
                    während bei `signal_types` und `signal_strengths` der Filter
                    angewendet wird und *nichts* trifft. So oder so wirkt die
                    Antwort normal. Lösen Sie gültige Slugs über die
                    [Expansion-Referenz](/de/api-reference/endpoint/expansions/types)
                    auf und vergleichen Sie `data.pagination.total_entries` mit
                    einem ungefilterten Aufruf, wenn ein Ergebnis falsch
                    erscheint.
                scopes:
                  $ref: '#/components/schemas/expansion_scopes'
                ahead_of_pace:
                  type: boolean
                  example: false
                  description: >-
                    Beschränkung auf Unternehmen/Markt-Paare, die sich schneller
                    bewegen als das typische Tempo für diesen Markt.
                signal_types:
                  allOf:
                    - $ref: '#/components/schemas/expansion_signal_type_slugs'
                  description: >-
                    Werte unterscheiden zwischen Groß- und Kleinschreibung und
                    werden **nicht validiert**. Ein nicht erkannter Wert wird
                    stillschweigend verworfen statt abgelehnt: Bei `stages`,
                    `freshness`, `scopes` und `momentum` wird der gesamte Filter
                    fallen gelassen, und Sie erhalten *ungefilterte* Ergebnisse,
                    während bei `signal_types` und `signal_strengths` der Filter
                    angewendet wird und *nichts* trifft. So oder so wirkt die
                    Antwort normal. Lösen Sie gültige Slugs über die
                    [Expansion-Referenz](/de/api-reference/endpoint/expansions/types)
                    auf und vergleichen Sie `data.pagination.total_entries` mit
                    einem ungefilterten Aufruf, wenn ein Ergebnis falsch
                    erscheint.
                signal_strengths:
                  allOf:
                    - $ref: '#/components/schemas/signal_strengths'
                  description: >-
                    Werte unterscheiden zwischen Groß- und Kleinschreibung und
                    werden **nicht validiert**. Ein nicht erkannter Wert wird
                    stillschweigend verworfen statt abgelehnt: Bei `stages`,
                    `freshness`, `scopes` und `momentum` wird der gesamte Filter
                    fallen gelassen, und Sie erhalten *ungefilterte* Ergebnisse,
                    während bei `signal_types` und `signal_strengths` der Filter
                    angewendet wird und *nichts* trifft. So oder so wirkt die
                    Antwort normal. Lösen Sie gültige Slugs über die
                    [Expansion-Referenz](/de/api-reference/endpoint/expansions/types)
                    auf und vergleichen Sie `data.pagination.total_entries` mit
                    einem ungefilterten Aufruf, wenn ein Ergebnis falsch
                    erscheint.
                min_signal_count:
                  type: integer
                  example: 3
                  description: >-
                    Mindestanzahl an Expansionssignalen, die ein Unternehmen im
                    Zeitraum aufweisen muss — "sehr aktiv / starke Präsenz".
                only_contraction:
                  $ref: '#/components/schemas/only_contraction'
                verticals:
                  $ref: '#/components/schemas/verticals'
                vertical_categories:
                  $ref: '#/components/schemas/vertical_categories'
                vertical_sub_categories:
                  $ref: '#/components/schemas/vertical_sub_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'
                companies:
                  $ref: '#/components/schemas/expansion_companies'
                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'
                advertisement_target_locations:
                  $ref: '#/components/schemas/advertisement_target_locations'
                advertisement_exclude_target_locations:
                  $ref: '#/components/schemas/advertisement_exclude_target_locations'
                advertisement_search_terms:
                  $ref: '#/components/schemas/advertisement_search_terms'
                advertisement_start_dates:
                  $ref: '#/components/schemas/advertisement_start_dates'
                advertisement_end_dates:
                  $ref: '#/components/schemas/advertisement_end_dates'
                news_categories:
                  $ref: '#/components/schemas/news_categories'
                news_published_dates:
                  $ref: '#/components/schemas/published_dates'
                transitioned_dates:
                  type: array
                  items:
                    type: string
                    format: date
                  example:
                    - '2026-06-01'
                    - '2026-06-29'
                  description: >-
                    ISO-Datumsbereich [Start, Ende] für das Anzeigefenster
                    (Karte, Ströme und Watchlist-Zeitleiste). Standardmäßig die
                    letzten 90 Tage. Der KPI `new_transitions_30d` verwendet
                    unabhängig von diesem Bereich immer sein eigenes festes
                    30-Tage-Fenster.
                window_days:
                  $ref: '#/components/schemas/window_days'
                min_markets:
                  type: integer
                  example: 3
                  description: >-
                    Mindestanzahl neuer Märkte, die ein Unternehmen im Zeitraum
                    betreten haben muss (breite Expandierer).
                home_country_code:
                  type: array
                  items:
                    type: string
                  example:
                    - SG
                  description: >-
                    Nach Heimatland des Unternehmens filtern (ISO 3166-1
                    Alpha-2). Überschneidet sich mit `froms`, wenn beide
                    angegeben werden.
                industries:
                  $ref: '#/components/schemas/industries'
                exclude_industries:
                  $ref: '#/components/schemas/exclude_industries'
                select_size:
                  type: integer
                  example: 250
                  description: Maximale Anzahl zurückzugebender Märkte (planbegrenzt).
                flows_size:
                  type: integer
                  example: 50
                  description: >-
                    Maximale Anzahl zurückzugebender grenzüberschreitender
                    Ströme (planbegrenzt).
                is_include_metadata:
                  allOf:
                    - $ref: '#/components/schemas/expansion_is_include_metadata'
                  description: >-
                    Gibt die vollständige Detail-Payload zurück.
                    API-Schlüssel-Traffic ist standardmäßig schlank: Der
                    `model`-Block, die Konfidenzwerte (`stage.confidence` bei
                    Company Expansion Detail, `confidence_score` bei
                    `other_markets[]` und bei Rankings `markers[]`) sowie die
                    Felder `established_min` / `share_of_detected` /
                    `has_known_office` werden alle weggelassen, sofern dies
                    nicht `true` ist.
                is_enable_similarity_search:
                  type: boolean
                  description: >-
                    Aktiviert Freitext-Matching für `verticals`,
                    `vertical_categories`, `vertical_sub_categories` und
                    `technologies`; diese Filter werden fallen gelassen, sofern
                    dies nicht `true` ist.
                  example: true
      responses:
        '200':
          description: Markt-Dashboard-Aggregate.
          content:
            application/json:
              schema:
                type: object
                properties:
                  metadata:
                    type: object
                  data:
                    type: object
                    description: >-
                      Dashboard-Container: eingestufte Märkte plus die
                      wichtigsten Korridorströme. Veraltete Legacy-Spiegelung.
                      Jeder Container innerhalb von `data` wird zur
                      Kompatibilität mit älteren Clients auch auf oberster Ebene
                      ausgegeben (`countries`, `top_flows`, `picks_aggregate`,
                      `watchlist_markets`, `watchlist_timeline`). Lesen Sie
                      diese aus `data` — die Kopien auf oberster Ebene werden
                      entfernt.
                    properties:
                      countries:
                        type: array
                        description: Eingestufte Märkte mit Signalzählungen pro Markt.
                        items:
                          type: object
                      top_flows:
                        type: array
                        items:
                          type: object
                        description: >-
                          Größte grenzüberschreitende Expansionsströme, am
                          stärksten frequentierte zuerst.
                      picks_aggregate:
                        type: array
                        description: >-
                          Aggregiertes Rollup über die durch die aktuellen
                          Filter erfassten Märkte.
                        items:
                          type: object
                      watchlist_markets:
                        type: array
                        description: >-
                          Stage-Zählungen pro Markt, beschränkt auf die in Ihrem
                          Workspace gespeicherten Unternehmen.
                        items:
                          type: object
                      watchlist_timeline:
                        type: array
                        description: >-
                          Stage-Übergangsereignisse für die in Ihrem Workspace
                          gespeicherten Unternehmen, neueste zuerst.
                        items:
                          type: object
                x-legacy-root-keys:
                  - countries
                  - top_flows
                  - picks_aggregate
                  - watchlist_markets
                  - watchlist_timeline
              example:
                metadata:
                  filters:
                    froms:
                      - CN
                    tos:
                      - GB
                  select_size: 250
                  flows_size: 50
                  transitioned_dates:
                    - '2026-06-01'
                    - '2026-06-29'
                data:
                  countries:
                    - country_code: US
                      inbound_count: 18
                      outbound_count: 5
                      total_companies_with_signals: 23
                      exploring_count: 8
                      committing_count: 10
                      expanding_count: 4
                      scaling_count: 1
                      new_transitions_30d: 3
                      pairs_ahead_of_pace_30d: 1
                      freshest_transition_at: '2026-06-27T14:32:10.000Z'
                  top_flows:
                    - home_country_code: SG
                      country_code: US
                      company_count: 5
                      new_transitions_30d: 1
        '400':
          $ref: '#/components/responses/general_error'
        '429':
          $ref: '#/components/responses/rate_limit_error'
        '500':
          $ref: '#/components/responses/server_error'
components:
  schemas:
    expansion_froms:
      type: array
      items:
        type: string
      example:
        - US
        - GB
      description: >-
        Ursprungsmärkte (ISO 3166-1 Alpha-2). Von wo aus ein Unternehmen
        expandiert – seine Heimat-/Hauptsitzländer. Allein verwenden, um
        Unternehmen zu finden, die aus diesen Märkten heraus wachsen; mit `tos`
        kombinieren für einen bestimmten Von-nach-Korridor.
    expansion_tos:
      type: array
      items:
        type: string
      example:
        - US
        - GB
      description: >-
        Zielmärkte (ISO 3166-1 Alpha-2). Wohin ein Unternehmen expandiert.
        Allein verwenden, um jedes Unternehmen zu finden, das in diese Märkte
        eintritt; mit `froms` kombinieren für einen bestimmten
        Von-nach-Korridor.
    expansion_exclude_froms:
      type: array
      items:
        type: string
      example:
        - US
        - GB
      description: Auszuschließende Ursprungsmärkte (ISO 3166-1 Alpha-2).
    expansion_exclude_tos:
      type: array
      items:
        type: string
      example:
        - US
        - GB
      description: Auszuschließende Zielmärkte (ISO 3166-1 Alpha-2).
    expansion_stages:
      type: array
      items:
        type: string
        enum:
          - exploring
          - committing
          - expanding
          - scaling
      example:
        - committing
        - expanding
      description: >-
        Filtert auf eine oder mehrere Expansionsstufen. Die Stufendefinitionen
        finden Sie in der Wissensdatenbank „Expansion Signals“.
    expansion_momentum:
      type: array
      items:
        type: string
        enum:
          - advancing
          - steady
          - pulling_back
      example:
        - advancing
        - steady
      description: >-
        Verlaufstrend, nach dem gefiltert wird. Es werden nur `advancing`,
        `steady` und `pulling_back` akzeptiert; die `directions`-Werte in
        [Expansion Reference](/de/api-reference/endpoint/expansions/types)
        gelten nur für die Antwortseite.
    expansion_freshness:
      type: array
      items:
        type: string
        enum:
          - fresh
          - cooling
          - stale
          - cold
      example:
        - fresh
        - cooling
      description: >-
        Filtert nach Aktualität der Belege: fresh (~30 Tage), cooling (~30–60
        Tage), stale (~60–90 Tage), cold (>90 Tage).
    expansion_scopes:
      type: array
      items:
        type: string
        enum:
          - entering_new_market
          - expanding_within_presence
          - established_only
      example:
        - entering_new_market
      description: Filtert nach Umfang des Markteintritts.
    expansion_signal_type_slugs:
      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:
        - EXEC
        - HIRE
      description: >-
        Filtert auf bestimmte Signaltypen. Definitionen und Stufen finden Sie im
        Katalog „Signal Types“ in der Wissensdatenbank (`DNS` und `INFRA` sind
        Signale der Premier-Stufe).
    signal_strengths:
      type: array
      items:
        type: string
        enum:
          - low
          - medium
          - high
          - very_high
      example:
        - high
      description: >-
        Filtert nach Vertrauensstufe der Belege: `low`, `medium` oder `high`.
        Beachten Sie, dass dies sich vom signalspezifischen
        `signal_strength_slug` unterscheidet, der bei Signaldatensätzen
        zurückgegeben wird (Bereich `low` bis `very_high`); jeder andere Wert
        liefert hier keine Treffer.
    only_contraction:
      type: boolean
      example: false
      description: >-
        Bei `true` werden nur als Kontraktion gekennzeichnete Expansionen
        zurückgegeben (Unternehmen, die sich zurückziehen).
    verticals:
      type: array
      items:
        type: integer
      description: >-
        Eine Liste von `vertical_id`, mit der nach Unternehmen in einer
        bestimmten Branche oder einem bestimmten Vertical gesucht wird. Die ID
        finden Sie über den Endpunkt `vertical` im Filters-Tab.


        Dieser Filter unterstützt `is_enable_similarity_search`; nach
        Aktivierung können Sie beliebigen Freitext eingeben, z. B. `["AI"]`.
    vertical_categories:
      type: array
      items:
        type: integer
      description: >-
        Eine Liste von `vertical_category_id`, mit der nach Unternehmen in einer
        bestimmten Vertical-Kategorie gesucht wird. Die ID finden Sie über den
        Endpunkt `vertical category` im Filters-Tab.


        Dieser Filter unterstützt `is_enable_similarity_search`; nach
        Aktivierung können Sie beliebigen Freitext eingeben, z. B.
        `["Information Technology"]`.
    vertical_sub_categories:
      type: array
      items:
        type: integer
      description: >-
        Eine Liste von `vertical_sub_category_id`, mit der nach Unternehmen in
        einer bestimmten Vertical-Unterkategorie gesucht wird. Die ID finden Sie
        über den Endpunkt `vertical sub category` im Filters-Tab.


        Dieser Filter unterstützt `is_enable_similarity_search`; nach
        Aktivierung können Sie beliebigen Freitext eingeben, z. B.
        `["Software"]`.
    technologies:
      type: array
      items:
        type: integer
      description: >-
        Eine Liste von `tag_id`, mit der nach bestimmten von Unternehmen
        eingesetzten Technologien gesucht wird. Die ID finden Sie über den
        Endpunkt `technology` im Filters-Tab.


        Dieser Filter unterstützt `is_enable_similarity_search`; nach
        Aktivierung können Sie beliebigen Freitext eingeben, z. B.
        `["Shopify"]`.
    employees:
      type: array
      items:
        type: array
        items:
          type: string
      example:
        - - 1
          - 10
        - - 11
          - 20
        - - 10001
      description: >-
        Der Zahlenbereich der für das Unternehmen tätigen Mitarbeiter. Damit
        können Sie Unternehmen anhand der Mitarbeiterzahl finden. Sie können
        mehrere Bereiche hinzufügen, um Ihre Suchergebnisse zu erweitern.

         Weitere Informationen finden Sie über die Endpunkte `company size` im Filters-Tab.
    revenues:
      type: array
      items:
        type: integer
      example:
        - 0
        - 100000
      description: Minimal- und Maximalbereich des Unternehmensumsatzes.
    founded_dates:
      type: array
      items:
        type: integer
      example:
        - 2018
        - 2024
      description: >-
        Zeitraum der Unternehmensgründung in Jahren. Der maximale Gründungswert
        ist das aktuelle Jahr.
    keywords:
      type: array
      items:
        type: string
      example:
        - ecommerce
        - ai
        - fintech
      description: >-
        Eine Liste von Stichwörtern, mit der Unternehmen nach Relevanz,
        Spezialisierung oder Beschreibung gefiltert werden.
    expansion_companies:
      type: array
      items:
        type: string
      example:
        - stripe.com
        - https://www.linkedin.com/company/airbnb
        - b7d92a56-31f8-4c0b-ae43-19c8e5f24b70
      description: >-
        Beschränkt auf bestimmte Unternehmen durch eine beliebige Kombination
        aus `domain_search_id`, Unternehmensdomain oder einer URL zum
        Social-Media-Profil eines Unternehmens. Domains und URLs werden auf das
        bestplatzierte Unternehmen aufgelöst.
    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.
    job_exclude_locations:
      allOf:
        - $ref: '#/components/schemas/exclude_locations'
      description: >-
        Geografische Standorte, die von den Stellenanzeigen-Ergebnissen
        ausgeschlossen werden.
    posted_dates:
      type: array
      items:
        type: string
      example:
        - '2025-01-01'
        - '2025-01-10'
      description: >-
        Datumsbereich des Veröffentlichungsdatums. Der Maximalwert ist der
        aktuelle Tag. Tagesgrenzen richten sich nach der Zeitzone Ihres
        Workspace.
    people_titles:
      type: array
      items:
        type: string
      example:
        - sales manager
        - marketing manager
      description: |-
        Berufsbezeichnungen der Personen, die Sie finden möchten.

         Die Ergebnisse umfassen auch Berufsbezeichnungen mit ähnlicher Terminologie, selbst wenn diese nicht exakt übereinstimmen. Eine Suche nach `software engineer` kann beispielsweise Ergebnisse für Personen mit der Bezeichnung `senior software engineer` liefern.
    advertisement_target_locations:
      allOf:
        - $ref: '#/components/schemas/target_locations'
      description: Geografische Zielstandorte für Anzeigen.
    advertisement_exclude_target_locations:
      allOf:
        - $ref: '#/components/schemas/exclude_target_locations'
      description: >-
        Geografische Standorte, die vom Anzeigen-Targeting ausgeschlossen
        werden.
    advertisement_search_terms:
      type: array
      items:
        type: string
      example:
        - asus
      description: Stichwörter zur Suche innerhalb von Anzeigeninhalten oder -titeln.
    advertisement_start_dates:
      type: array
      items:
        type: string
        format: date
      example:
        - '2025-12-25'
        - '2025-12-25'
      description: Startdatumsbereich für die Anzeigenfilterung.
    advertisement_end_dates:
      type: array
      items:
        type: string
        format: date
      example:
        - '2025-12-25'
        - '2025-12-25'
      description: Enddatumsbereich für die Anzeigenfilterung.
    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.
    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.
    window_days:
      type: integer
      example: 90
      description: >-
        Optional. Größe des gleitenden Fensters in Tagen. Wird verwendet, wenn
        kein expliziter `transitioned_dates`-Bereich angegeben wird; werden
        beide weggelassen, wird ein Standardfenster verwendet.
    industries:
      type: array
      items:
        type: string
      example:
        - software
        - financial services
      description: Filtert nach Branchenname (Freitext-Abgleich).
    exclude_industries:
      type: array
      items:
        type: string
      example:
        - tobacco
      description: Auszuschließende Branchen (Freitext-Abgleich).
    expansion_is_include_metadata:
      type: boolean
      example: true
      description: >-
        Antworten über API-Key sind standardmäßig schlank. Setzen Sie true, um
        den vollständigen `metadata`-Block (Aggregate, Top-Ursprünge/-Ziele,
        Top-Branchen, Zeitachse) sowie unternehmensbezogene Modelldetails
        einzuschließen.
    exclude_locations:
      type: array
      items:
        type: string
      example:
        - CN
        - US
        - RU
        - CA
      description: >-
        ISO 3166-1 Alpha-2 (cca2) wird verwendet, um Standorte auszuschließen,
        die nicht zurückgegeben werden sollen. Weitere Informationen finden Sie
        über die Endpunkte `location` im Filters-Tab.
    target_locations:
      type: array
      items:
        type: string
      example:
        - TW
        - AE
        - 'NO'
      description: >-
        Filtert Anzeigen, um solche einzuschließen, die auf bestimmte Standorte
        anhand des Ländercodes abzielen. Damit finden Sie Anzeigen, die in
        bestimmten Ländern geschaltet werden. Wird mit `filter_conditions` über
        den OR-Operator kombiniert – die Anzeige muss auf mindestens einen der
        angegebenen Standorte abzielen.
    exclude_target_locations:
      type: array
      items:
        type: string
      example:
        - IS
        - GB
        - FR
        - IE
        - ES
      description: >-
        Filtert Anzeigen, um solche auszuschließen, die auf bestimmte Standorte
        anhand des Ländercodes abzielen. Damit blenden Sie Anzeigen aus, die in
        bestimmten Ländern geschaltet werden. Wird in `filter_conditions` mit
        dem Operator „or“ angegeben, darf die Anzeige auf keinen der
        ausgeschlossenen Standorte abzielen.
  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

````