# Besuchsarten (https://webmetic.de/docs/api/datenmodell/besuchsarten) Eine Besuchsart beschreibt, wie ein Unternehmen Ihre Website besucht hat: intensiv, wiederkehrend oder neu. Ein Beispiel: Jemand von einem Getränkehersteller liest zwei Minuten lang Ihre Preisseite, und Webmetic führt das Unternehmen als intensiv. Wenn das Unternehmen zum ersten Mal auf Ihrer Website war, ist es zugleich neu. Webmetic berechnet die drei Arten für Sie, und die API liefert sie als Feeds und als Webhook-Ereignisse. ## Regeln [#regeln] | Besuchsart | Feed | Webhook-Ereignis | | --- | --- | --- | | Intensiv | `/intensive-visits`: Unternehmen mit mindestens einem Besuch von mindestens 30 Sekunden im Zeitraum | `company.intensive_visit`: jeder Besuch von mindestens 30 Sekunden, einmal pro Besuch | | Wiederkehrend | `/returning-visits`: Unternehmen mit zwei oder mehr Besuchen im Zeitraum | `company.returned`: jeder Besuch nach dem ersten, einmal pro Besuch | | Neu | `/new-visits`: Unternehmen, deren erster Besuch im Zeitraum liegt | `company.identified`: der erste Besuch, einmal pro Unternehmen und Website | Ein Besuch ist eine [Session](https://webmetic.de/docs/api/datenmodell/session). Webmetic wertet nur die Besuche aus, die Ihr Konto auf dieser Website erfasst hat. Besuche, die Webmetic keinem Unternehmen zuordnet, haben keine Besuchsart. Die drei Arten sind unabhängig voneinander. Ein Besuch kann zwei Ereignisse auslösen, zum Beispiel `company.identified` und `company.intensive_visit`. ### Intensiv [#intensiv] Ein Besuch ist intensiv, wenn er insgesamt 30 Sekunden oder länger dauert. Webmetic liest dafür `session_duration`, und genau 30 Sekunden zählen mit. Die Zahl der Seiten und die Scrolltiefe spielen keine Rolle. Auch `session_time` zählt nicht, denn das ist die durchschnittliche Zeit pro Seitenaufruf. Das Ereignis `company.intensive_visit` kann später eintreffen als die anderen Ereignisse desselben Besuchs. Webmetic prüft den Besuch weiter, nachdem er im Dashboard erscheint, und meldet ihn, sobald er 30 Sekunden erreicht. ### Wiederkehrend [#wiederkehrend] Für wiederkehrende Unternehmen gelten mit Absicht zwei Regeln: - **Feed**: `/returning-visits` zählt nur Besuche im Zeitraum und lässt Besuche vor `from_date` weg. - **Webhook**: `company.returned` meldet jeden Besuch eines Unternehmens, das Ihre Website schon einmal besucht hat, unabhängig davon, wann. Ein Beispiel: Ein Unternehmen hat Ihre Website im letzten Jahr zehnmal besucht und diese Woche einmal. In `/returning-visits?from_date=-7 days` fehlt es, aber der Webhook meldet den Besuch als `company.returned`. ### Neu [#neu] Neu ist ein Unternehmen bei seinem ersten Besuch, den Ihr Konto auf dieser Website erfasst hat. Besuche, die andere Webmetic-Konten erfasst haben, zählen nicht. Der Feed `/new-visits` liefert ein Unternehmen, wenn dieser erste Besuch im Zeitraum liegt. Wenn er vor `from_date` lag, fehlt das Unternehmen, auch wenn es Ihre Website seitdem oft besucht hat. Für denselben Besuch schließen sich `company.identified` und `company.returned` aus. Ein neuer Webhook meldet nur Besuche ab seiner Einrichtung. Er meldet Unternehmen, die Ihre Website schon vorher besucht haben, als `company.returned`. Sie fragen frühere neue Unternehmen mit `/new-visits` ab. ## Zeitraum und Antwort [#zeitraum-und-antwort] Die drei Feeds nehmen `domain`, `from_date` und `to_date` an. Wenn Sie keinen Zeitraum angeben, gelten die letzten 30 Tage bis jetzt. - **Zeitraum**: Er beginnt mit `from_date` und endet direkt vor `to_date`. Ein Datum ohne Uhrzeit schließt als `to_date` den ganzen Tag ein. Mehr dazu unter [Zeiträume und Zeitzonen](https://webmetic.de/docs/api/zeitraeume-und-zeitzonen). - **Keine Seiten**: Die Antwort enthält alle Zeilen auf einmal in `result`. Weil die Feeds weder `page` noch `page_size` kennen, wählen Sie für große Ergebnisse einen kürzeren Zeitraum. - **Reihenfolge**: Die Feeds liefern die Zeilen in keiner festen Reihenfolge. - **Eine Zeile pro Unternehmen**: Jedes Unternehmen steht höchstens einmal in einem Feed, kann aber in mehreren Feeds stehen. - **Alle Felder**: Jede Zeile hat dieselben Felder, und nur bei verborgenen Unternehmen kommt `blurred` dazu. Was Webmetic nicht kennt, ist `null`, bei `directors` und `nace_codes` eine leere Liste. - **Schlüssel**: Sie brauchen den Visitor-Intelligence-Schlüssel. Wenn `domain` nicht zu Ihrem Konto gehört, antwortet die API mit `API_KEY_NOT_AUTHORIZED`, wie unter [Fehler](https://webmetic.de/docs/api/fehler) beschrieben. - **Limits**: Es gilt eine Anfrage pro Sekunde je Endpunkt, wie unter [Anfragelimits](https://webmetic.de/docs/api/anfragelimits) beschrieben. Die Feeds und die Webhooks kosten keine Credits. ## Aufbau einer Zeile [#aufbau-einer-zeile] Jede Zeile ist ein Unternehmen mit den Feldern von [Company](https://webmetic.de/docs/api/datenmodell/company). In den Feeds fehlen davon `organization_type`, `primary_color`, `secondary_color`, `wz2025_codes` und die Texte `what_they_do_*`, `how_they_make_money_*` und `target_audience_*`. Dazu kommen diese Felder: | Feld | Typ | Beispiel | Beschreibung | | --- | --- | --- | --- | | `sessions` | `array` | | Die Besuche, die zur Regel passen, als [Session](https://webmetic.de/docs/api/datenmodell/session) mit den [Seitenaufrufen](https://webmetic.de/docs/api/datenmodell/page-view) in `user_data`, nach Zeit sortiert, die älteste zuerst. | | `timestamp`, `weburl`, `utm_source`, `utm_medium`, `utm_campaign`, `utm_term`, `utm_content`, `utm_campaign_id`, `click_id`, `click_type`, `session_duration`, `session_time`, `visitor_city`, `visitor_country`, `visitor_zip`, `visitor_country_code` | wie in der Session | `"2026-10-14T08:12:05.214000"` | Kopien aus der frühesten Session in `sessions`. | | `sessions_total` | `integer` | `1` | Die Zahl der Sessions in `sessions`. | | `pages_total` | `integer` | `3` | Die Zahl der Seitenaufrufe in diesen Sessions. | | `blurred` | `boolean` | `true` | Nur bei verborgenen Unternehmen im Free-Plan, sonst fehlt das Feld. | Welche Besuche in `sessions` stehen und in `sessions_total` und `pages_total` zählen, hängt vom Feed ab: - `/intensive-visits`: nur die intensiven Besuche im Zeitraum. - `/returning-visits` und `/new-visits`: alle Besuche des Unternehmens im Zeitraum. ## Beispiel [#beispiel] Das Beispiel zeigt eine Zeile aus `/intensive-visits` in gekürzter Form: Es fehlen die meisten Felder mit `null` und einige Felder der Session. ```json title="GET /intensive-visits" { "result": [ { "company_id": "41ea486a9c95", "company_name": "Bergquell Mineralbrunnen GmbH", "city": "Freising", "country_code": "DE", "company_url": "www.bergquell.example", "linkedin": null, "employee_count": [201, 500], "lead_score": 88.0, "fit_score": 92, "relevance_score": 80.96, "sessions": [ { "timestamp": "2026-10-14T08:12:05.214000", "session_id": "01M4WQFX6YM2X5V8T4N6R1C0DZ", "weburl": "https://ihre-website.de", "utm_source": "linkedin", "utm_medium": "social", "utm_campaign": "messe-2026", "session_duration": 309.0, "session_time": 103.0, "visitor_city": "Freising", "visitor_country_code": "DE", "user_data": [ { "timestamp": "2026-10-14T08:12:05.214000", "document_location": "https://ihre-website.de/preise", "time_spent": 95.0 }, { "timestamp": "2026-10-14T08:13:40.214000", "document_location": "https://ihre-website.de/abfuellanlagen", "time_spent": 150.0 }, { "timestamp": "2026-10-14T08:16:10.214000", "document_location": "https://ihre-website.de/kontakt", "time_spent": 64.0 } ] } ], "timestamp": "2026-10-14T08:12:05.214000", "weburl": "https://ihre-website.de", "utm_source": "linkedin", "utm_medium": "social", "utm_campaign": "messe-2026", "utm_term": null, "session_duration": 309.0, "session_time": 103.0, "visitor_city": "Freising", "visitor_country_code": "DE", "sessions_total": 1, "pages_total": 3 } ] } ``` ## Sonderfälle [#sonderfälle] - **Free-Plan**: Unternehmen, die Sie im Free-Plan nicht sehen, stehen trotzdem in den Feeds. Ihre Zeile behält `company_id`, hat `blurred: true` und einen Platzhalter in `company_name`. Alle anderen Felder sind `null`, auch `sessions_total` und `pages_total`. In den Sessions haben nur `session_id` und `timestamp` einen Wert. Alle übrigen Session-Felder sind `null`, und `user_data` ist leer. - **Webhooks im Free-Plan**: Webhooks melden nur die Unternehmen, die Sie im Free-Plan sehen. Verborgene Unternehmen lösen kein Ereignis aus. Mehr dazu unter [Pläne](https://webmetic.de/docs/konto/plaene). ## Verwendet von [#verwendet-von] - **Feeds**: [`/intensive-visits`](https://webmetic.de/docs/api/referenz/visitor-intelligence/intensive-visits), [`/returning-visits`](https://webmetic.de/docs/api/referenz/visitor-intelligence/returning-visits) und [`/new-visits`](https://webmetic.de/docs/api/referenz/visitor-intelligence/new-visits). - **Webhooks**: Die Webhook-Ereignisse heißen `company.intensive_visit`, `company.returned` und `company.identified`. Mehr dazu unter [Webhooks](https://webmetic.de/docs/api/webhooks). Ein Ereignis enthält ein Unternehmen und einen einzelnen Besuch, keine Zeile wie im Feed. Unter [**Menü** > **Integrationen** > **Webhooks**](https://app.webmetic.de/?menu=webhooks) heißen sie **Interessiertes Unternehmen**, **Wiederkehrendes Unternehmen** und **Neues Unternehmen**. - **Dashboard**: Die [Benachrichtigungen](https://webmetic.de/docs/visitor-intelligence/benachrichtigungen) **Interessierte Unternehmen**, **Wiederkehrende Unternehmen** und **Neue Unternehmen** nutzen die Regeln der Feeds. - **KI-Assistent**: Auch der [KI-Assistent](https://webmetic.de/docs/ki-assistent/tools-und-prompts) ruft die Besuchsarten ab, mit dem Tool `get_visit_highlights`.