Zeiträume und Zeitzonen

Ein Zeitraum besteht aus from_date und to_date. Wenn Sie zum Beispiel alle Unternehmen sehen wollen, die im Oktober Ihre Website besucht haben, senden Sie from_date=2026-10-01&to_date=2026-10-31.

Der Zeitraum filtert nach dem Beginn eines Besuchs, nicht nach den einzelnen Seitenaufrufen darin.

Vom Datum zum ErgebnisCopy Anchor Link

1. 1Datum angebenSie senden ein Datum, eine Uhrzeit oder eine relative Angabe wie -7 days.
2. 2In UTC umrechnenWebmetic rechnet die Angabe in einen Zeitpunkt in UTC um.
3. 3Besuche filternWebmetic wählt die Sessions, die im Zeitraum begonnen haben.
4. 4Antwort lesenAlle Zeitangaben in der Antwort stehen in UTC.

Parameter und StandardwerteCopy Anchor Link

Alle acht Visitor-Intelligence-Endpunkte nehmen die beiden Parameter in der Query an: /company-sessions, /company, /company_nace, /session, /session_user_data, /intensive-visits, /returning-visits und /new-visits. Enrichment, Ansprechpartner und Webhooks haben keine Zeitraum-Parameter.

• from_date: Beginn des Zeitraums. Ohne Angabe gilt -30 days, also 30 Tage vor dem Zeitpunkt der Anfrage.
• to_date: Ende des Zeitraums. Ohne Angabe gilt now, der Zeitpunkt der Anfrage.

Erlaubte FormateCopy Anchor Link

Beide Parameter verstehen dieselben Formate:

Relative Angaben kennen days, hours, minutes und years, aber keine Wochen und Monate. Für eine Woche oder einen Monat geben Sie deshalb zwei Daten an. Schreiben Sie now immer klein, denn die API versteht NOW nicht.

Wenn die API einen Wert nicht lesen kann, antwortet sie mit Status 400 und dem Code INVALID_DATE. Mehr dazu unter Fehler.

Anfang und EndeCopy Anchor Link

• Beginn: from_date gehört zum Zeitraum, deshalb ist eine Session mit genau diesem Startzeitpunkt enthalten.
• Ende: to_date gehört nicht mehr dazu, weil der Zeitraum direkt vor diesem Zeitpunkt endet.
• Datum ohne Uhrzeit: Als to_date zählt der ganze Tag mit, deshalb schließt to_date=2026-10-31 den 31. Oktober ein.

Ein Unternehmen erscheint, wenn mindestens eine seiner Sessions im Zeitraum begonnen hat. Ein Besuch, der vor from_date begann, fehlt auch dann, wenn er in den Zeitraum hineinreicht.

/session_user_data liefert alle Seitenaufrufe einer Session, die im Zeitraum begonnen hat.

ZeitzonenCopy Anchor Link

Webmetic rechnet in UTC und liest auch ein ISO-Datum oder eine ISO-Uhrzeit ohne Zeitzone als UTC. Empfohlen: Geben Sie Zeitpunkte als ISO-Wert mit Z an, weil sie dann eindeutig sind.

curl "https://hub.webmetic.de/company?domain=ihre-website.de&from_date=2026-10-01T00:00:00Z&to_date=2026-11-01T00:00:00Z" \
  -H "Authorization: wmtc_IHR_API_SCHLUESSEL"

Sie können auch einen Versatz angeben, zum Beispiel +02:00. In einer URL steht + aber für ein Leerzeichen, und die API liest den Wert dann ohne Fehlermeldung falsch. Schreiben Sie deshalb %2B oder lassen Sie Ihren HTTP-Client den Parameter kodieren:

curl -G "https://hub.webmetic.de/session" \
  -H "Authorization: wmtc_IHR_API_SCHLUESSEL" \
  --data-urlencode "domain=ihre-website.de" \
  --data-urlencode "from_date=2026-10-21T00:00:00+02:00" \
  --data-urlencode "to_date=2026-10-22T00:00:00+02:00"

Zeitangaben in AntwortenCopy Anchor Link

• API-Antworten: In Antworten auf GET-Anfragen stehen Zeitstempel in ISO 8601 in UTC, ohne Z und ohne Versatz, zum Beispiel 2026-08-22T08:20:26.384000. Lesen Sie die Werte als UTC. JavaScript liest einen Zeitstempel ohne Suffix als Ortszeit. Hängen Sie deshalb vor dem Parsen ein Z an, wenn der Wert keinen Versatz hat: new Date(value + "Z").
• Sekundenbruchteile: Webmetic lässt Sekundenbruchteile weg, wenn sie null sind, zum Beispiel 2026-10-01T08:00:00. Lesen Sie Zeitstempel deshalb mit einem ISO-Parser und nicht nach fester Position.
• Webhooks: Zugestellte Ereignisse enthalten jede Zeitangabe in UTC mit Z.

Nächste SchritteCopy Anchor Link