Returning companies
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.
APIKeyHeaderAuthorization<token>domain*Domainfrom_date?From DateStarting DateTime format or relative dates like '-30 days', '-1 hour', '-5 minutes'. Examples: '2023-01-01', '-7 days', '-12 hours', '-5 minutes', 'now'
"-30 days"to_date?To DateEnding DateTime format or 'now' for the current date/time. Examples: '2023-01-31', 'now'
"now"Companies with two or more visits within the date range, with those visits; every field present, null when unknown
application/json- response
result*array<>One entry per company, not paged
curl -X GET 'https://hub.webmetic.de/returning-visits?domain=website.example'{ "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 } ]}