Sign in

v1

latestOpenAPI 3.0.3Proprietary2026-08-0656136286.9 KB
Website Visits

Get Website Visitors

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
post/v3/companies/website-visits

Request body

domainsstring[] required

Domains configured for tracking in the Lusha dashboard.

startDatestring date required

Window start date (YYYY-MM-DD).

endDatestring date required

Window end date (YYYY-MM-DD). Range must be ≤ 3 months.

Example request

{
  "domains": [
    "lusha.com",
    "google.com"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-03-18",
  "pagination": {
    "size": 25
  },
  "sort": {
    "by": "score",
    "order": "desc"
  },
  "filters": {
    "scoreBands": [
      "hot",
      "warm"
    ],
    "visitorCountries": {
      "include": [
        "US",
        "GB"
      ],
      "exclude": [
        "CN"
      ]
    }
  }
}

Response

Successful response

requestIdstring uuid

Example response

{
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "results": [
    {
      "clientReferenceId": "comp-ref-1",
      "id": "16303253",
      "name": "Lusha",
      "domain": "www.lusha.com",
      "employeeCount": {
        "exact": 364,
        "min": 201,
        "max": 500
      },
      "industry": "Technology, Information & Media",
      "location": {
        "city": "London",
        "state": "England",
        "stateCode": "MA",
        "country": "United Kingdom",
        "countryIso2": "GB",
        "continent": "Europe"
      },
      "socialLinks": {
        "linkedin": "https://www.linkedin.com/company/lushadata"
      },
      "has": [
        "alternativeName",
        "alternativeDomains",
        "description",
        "companyType",
        "yearFounded",
        "subIndustry",
        "specialities",
        "sicCodes",
        "naicsCodes",
        "additionalLocations",
        "linkedinFollowers",
        "popularityTier",
        "logoUrl",
        "employeesByDepartment",
        "employeesByLocation",
        "employeesBySeniority",
        "competitors",
        "businessModel",
        "phones",
        "emails",
        "keywords",
        "socialLinks",
        "estimatedAnnualItSpend",
        "monthlyWebsiteTraffic"
      ],
      "canReveal": [
        {
          "field": "employeesByDepartment",
          "credits": 1
        },
        {
          "field": "employeesByLocation",
          "credits": 1
        },
        {
          "field": "employeesBySeniority",
          "credits": 1
        },
        {
          "field": "competitors",
          "credits": 1
        },
        {
          "field": "intent",
          "credits": 0
        },
        {
          "field": "estimatedAnnualItSpend",
          "credits": 1
        },
        {
          "field": "monthlyWebsiteTraffic",
          "credits": 1
        }
      ],
      "signalTypes": [
        "headcountIncrease3m"
      ],
      "error": {
        "code": "NOT_FOUND",
        "message": "Contact not found"
      },
      "score": 87,
      "scoreBand": "hot",
      "totalSessions": 12,
      "uniqueVisitors": 5,
      "avgSessionMinutes": 4.2,
      "daysVisited": 8,
      "highIntentPageviews": 10,
      "daysSinceLastVisit": 6,
      "lastVisit": "2026-03-20",
      "visitorCountry": "US"
    }
  ],
  "pagination": {
    "size": 25,
    "total": 142
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}