> ## 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-Rankings > Leichtgewichtige, nach Expansionswert gerankte Liste von Unternehmen/Markt-Paaren – geeignet für die Darstellung als Karte oder Heatmap. ## OpenAPI ````yaml de-openapi POST /expansions/companies/rankings 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/companies/rankings: post: tags: - Expansion summary: Expansions-Rankings description: >- Leichtgewichtige, nach Expansionswert gerankte Liste von Unternehmen/Markt-Paaren – geeignet für die Darstellung als Karte oder Heatmap. operationId: expansions_company_rankings 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. 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' domain_search_ids: allOf: - $ref: '#/components/schemas/expansion_domain_search_ids' description: >- Unternehmen, auf die eingeschränkt werden soll, nach `domain_search_id`. 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' is_include_established: $ref: '#/components/schemas/expansion_is_include_established' select_size: $ref: '#/components/schemas/expansion_select_size' is_include_metadata: type: boolean 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. example: true 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: Gerankte Unternehmen/Markt-Marker. content: application/json: schema: type: object properties: metadata: type: object data: type: object description: Ergebnis-Container. properties: markers: type: array description: >- Eine Zeile pro Unternehmen/Markt-Paar, gerankt nach Expansionswert. items: type: object properties: domain_search_id: type: string description: Pubrio-Unternehmenskennung. country_code: type: string description: Zielmarkt, ISO 3166-1 Alpha-2. stage_slug: type: string description: Aktuelle Expansionsstufe. expansion_score: type: integer description: >- Expansionswert für dieses Unternehmen/Markt-Paar. freshness: type: string description: Wie aktuell die zugrunde liegenden Signale sind. direction: type: string description: Verlaufstrend der Stufe. example: metadata: filters: froms: - CN tos: - GB select_size: 250 count: 1 data: markers: - domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US stage_slug: expanding expansion_score: 0.721 freshness: fresh direction: advancing '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_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). expansion_domain_search_ids: type: array items: type: string example: - 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c description: Einzuschließende Unternehmenskennungen (domain_search_id UUIDs). 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. expansion_is_include_established: type: boolean example: false description: >- Schließt die Stufe `established` ein (langjährige Anbieter ohne aktive Expansionssignale). Standardmäßig false. expansion_select_size: type: integer example: 50 description: Maximale Anzahl zurückzugebender Datensätze. Durch Ihren Tarif begrenzt. 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 ````