> ## 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-Suche > Findet Unternehmen, die mithilfe firmografischer und Signalfilter oder einer Anfrage in natürlicher Sprache in einen oder mehrere Märkte expandieren, mit optionalen KI-Trefferbegründungen, die auf den tatsächlichen Signalen jedes Unternehmens beruhen. ## OpenAPI ````yaml de-openapi POST /expansions/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: /expansions/search: post: tags: - Expansion summary: Expansions-Suche description: >- Findet Unternehmen, die mithilfe firmografischer und Signalfilter oder einer Anfrage in natürlicher Sprache in einen oder mehrere Märkte expandieren, mit optionalen KI-Trefferbegründungen, die auf den tatsächlichen Signalen jedes Unternehmens beruhen. operationId: expansions_search 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 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' min_markets: type: integer example: 3 description: >- Mindestanzahl neuer Märkte, die ein Unternehmen im Zeitraum betreten haben muss. 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' 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-04-01' - '2026-06-29' description: >- ISO-Datumsbereich für das Zeitleistenfenster. Standardmäßig die letzten 90 Tage. Eine `query` in natürlicher Sprache kann dies auch über Kalenderausdrücke setzen ("this year", "last year", "Q2 2026"). window_days: $ref: '#/components/schemas/window_days' query: type: string example: fintech companies expanding into the UK description: >- Anfrage in natürlicher Sprache, die Pubrio in Expansions- und Unternehmensfilter interpretiert. is_explain_match: type: boolean example: true description: >- Bezieht KI-generierte Begründungen ein, warum jedes Unternehmen der Suche entspricht, basierend auf den tatsächlichen Signalen des Unternehmens. Am besten kombiniert mit einer Anfrage in natürlicher Sprache. Sowohl die Anzahl der zitierten Signale als auch die Batch-Größe skalieren mit `per_page`; Quellen mit hohem Volumen (Stellenausschreibungen, Werbekampagnen) werden als zeitraumbezogene Zählung zusammengefasst (z. B. "12 job postings") statt einzeln aufgelistet. sort_by: $ref: '#/components/schemas/expansion_sort_by' 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. page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' 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 anyOf: - title: From Markets required: - froms - title: To Markets required: - tos - title: Plain-language Query required: - query - title: Companies required: - companies responses: '200': description: >- Paginierte Liste von Unternehmen, die in den Markt/die Märkte expandieren. `filters` gibt die angewendeten (oder aus natürlicher Sprache interpretierten) Kriterien wieder; jedes Unternehmen enthält eine `match_summary`, wenn `is_explain_match` true ist. content: application/json: schema: type: object properties: metadata: type: object description: >- Such-Metadaten: die tatsächlich angewendeten Filter sowie das Markt-Rollup (Aggregat, geografischer Umfang, wichtigste Herkunfts-/Ziel-/Branchen, Zeitleiste). API-Schlüssel-Antworten enthalten das Rollup nur, wenn `is_include_metadata` true ist. properties: filters: type: object description: >- Tatsächlich angewendete Filter (gibt eine interpretierte Anfrage in natürlicher Sprache wieder, wenn `query` verwendet wurde). relaxed_filters: type: array description: >- Soft-Filter, die automatisch fallen gelassen werden, wenn eine Anfrage in natürlicher Sprache nichts traf; andernfalls null. items: type: string nl_note: type: string description: >- Menschenlesbarer Hinweis, wenn eine Anfrage in natürlicher Sprache keine erkennbaren Kriterien ausdrückte; die Liste ist in diesem Fall leer. nl_note_code: type: string description: >- Maschinenlesbarer Code für nl_note (z. B. expansion.search.no_criteria). aggregate: type: object description: >- Rollup auf Marktebene. Vorhanden, wenn Metadaten angefordert werden. country_code: type: string country_codes: type: array items: type: string direction: type: string is_global: type: boolean is_multi: type: boolean transitioned_dates: type: array items: type: string top_origins: type: array items: type: object top_destinations: type: array items: type: object top_industries: type: array items: type: object timeline: type: array items: type: object data: type: object description: >- Ergebnis-Container (Standard-Suchumschlag): die Unternehmensliste plus Paginierung. properties: pagination: type: object description: >- Seite, Einträge pro Seite, Gesamteinträge und Gesamtseiten. companies: type: array description: >- Die Unternehmensliste. Jedes Element enthält eine verschachtelte `stage`; `match_summary` ist enthalten, wenn `is_explain_match` true ist. API-Schlüssel-Antworten enthalten außerdem `presence` (`level`: established | emerging | none | no_data; `matched_rule`: office | headcount | share) und ein `read`-Objekt, dessen `code` scaling | deepening | active | establishing ist (null, wenn keine lokale Präsenz zum Auslesen vorhanden ist). items: type: object example: metadata: filters: tos: - GB verticals: - Financial Services data: pagination: page: 1 per_page: 25 total_entries: 87 total_pages: 4 total_display_pages: 4 is_timeout: false companies: - expansion_id: '6845525' domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: GB target_country_code: GB domain: example.com company_name: Example Corp home_country_code: CN industry: Consumer Electronics founded_year: 2015 employees_count: 320 stage: slug: expanding expansion_score: 0.72 scope: entering_new_market direction: advancing freshness: fresh signal_count: 27 distinct_type_count: 3 last_transition_at: '2026-06-27T14:32:10.000Z' presence: level: established local_people_count: 12 matched_rule: headcount has_known_office: true established_min: 10 share_of_detected: 0.54 read: code: establishing '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). 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). 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. expansion_sort_by: type: string enum: - recent - expansion_score - signal_count - company_ranking example: expansion_score description: >- Sortierung der Ergebnisse. Weglassen für die Standard-Relevanzreihenfolge: bestätigte Paare zuerst (2 oder mehr unterschiedliche Signaltypen), dann Paare mit wiederholten Belegen (3 oder mehr Signale), dann der Rest – innerhalb jeder Stufe zuletzt übergegangen zuerst. `recent` – reine Aktualität (zuletzt übergegangen zuerst). `expansion_score` – höchster Expansionswert zuerst. `signal_count` – meiste Signale im Paar zuerst. `company_ranking` – Pubrios Gesamt-Unternehmensranking (niedriger bedeutet prominenter), aufsteigend. 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. 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. 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. 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 ````