WebmeticDocs

Returning companies

GET
/returning-visits

Retrieves a list of companies that have visited the specified domain multiple times.

This endpoint provides information about companies that have had at least two sessions on your website within the date range (visits before from_date do not count), each with those sessions, oldest first, indicating repeated interest or engagement. This data can be crucial for identifying potential leads, loyal customers, or companies that might be in an active decision-making process.

Parameters:

  • domain (str): The domain name for which you want to retrieve returning visitor data.
  • from_date (str): Starting date/time or relative date like '-30 days', '-1 hour', '-5 minutes'. Default is '-30 days'.
  • to_date (str): Ending date/time or 'now' for current date/time. Default is 'now'.

Note: This endpoint is rate-limited to 1 request per second and requires a valid API key for authentication.

Authentifizierung

APIKeyHeader
headerAuthorization<token>

Query-Parameter

domain*Domain
from_date?From Date

Starting DateTime format or relative dates like '-30 days', '-1 hour', '-5 minutes'. Examples: '2023-01-01', '-7 days', '-12 hours', '-5 minutes', 'now'

Standard"-30 days"
to_date?To Date

Ending DateTime format or 'now' for the current date/time. Examples: '2023-01-31', 'now'

Standard"now"

Response-Body

Companies with two or more visits within the date range, with those visits; every field present, null when unknown

application/json
  1. response
result*array<>

One entry per company, not paged

Beispielanfrage
curl -X GET 'https://hub.webmetic.de/returning-visits?domain=website.example'
Beispielantwort
{  "result": [    {      "company_id": "41ea486a9c95",      "company_name": "Bergquell Mineralbrunnen GmbH",      "address": "Brunnenweg 4",      "postal_code": "85354",      "city": "Freising",      "country": "Deutschland",      "country_code": "DE",      "directors": [        "Florian Obermaier"      ],      "email_pattern": "p1",      "phone_number": "+49 8161 99998214",      "email_address": "info@bergquell.example",      "vat_id": "DE000000000",      "registration_number": "HRB 000000",      "registration_court": "Amtsgericht München",      "company_url": "www.bergquell.example",      "company_logo_url": "https://logos.docs.example/bergquell.png",      "linkedin": "https://www.linkedin.com/company/bergquell-mineralbrunnen-example",      "short_description_en": "Mineral spring with its own bottling of mineral water and soft drinks.",      "short_description_de": "Mineralbrunnen mit eigener Abfüllung für Mineralwasser und Erfrischungsgetränke.",      "lead_score": 88,      "fit_score": 92,      "relevance_score": 80.96,      "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"        }      ],      "employee_count": [        201,        500      ],      "revenue": [        50000000,        100000000      ],      "sessions": [        {          "timestamp": "2026-10-20T08:20:26.384000",          "session_id": "01K8B3QW5N7M2XRT4HZJ6C9D0E",          "client_id": "3b7e0c55d2a94f18b6c1e0a7d9f42c86e15b0a3d7c9e2f41a8b6d03c5e7f9a12",          "weburl": "https://nordhafen.example",          "utm_source": "google",          "utm_medium": "cpc",          "utm_campaign": "dampfkessel",          "session_duration": 152,          "session_time": 76,          "session_engagement": 111,          "user_agent_browser": {            "family": "Chrome",            "version": "130.0.0"          },          "user_agent_os": {            "family": "Windows",            "version": "11"          },          "user_agent_category": "desktop",          "visitor_city": "Freising",          "visitor_country": "Deutschland",          "visitor_zip": "85354",          "visitor_country_code": "DE",          "user_data": [            {              "timestamp": "2026-10-20T08:20:26.384000",              "document_location": "https://nordhafen.example/dampfkessel",              "document_title": "Dampfkessel | Nordhafen",              "scroll_depth": 75,              "referrer": "https://www.google.com/",              "time_spent": 64,              "engagement_time": 41,              "user_events_count": 0            },            {              "timestamp": "2026-10-20T08:21:30.384000",              "document_location": "https://nordhafen.example/kontakt",              "document_title": "Kontakt | Nordhafen",              "scroll_depth": 90,              "time_spent": 88,              "engagement_time": 70,              "user_events_count": 1,              "events": [                {                  "type": "form_submit",                  "target": "kontaktformular",                  "detail": "https://nordhafen.example/kontakt",                  "meta": {                    "fieldCount": 6,                    "fieldsInteracted": 5,                    "timeSpent": 64                  }                }              ]            }          ]        }      ],      "timestamp": "2026-10-20T08:20:26.384000",      "weburl": "https://nordhafen.example",      "utm_source": "google",      "utm_medium": "cpc",      "utm_campaign": "dampfkessel",      "session_duration": 152,      "session_time": 76,      "visitor_city": "Freising",      "visitor_country": "Deutschland",      "visitor_zip": "85354",      "visitor_country_code": "DE",      "sessions_total": 1,      "pages_total": 2    }  ]}