Company

Ein Company-Objekt beschreibt ein Unternehmen, das Ihre Website im angefragten Zeitraum mindestens einmal besucht hat. Ein Beispiel: Die Bergquell Mineralbrunnen GmbH liest mehrmals Ihre Preisseite, und GET /company liefert ihre Anschrift, ihre Größe, ihre NACE-Codes und ihre Aktivität.

Das Objekt enthält Daten über das Unternehmen, keine Besuche und keine Personen. Besuche stehen im Objekt Session, Ansprechpartner im Objekt Contact. Das Datenmodell zeigt, wie die Objekte zusammenhängen.

RegelnCopy Anchor Link

• Ein Eintrag pro Unternehmen: GET /company liefert jedes Unternehmen, das im Zeitraum von from_date bis to_date mindestens einen Besuch auf der angefragten Website hatte. Die Reihenfolge der Einträge ist nicht festgelegt.
• Fehlende Werte: Wenn Webmetic einen Wert nicht kennt, fehlt das Feld. Es steht dann nicht als null im Objekt. Die Ausnahme ist fit_score, das ohne Zielkundenprofil null ist. Die Feeds liefern unbekannte Werte dagegen als null, wie unter Fehlende Felder und null beschrieben.
• Kennung: company_id bleibt für ein Unternehmen gleich. Speichern Sie zusätzlich company_url als zweiten Schlüssel, wenn Sie Unternehmen dauerhaft in Ihrem CRM führen.
• Scores ohne Zeitraum: Der angefragte Zeitraum ändert die Scores nicht. Die Aktivität zählt alle Besuche des Unternehmens auf dieser Website.
• Aktualität: Bei späteren Besuchen frischt Webmetic Name, Anschrift und Branchencodes auf. Webmetic berechnet die Scores bei jedem Besuch und zusätzlich regelmäßig neu.
• Mehrere Websites: GET /company nimmt domain mehrmals an, zum Beispiel ?domain=a.de&domain=b.de. Jedes Unternehmen erscheint dann nur einmal, mit den Scores der ersten angegebenen Website, die es besucht hat.
• Ausschlüsse: Für Unternehmen, deren Domain auf der Domain-Blacklist steht, und für Organisationstypen, die Sie unter Menü > Organisationstypen ausschalten, nimmt Webmetic keine neuen Besuche auf. Frühere Besuche bleiben in der API. Ihr eigenes Unternehmen fehlt in den Daten Ihrer eigenen Website.
• Kosten: Das Abrufen kostet keine Credits und funktioniert in jedem Plan, auch im Free-Plan.

FelderCopy Anchor Link

Die Tabelle nennt die Felder des Objekts.

Webmetic schreibt die Texte in short_description_*, full_description_*, what_they_do_*, how_they_make_money_* und target_audience_* anhand der Website des Unternehmens.

Neue Felder können jederzeit hinzukommen. Ihr Code sollte deshalb unbekannte Felder ignorieren.

SpannenCopy Anchor Link

employee_count und revenue sind Spannen aus zwei Zahlen [min, max], keine genauen Zahlen. Wenn Webmetic die Größe nicht kennt, fehlt das Feld.

• Mitarbeitende: [1, 10], [11, 50], [51, 200], [201, 500], [501, 1000], [1001, 5000], [5001, 10000] und [10001, null] ohne Obergrenze.
• Umsatz: Spannen in Euro von [0, 100000] bis [100000000, 500000000] und [500000000, null] ohne Obergrenze.

ScoresCopy Anchor Link

Die drei Scores gehen von 0 bis 100. Das Dashboard zeigt sie unter anderen Namen:

Wenn der letzte Besuch länger zurückliegt, sinkt die Aktivität auch ohne neuen Besuch.

fit_score ist null, solange die Website kein Zielkundenprofil hat. Dann ist relevance_score gleich lead_score.

Im Beispiel unten ergeben fit_score 92 und lead_score 88 eine Relevanz von 80,96. Wie Webmetic die Werte berechnet, steht unter Relevanz, Aktivität und Zielkunde.

NACE-CodesCopy Anchor Link

nace_codes enthält eine bis drei Klassen der europäischen Wirtschaftszweige nach NACE Rev. 2.1 (Ausgabe 2025). Webmetic ordnet die Codes anhand der Website des Unternehmens zu.

Die erste Klasse ist die Haupttätigkeit. Die API hat dafür kein eigenes Feld, denn die Reihenfolge trägt diese Information. Wenn ein Unternehmen keinen Code hat, fehlt nace_codes.

Jeder Eintrag hat zehn Felder:

wz2025_codes hat denselben Aufbau für die deutsche Klassifikation WZ 2025, mit Codes wie "11.07.0". Webmetic nimmt alle WZ-Unterklassen der gewählten NACE-Klassen auf, sodass ein Unternehmen viele davon haben kann.

Die Reihenfolge der WZ-Einträge zeigt keine Haupttätigkeit. In WZ-Einträgen steht section_description_de in Großbuchstaben, zum Beispiel "VERARBEITENDES GEWERBE".

GET /company_nace liefert die NACE-Codes als flache Tabelle: eine Zeile je Code mit company_id und den zehn Feldern. Weil die Zeilen keinen company_name haben, holen Sie den Namen über company_id aus /company.

Unternehmen ohne NACE-Code haben keine Zeile. Der Endpunkt nimmt eine einzige domain an, und Paginierung zählt dort NACE-Zeilen, keine Unternehmen.

Felder je EndpunktCopy Anchor Link

/company-sessions liefert das Company-Objekt mit eingebetteten Besuchen: sessions[] enthält die Sessions Ihres Kontos im Zeitraum, beschrieben unter Session. Jede Session enthält ihre Seitenaufrufe in user_data[], beschrieben unter Page View.

