---
title: "Get Website Visitors"
method: POST
path: "/v3/companies/website-visits"
tags: ["Website Visits"]
---

# Get Website Visitors

`POST /v3/companies/website-visits`

Returns companies ranked by website-visit signals for your tracked domains and date range.

Domains must be configured for tracking in the Lusha dashboard — they are resolved to site IDs server-side. Each result combines a V3 company firmographic preview (same shape as Search Companies) with behavioral visit metrics.

**Notes:**
- Date range must be ≤ 3 months
- If any requested domain is not configured for tracking, the entire request fails with `400`
- `limit` accepts 1–150

## Request body

- WebsiteVisitsRequest
  - `domains` string[], required — Domains configured for tracking in the Lusha dashboard.
  - `startDate` string, date, required — Window start date (YYYY-MM-DD).
  - `endDate` string, date, required — Window end date (YYYY-MM-DD). Range must be ≤ 3 months.
  - `pagination` object, required
    - `size` integer, required
    - `page` integer, required
  - `sort` object
    - `by` string — Field to sort by (e.g. `score`).
    - `order` 'asc' | 'desc'
  - `filters` WebsiteVisitsFilters
    - `scoreBands` string[] — Restrict to specific score bands.
    - `visitorCountries` object — ISO 3166-1 alpha-2 country code filters.
      - `include` string[]
      - `exclude` string[]
    - `score` WebsiteVisitsIntRange — Integer range filter (non-negative)
      - `min` integer
      - `max` integer
    - `totalSessions` WebsiteVisitsIntRange — Integer range filter (non-negative)
      - `min` integer
      - `max` integer
    - `avgSessionMinutes` WebsiteVisitsFloatRange — Float range filter (non-negative)
      - `min` number
      - `max` number
    - `uniqueVisitors` WebsiteVisitsIntRange — Integer range filter (non-negative)
      - `min` integer
      - `max` integer
    - `daysVisited` WebsiteVisitsIntRange — Integer range filter (non-negative)
      - `min` integer
      - `max` integer
    - `highIntentPageviews` WebsiteVisitsIntRange — Integer range filter (non-negative)
      - `min` integer
      - `max` integer
    - `daysSinceLastVisit` WebsiteVisitsIntRange — Integer range filter (non-negative)
      - `min` integer
      - `max` integer

## Response `200`

Successful response

- WebsiteVisitsResponse
  - `requestId` string, uuid
  - `results` WebsiteVisitsCompanyResult[]
    - `clientReferenceId` string
    - `id` string
    - `name` string
    - `domain` string
    - `employeeCount` object
      - `exact` integer
      - `min` integer
      - `max` integer
    - `industry` string
    - `location` object
      - `city` string
      - `state` string
      - `stateCode` string — Free field. ISO/postal state or region code, when available.
      - `country` string
      - `countryIso2` string
      - `continent` string
    - `socialLinks` object
      - `linkedin` string
    - `has` string[] — Available data points that can be revealed via Enrich Companies. Includes base firmographic fields plus new revealable fields: employeesByDepartment, employeesByLocation, employeesBySeniority, competitors, businessModel, phones, emails, keywords, socialLinks, estimatedAnnualItSpend, monthlyWebsiteTraffic.
    - `canReveal` V3CanRevealItem[] — Data fields that can be revealed via Enrich Companies, with the credit cost per field. A cost of 0 means the field has already been revealed for this account.
      - `field` 'emails' | 'phones'
      - `credits` integer — Credit cost (0 when already revealed for this account)
    - `signalTypes` string[]
    - `error` V3ItemError — Per-item error in a batch response
      - `code` 'NOT_FOUND' | 'COMPLIANCE_RESTRICTED' | 'ENRICH_FAILED'
      - `message` string
    - `score` number — Display score (0–100).
    - `scoreBand` 'cold' | 'warm' | 'hot' — Qualitative score band.
    - `totalSessions` number — Total sessions in the window.
    - `uniqueVisitors` number — Distinct visitors in the window.
    - `avgSessionMinutes` number — Average session length in minutes.
    - `daysVisited` number — Distinct days with activity.
    - `highIntentPageviews` number — High-intent pageviews in the window.
    - `daysSinceLastVisit` number — Days since the most recent visit.
    - `lastVisit` string, date — Date of the last visit in the window.
    - `visitorCountry` string — Primary visitor country (ISO 3166-1 alpha-2). Omitted if unavailable.
  - `pagination` WebsiteVisitsPagination
    - `size` integer, required
    - `page` integer, required
    - `total` integer, required — Total results across all pages.
  - `billing` V3Billing — Credit usage summary for a V3 API request
    - `creditsCharged` integer — Total credits charged for this request
    - `resultsReturned` integer — Number of successful results returned

## Other responses

- `400` — Bad request - invalid input data
- `401` — Unauthorized - invalid or missing API key
- `402` — Payment required - insufficient credits
- `403` — Forbidden - account inactive, V3 access not enabled, or plan does not include this feature
- `429` — Too many requests - rate limit exceeded

---

[API](https://skmtc.net/lusha/apis/lusha-api-documentation.md) · [All operations](https://skmtc.net/lusha/apis/lusha-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lusha/lusha-api-documentation/versions/4c51e40e3e67/schema)