> ## 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. # Details zur Unternehmenserweiterung > Detailliertes Expansionsprofil für ein einzelnes Unternehmen — aktuelle Stage, Signale, Marktpräsenz und Stage-Übergangsverlauf — für einen Markt oder aggregiert über alle Märkte. ## OpenAPI ````yaml de-openapi POST /expansions/companies/lookup 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/lookup: post: tags: - Expansion summary: Unternehmensexpansionsdetail description: >- Detailliertes Expansionsprofil für ein einzelnes Unternehmen — aktuelle Stage, Signale, Marktpräsenz und Stage-Übergangsverlauf — für einen Markt oder aggregiert über alle Märkte. operationId: expansions_company_lookup requestBody: required: true content: application/json: schema: type: object properties: country_code: $ref: '#/components/schemas/expansion_country_code' is_all_markets: $ref: '#/components/schemas/expansion_is_all_markets' signal_type: type: string enum: - AD - AUDIENCE - DNS - ENTITY - EVENT - EVENT_PLUS - EXEC - HIRE - INFRA - IP - NEWS - OFFICE - PARTNER - PRODUCT - REG - SCALE - TECH example: EXEC description: >- Beschränkt die zurückgegebenen Signale auf einen einzelnen Typ. query: type: string example: >- We sell Employer-of-Record and local payroll; best-fit buyers hire in a new market before setting up a legal entity. description: >- Beschreibung in natürlicher Sprache dessen, was Sie verkaufen, oder des Käuferprofils, gegen das Sie dieses Unternehmen bewerten. Wird nur verwendet, um die KI-`summary` zu fundieren (siehe `is_explain_match`); anders als bei der Unternehmenssuche wird sie hier NICHT in Filter interpretiert. is_explain_match: type: boolean example: true description: >- Wenn true und eine `query` angegeben wird, gibt `summary` eine einzelne KI-Zusammenfassung der Expansionsaktivität dieses Unternehmens im aktuellen Umfang zurück (der ausgewählte Markt oder alle ausländischen Märkte, wenn `is_all_markets` true ist), gelesen im Abgleich mit Ihrer `query` und fundiert auf den tatsächlichen Signalen des Unternehmens mit `[n]`-Zitaten. window_days: type: integer example: 90 default: 90 description: >- Optional. Gleitendes Fenster (in Tagen), das den KI-`summary`-Feed begrenzt. Standardmäßig **90**, wenn weder dies noch `transitioned_dates` angegeben wird. Beeinflusst nicht die paginierte `signals`-Liste (vollständiger Verlauf). transitioned_dates: type: array items: type: string format: date example: - '2026-04-01' - '2026-06-29' description: >- ISO-`[from, to]`-Datumsbereich für das Signal-/Übergangsfenster. Hat Vorrang vor `window_days`, wenn beide angegeben werden. domain: $ref: '#/components/schemas/domain' linkedin_url: $ref: '#/components/schemas/company_linkedin_url' domain_search_id: $ref: '#/components/schemas/domain_search_id' is_include_established: $ref: '#/components/schemas/expansion_is_include_established' page: $ref: '#/components/schemas/page' per_page: $ref: '#/components/schemas/per_page' 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 summary_only: type: boolean description: >- Gibt nur den Stage-Zusammenfassungsblock zurück (`data`, `company`, `markets_summary`, `signal_weekly_totals`, `recent_signals`, `expansion_score`, `summary`) und überspringt die Signalliste und deren Aggregate. Deutlich günstiger für Hero-/Header-Ansichten. example: true markets_summary_full: type: boolean description: >- Bezieht die vollständige eingestufte Marktmenge als `markets_summary` neben der begrenzten `other_markets`-Liste ein. example: true anyOf: - title: Domain Search ID required: - domain_search_id - title: Domain required: - domain - title: LinkedIn URL required: - linkedin_url responses: '200': description: Detail zu Unternehmen im Markt. content: application/json: schema: type: object properties: metadata: type: object data: type: object description: Ergebnis-Container. properties: domain_search_id: type: string description: Pubrio-Unternehmenskennung. country_code: type: string description: Zielmarkt, ISO 3166-1 Alpha-2. country_name: type: string description: Name des Zielmarkts. stage_rank: type: integer description: >- Numerischer Rang der Stage, höher bedeutet weiter fortgeschritten. stage_name: type: string description: Anzeigename der Stage. stage: type: object description: >- Stage-Detail — Score, Umfang, Richtung, Aktualität und Signalzählungen. local_people_count: type: integer description: Im Zielmarkt ansässige Mitarbeiter. local_people_coverage: type: boolean description: >- Ob die Mitarbeiterzahl-Abdeckung ausreicht, um der Zählung zu vertrauen. presence: type: object description: >- Präsenz im Markt: wie etabliert das Unternehmen bereits ist, unabhängig von seiner Expansions-Stage. properties: level: type: string enum: - established - emerging - none - no_data description: >- Wie etabliert die Präsenz des Unternehmens in diesem Markt ist: `established`, `emerging`, `none` oder `no_data`. Dies ist die Präsenz, nicht die Expansions-Stage. local_people_count: type: integer description: Im Zielmarkt ansässige Mitarbeiter. matched_rule: type: string nullable: true description: >- Welches Signal die Stufe begründet hat — zum Beispiel `office`, `headcount` oder `share`. `null`, wenn keine Regel zutraf. read: type: object description: Lesestatus für diesen Datensatz. signals: type: array description: >- Die paginierten Signalzeilen hinter diesem Unternehmen/Markt-Paar — die Evidenzliste. Seitengröße und Gesamtwerte stammen aus `metadata.pagination`. items: type: object summary: type: object description: >- Einzeilige Stage-Zusammenfassung für das Paar. Nur auf der ersten Seite. company: type: object description: >- Unternehmens-Chrome — Name, Domain, Logo und Social-URLs. Nur auf der ersten Seite. signal_group_totals: type: array description: >- Signalzählungen pro Typ, gruppiert nach Tag in Ihrer Zeitzone. Nur auf der ersten Seite. items: type: object signal_type_totals: type: array description: >- Signalgesamtwerte aller Zeiten pro Signaltyp. Nur auf der ersten Seite. items: type: object signal_type_recent_totals: type: array description: >- Signalgesamtwerte pro Typ über die letzten 12 Wochen. Nur auf der ersten Seite. items: type: object signal_weekly_totals: type: array description: >- Wöchentliche Signalzählungen für die Heatmap, derselbe Zeitraum wie `signal_type_recent_totals`. Nur auf der ersten Seite. items: type: object evidence_breakdown: type: object description: >- Evidenz-Rollup nach Quelltyp, berechnet aus den zurückgegebenen (redigierten) Signalen. Nur auf der ersten Seite. presence: type: object description: >- Beobachtete physische und digitale Präsenz des Unternehmens in diesem Markt. Nur auf der ersten Seite. suppressions: type: array description: >- Signale, die von der Stufenberechnung ausgeschlossen wurden, jeweils mit Begründung. Nur erste Seite. items: type: object timeline: type: array description: >- Verlauf der Stufenübergänge für dieses Unternehmen/Markt-Paar. Nur erste Seite. items: type: object other_markets: type: array description: >- Die weiteren aktiven Märkte des Unternehmens. Bei eingeschränkten Tarifen begrenzt – siehe `other_markets_locked_count`. Nur erste Seite. items: type: object other_markets_locked_count: type: integer description: >- Wie viele zusätzliche Märkte Ihr Tarif nicht in `other_markets` zurückgegeben hat. `0`, wenn nichts zurückgehalten wurde. markets_summary: type: array description: >- Vollständige, gerankte Marktmenge für dieses Unternehmen. Wird nur zurückgegeben, wenn `markets_summary_full` den Wert `true` hat, auf der ersten Seite. items: type: object example: metadata: filters: domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US country_code_auto_picked: false pagination: page: 1 per_page: 25 total_entries: 12 total_pages: 1 total_display_pages: 1 is_timeout: false data: domain_search_id: 8f3c1b04-2e7a-4d19-9c55-6ab21f0e7d3c country_code: US country_name: United States stage_rank: 3 stage_name: Expanding stage: slug: expanding expansion_score: 0.721 scope: entering_new_market direction: advancing freshness: fresh contraction_flag: null mode_change_flag: false signal_count: 5 distinct_type_count: 3 has_known_presence: false first_signal_at: '2026-05-30T09:00:00.000Z' latest_signal_at: '2026-06-20T14:00:00.000Z' last_transition_at: '2026-06-15T09:30:00.000Z' signals: - signal_type_slug: EXEC signal_subtype_slug: country_manager signal_strength_slug: high polarity: expansion event_date: '2026-06-20T14:00:00.000Z' source_type: linkedin display_label: Hired Regional VP for North America evidence_url: https://linkedin.com/company/example-corp source_published_at: '2026-06-20T14:00:00.000Z' lead_time_days: 0 presence: - presence_type: office presence_strength: high address: 123 Market St, San Francisco, CA known_since: '2026-03-15T00:00:00.000Z' timeline: - stage_slug: expanding transitioned_at: '2026-06-15T09:30:00.000Z' transition_kind: advance other_markets: - country_code: CA stage_slug: committing signal_count: 8 first_signal_at: '2026-04-10T00:00:00.000Z' latest_signal_at: '2026-06-22T16:45:00.000Z' last_transition_at: '2026-06-18T00:00:00.000Z' '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: schemas: expansion_country_code: type: string example: US description: >- Zielmarkt als ISO-3166-1-Alpha-2-(cca2)-Ländercode. Weglassen, damit automatisch der aktivste Markt des Unternehmens ausgewählt wird; setzen Sie `is_all_markets` für eine marktübergreifende Ansicht aller Märkte. expansion_is_all_markets: type: boolean example: false description: >- Gibt den gesamten Expansions-Footprint des Unternehmens über ALLE Märkte in einem Aufruf zurück, statt für einen einzelnen Markt. Bei `true` wird `country_code` ignoriert, der Heimatmarkt wird aus den Signal-Aggregaten ausgeschlossen, sofern er identifizierbar ist, `data` wird zu einer unternehmensweiten Zusammenfassung (dominante Stufe, Gesamtsignale, Zeitspanne, höchster Expansionswert), und `markets_summary` listet jeden Markt auf. Standardmäßig false. domain: type: string example: pubrio.com description: >- Eine Unternehmensdomain für Unternehmenssuchvorgä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_url: 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/` domain_search_id: type: string format: uuid description: Eine eindeutige Kennung für den Unternehmenssuchvorgang. expansion_is_include_established: type: boolean example: false description: >- Schließt die Stufe `established` ein (langjährige Anbieter ohne aktive Expansionssignale). Standardmäßig false. 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. 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 ````