Die drei Feeds /intensive-visits, /returning-visits und /new-visits setzen zusätzlich Felder der frühesten Session sowie sessions_total und pages_total an die oberste Ebene. Besuchsarten beschreibt, welche Unternehmen die Feeds liefern.

BeispielCopy Anchor Link

Das Beispiel zeigt einen Eintrag aus result von GET /company mit gekürzten Texten:

{
  "company_id": "41ea486a9c95",
  "company_name": "Bergquell Mineralbrunnen GmbH",
  "company_url": "www.bergquell.example",
  "company_logo_url": "https://logos.docs.example/bergquell.png",
  "organization_type": "business",
  "address": "Brunnenweg 4",
  "postal_code": "85354",
  "city": "Freising",
  "country": "Deutschland",
  "country_code": "DE",
  "directors": ["Florian Obermaier"],
  "phone_number": "+49 89 99998214",
  "email_address": "info@bergquell.example",
  "employee_count": [201, 500],
  "revenue": [50000000, 100000000],
  "vat_id": "DE000000000",
  "registration_number": "HRB 000000",
  "registration_court": "Amtsgericht München",
  "primary_color": "#1f6feb",
  "lead_score": 88.0,
  "fit_score": 92,
  "relevance_score": 80.96,
  "linkedin": "https://www.linkedin.com/company/bergquell-mineralbrunnen-example",
  "short_description_de": "Mineralbrunnen mit eigener Abfüllung für Mineralwasser und Erfrischungsgetränke.",
  "short_description_en": "Mineral spring with its own bottling of mineral water and soft drinks.",
  "nace_codes": [
    {
      "code": "11.07",
      "full_code": "C 11.07",
      "section_code": "C",
      "section_description_de": "Verarbeitendes Gewerbe/Herstellung von Waren",
      "section_description_en": "Manufacturing",
      "division_code": "C11",
      "division_description_de": "Getränkeherstellung",
      "division_description_en": "Manufacture of beverages",
      "description_de": "Herstellung von Erfrischungsgetränken und Mineralwässern",
      "description_en": "Manufacture of soft drinks and bottled waters"
    }
  ]
}

Im Beispiel fehlen fax_number, tax_number und secondary_color, weil Webmetic diese Werte für Bergquell nicht kennt. Das Beispiel lässt außerdem die langen Texte und wz2025_codes weg.

SonderfälleCopy Anchor Link

Fehlende Felder und nullCopy Anchor Link

Die drei Feeds liefern jedes ihrer Felder, unbekannte Werte als null und leere Listen als [].

In Webhooks kann ein Feld auch null sein, wenn Webmetic die Zustellung gekürzt hat. Dann ist data.truncated true, wie unter Webhooks beschrieben. Prüfen Sie in Ihrem Code also immer beide Fälle: Feld fehlt und Feld ist null.

Verborgene Unternehmen im Free-PlanCopy Anchor Link

Im Free-Plan sehen Sie nur einen Teil der Unternehmen. Die API liefert die übrigen als verborgene Einträge mit company_id, einem Platzhalter wie „Verborgenes Unternehmen“ in company_name und "blurred": true.

• /company: Alle anderen Felder fehlen.
• /company-sessions: Die Sessions eines verborgenen Unternehmens enthalten nur session_id und timestamp.
• Feeds: Jedes Feld außer company_id, company_name und blurred ist null. sessions bleibt eine Liste, und jede Session behält alle Felder. Nur session_id und timestamp haben einen Wert, die übrigen Felder sind null und user_data ist leer.
• /company_nace und Webhooks: Verborgene Unternehmen fehlen ganz.
• Ansprechpartner: /contacts/search, /contacts/lookup und /contacts/find antworten für verborgene Unternehmen mit 403 und PLAN_REQUIRED.

Sichtbare Unternehmen haben kein Feld blurred. Filtern Sie verborgene Einträge über blurred heraus, bevor Sie Daten weiterverarbeiten. Welche Unternehmen Sie sehen, steht unter Pläne.

Domain gehört nicht zu Ihrem KontoCopy Anchor Link

Wenn die angefragte domain nicht zu Ihrem Konto gehört, antwortet die API mit 403 und API_KEY_NOT_AUTHORIZED. Das gilt auch für eine Variante mit www.. Geben Sie die Domain genau so an, wie sie im Dashboard steht. Mehr dazu unter Fehler.

Kein Abruf einzelner UnternehmenCopy Anchor Link

Die API hat keinen Endpunkt, der ein einzelnes Unternehmen per company_id liefert. Die API filtert auch nicht nach Branche, Größe oder Score. Rufen Sie den Zeitraum ab und filtern Sie in Ihrem System.

Verwendet vonCopy Anchor Link

• Endpunkte: GET /company liefert ein Company-Objekt je Unternehmen, GET /company-sessions das Objekt mit Sessions und Seitenaufrufen und GET /company_nace die NACE-Codes als eine Zeile je Code.
• Feeds: GET /intensive-visits, GET /returning-visits und GET /new-visits liefern eine feste Auswahl der Felder mit Sessions.
• Sessions: GET /session nennt company_id und company_name je Session.
• Ansprechpartner: POST /contacts/search, POST /contacts/find und GET /contacts/lookup nehmen company_id an. Für ein Unternehmen ohne Besuch auf Ihren Websites antworten sie mit 403 und COMPANY_NOT_IDENTIFIED, wie unter Contact beschrieben.
• Webhooks: company.identified, company.returned, company.intensive_visit und segment.entered tragen das Unternehmen in data.company, wie das Beispiel-Ereignis zeigt. Mehr dazu unter Webhooks.
• KI-Assistent: Auch der KI-Assistent ruft Unternehmen ab, mit den Tools list_visiting_companies und get_company_profile.