Get Website Visits

POST

companies

website-visits

Get Website Visitors

curl --request POST \
  --url https://api.lusha.com/v3/companies/website-visits \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "domains": [
    "lusha.com",
    "google.com"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-03-18",
  "pagination": {
    "size": 25,
    "page": 0
  },
  "sort": {
    "by": "score",
    "order": "desc"
  },
  "filters": {
    "scoreBands": [
      "hot",
      "warm"
    ],
    "score": {
      "min": 50
    }
  }
}
'

import requests

url = "https://api.lusha.com/v3/companies/website-visits"

payload = {
    "domains": ["lusha.com", "google.com"],
    "startDate": "2026-01-01",
    "endDate": "2026-03-18",
    "pagination": {
        "size": 25,
        "page": 0
    },
    "sort": {
        "by": "score",
        "order": "desc"
    },
    "filters": {
        "scoreBands": ["hot", "warm"],
        "score": { "min": 50 }
    }
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    domains: ['lusha.com', 'google.com'],
    startDate: '2026-01-01',
    endDate: '2026-03-18',
    pagination: {size: 25, page: 0},
    sort: {by: 'score', order: 'desc'},
    filters: {scoreBands: ['hot', 'warm'], score: {min: 50}}
  })
};

fetch('https://api.lusha.com/v3/companies/website-visits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

HttpResponse<String> response = Unirest.post("https://api.lusha.com/v3/companies/website-visits")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domains\": [\n    \"lusha.com\",\n    \"google.com\"\n  ],\n  \"startDate\": \"2026-01-01\",\n  \"endDate\": \"2026-03-18\",\n  \"pagination\": {\n    \"size\": 25,\n    \"page\": 0\n  },\n  \"sort\": {\n    \"by\": \"score\",\n    \"order\": \"desc\"\n  },\n  \"filters\": {\n    \"scoreBands\": [\n      \"hot\",\n      \"warm\"\n    ],\n    \"score\": {\n      \"min\": 50\n    }\n  }\n}")
  .asString();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lusha.com/v3/companies/website-visits"

	payload := strings.NewReader("{\n  \"domains\": [\n    \"lusha.com\",\n    \"google.com\"\n  ],\n  \"startDate\": \"2026-01-01\",\n  \"endDate\": \"2026-03-18\",\n  \"pagination\": {\n    \"size\": 25,\n    \"page\": 0\n  },\n  \"sort\": {\n    \"by\": \"score\",\n    \"order\": \"desc\"\n  },\n  \"filters\": {\n    \"scoreBands\": [\n      \"hot\",\n      \"warm\"\n    ],\n    \"score\": {\n      \"min\": 50\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "requestId": "1c2d3e4f-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
  "results": [
    {
      "id": "16303253",
      "name": "Lusha",
      "domain": "www.lusha.com",
      "industry": "Technology, Information & Media",
      "location": {
        "city": "London",
        "state": "England",
        "country": "United Kingdom",
        "countryIso2": "GB",
        "continent": "Europe"
      },
      "score": 87,
      "scoreBand": "hot",
      "totalSessions": 12,
      "uniqueVisitors": 5,
      "avgSessionMinutes": 4.2,
      "daysVisited": 8,
      "highIntentPageviews": 10,
      "daysSinceLastVisit": 6,
      "lastVisit": "2026-03-20",
      "visitorCountry": "US"
    }
  ],
  "pagination": {
    "page": 0,
    "size": 25,
    "total": 142
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}

Beta. This endpoint’s request and response shape may change before general availability.

Returns companies ranked by website-visit behavior for the tracked domains and date range you supply. Each result combines a V3 company firmographic preview - the same shape Search Companies returns - with behavioral visit metrics: engagement score, sessions, unique visitors, and more.

Domains must already be configured for tracking in the Lusha dashboard - they’re resolved to site IDs server-side. If any requested domain isn’t configured for tracking, the entire request fails with 400.

Endpoint

POST https://api.lusha.com/v3/companies/website-visits

Authentication: API key (ApiKeyAuth)

Request body

string[]

required

Tracked domains to pull visit data for. At least 1 item.Example: ["lusha.com", "google.com"]

string

required

Start of the date range, in YYYY-MM-DD format.Example: "2026-01-01"

string

required

End of the date range, in YYYY-MM-DD format.Example: "2026-03-18"

The startDate–endDate range must be 3 months or less.

object

required

Show pagination fields

integer

required

Zero-indexed page number.Example: 0

integer

required

Results per page. Range: 1–150.Example: 25

object

Show sort fields

string

Field to sort results by.Example: "score"

string

Sort direction.Allowed values: asc, desc

object

Optional filters to narrow results.

Show filters fields

string[]

Restrict results to companies in these engagement bands.Allowed values: cold, warm, hot

object

Show properties

string[]

ISO country codes to include. Example: ["US", "GB"]

string[]

ISO country codes to exclude. Example: ["CN"]

object

Integer range filter, { "min": 0, "max": 100 }. Both bounds optional.

object

Integer range filter on total sessions.

object

Integer range filter on unique visitor count.

object

Integer range filter on distinct days visited.

object

Integer range filter on high-intent pageviews.

object

Integer range filter on days since the last visit.

object

Float range filter ({ "min": ..., "max": ... }) on average session duration in minutes.

Example request

curl --request POST \
  --url https://api.lusha.com/v3/companies/website-visits \
  --header 'api_key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "domains": ["lusha.com", "google.com"],
    "startDate": "2026-01-01",
    "endDate": "2026-03-18",
    "pagination": { "size": 25, "page": 0 },
    "sort": { "by": "score", "order": "desc" },
    "filters": {
      "scoreBands": ["hot", "warm"],
      "score": { "min": 50 }
    }
  }'

{
  "domains": ["lusha.com", "google.com"],
  "startDate": "2026-01-01",
  "endDate": "2026-03-18",
  "pagination": { "size": 25, "page": 0 },
  "sort": { "by": "score", "order": "desc" },
  "filters": {
    "scoreBands": ["hot", "warm"],
    "score": { "min": 50 }
  }
}

Response

200 - Success

string

UUID identifying this request.

object[]

Companies ranked by visit behavior. Each result is a company firmographic preview plus visit metrics.

Show properties

string

Lusha company ID. Example: "16303253"

string

Example: "Lusha"

string

Example: "www.lusha.com"

object

Show properties

integer

Example: 364

integer

Example: 201

integer

Example: 500

string

Example: "Technology, Information & Media"

object

Show properties

string

Example: "London"

string

Example: "England"

string

Example: "United Kingdom"

string

Example: "GB"

string

Example: "Europe"

Show properties

string

Example: "https://www.linkedin.com/company/lushadata"

string[]

Fields already available on this preview. Example: ["alternativeName", "description", "companyType", "employeesByDepartment", "competitors", "emails", "socialLinks"]

object[]

Fields you can reveal, and their credit cost. Same shape as canReveal on contact previews (field, credits).

string[]

Signal types currently associated with this company, if any.

object

Present when this company couldn’t be resolved. Has code (NOT_FOUND, COMPLIANCE_RESTRICTED, or ENRICH_FAILED) and message.

number

Engagement score. Example: 87

string

One of cold, warm, hot. Example: "hot"

number

Example: 12

number

Example: 5

number

Example: 4.2

number

Example: 8

number

Example: 10

number

Example: 6

string

Date of the most recent visit. Example: "2026-03-20"

string

Example: "US"

object

Show properties

integer

Example: 0

integer

Example: 25

integer

Total matching results across all pages. Example: 142

object

Show properties

integer

Example: 3

integer

Example: 1

{
  "requestId": "1c2d3e4f-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
  "results": [
    {
      "id": "16303253",
      "name": "Lusha",
      "domain": "www.lusha.com",
      "industry": "Technology, Information & Media",
      "location": {
        "city": "London",
        "state": "England",
        "country": "United Kingdom",
        "countryIso2": "GB",
        "continent": "Europe"
      },
      "score": 87,
      "scoreBand": "hot",
      "totalSessions": 12,
      "uniqueVisitors": 5,
      "avgSessionMinutes": 4.2,
      "daysVisited": 8,
      "highIntentPageviews": 10,
      "daysSinceLastVisit": 6,
      "lastVisit": "2026-03-20",
      "visitorCountry": "US"
    }
  ],
  "pagination": {
    "page": 0,
    "size": 25,
    "total": 142
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}

Error codes

Status	Meaning
`400`	Bad request - invalid input, a domain isn’t configured for tracking, or the date range exceeds 3 months.
`401`	Unauthorized - your API key is missing or invalid.
`402`	Payment required - insufficient credits.
`403`	Forbidden - account inactive or V3 access not enabled.
`429`	Too many requests - you have exceeded the rate limit.

Website Visits overview - domain-tracking setup and the 3-month range limit

Authorizations

api_key

string

header

required

Your Lusha API key. You can find this in your Lusha dashboard under API settings. Include this key in the api_key header for all requests.

Body

application/json

domains

string[]

required

Domains configured for tracking in the Lusha dashboard.

Minimum array length: 1

Example:

["lusha.com", "google.com"]

startDate

string<date>

required

Window start date (YYYY-MM-DD).

Example:

"2026-01-01"

endDate

string<date>

required

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

Example:

"2026-03-18"

pagination

object

required

Show child attributes

sort

object

Show child attributes

filters

object

Show child attributes

Response

Successful response

requestId

string<uuid>

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

results

object[]

Show child attributes

pagination

object

Show child attributes

billing

object

Credit usage summary for a V3 API request

Show child attributes

⌘I

Get Website Visitors

curl --request POST \
  --url https://api.lusha.com/v3/companies/website-visits \
  --header 'Content-Type: application/json' \
  --header 'api_key: <api-key>' \
  --data '
{
  "domains": [
    "lusha.com",
    "google.com"
  ],
  "startDate": "2026-01-01",
  "endDate": "2026-03-18",
  "pagination": {
    "size": 25,
    "page": 0
  },
  "sort": {
    "by": "score",
    "order": "desc"
  },
  "filters": {
    "scoreBands": [
      "hot",
      "warm"
    ],
    "score": {
      "min": 50
    }
  }
}
'

import requests

url = "https://api.lusha.com/v3/companies/website-visits"

payload = {
    "domains": ["lusha.com", "google.com"],
    "startDate": "2026-01-01",
    "endDate": "2026-03-18",
    "pagination": {
        "size": 25,
        "page": 0
    },
    "sort": {
        "by": "score",
        "order": "desc"
    },
    "filters": {
        "scoreBands": ["hot", "warm"],
        "score": { "min": 50 }
    }
}
headers = {
    "api_key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {api_key: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    domains: ['lusha.com', 'google.com'],
    startDate: '2026-01-01',
    endDate: '2026-03-18',
    pagination: {size: 25, page: 0},
    sort: {by: 'score', order: 'desc'},
    filters: {scoreBands: ['hot', 'warm'], score: {min: 50}}
  })
};

fetch('https://api.lusha.com/v3/companies/website-visits', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

HttpResponse<String> response = Unirest.post("https://api.lusha.com/v3/companies/website-visits")
  .header("api_key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domains\": [\n    \"lusha.com\",\n    \"google.com\"\n  ],\n  \"startDate\": \"2026-01-01\",\n  \"endDate\": \"2026-03-18\",\n  \"pagination\": {\n    \"size\": 25,\n    \"page\": 0\n  },\n  \"sort\": {\n    \"by\": \"score\",\n    \"order\": \"desc\"\n  },\n  \"filters\": {\n    \"scoreBands\": [\n      \"hot\",\n      \"warm\"\n    ],\n    \"score\": {\n      \"min\": 50\n    }\n  }\n}")
  .asString();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.lusha.com/v3/companies/website-visits"

	payload := strings.NewReader("{\n  \"domains\": [\n    \"lusha.com\",\n    \"google.com\"\n  ],\n  \"startDate\": \"2026-01-01\",\n  \"endDate\": \"2026-03-18\",\n  \"pagination\": {\n    \"size\": 25,\n    \"page\": 0\n  },\n  \"sort\": {\n    \"by\": \"score\",\n    \"order\": \"desc\"\n  },\n  \"filters\": {\n    \"scoreBands\": [\n      \"hot\",\n      \"warm\"\n    ],\n    \"score\": {\n      \"min\": 50\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api_key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "requestId": "1c2d3e4f-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
  "results": [
    {
      "id": "16303253",
      "name": "Lusha",
      "domain": "www.lusha.com",
      "industry": "Technology, Information & Media",
      "location": {
        "city": "London",
        "state": "England",
        "country": "United Kingdom",
        "countryIso2": "GB",
        "continent": "Europe"
      },
      "score": 87,
      "scoreBand": "hot",
      "totalSessions": 12,
      "uniqueVisitors": 5,
      "avgSessionMinutes": 4.2,
      "daysVisited": 8,
      "highIntentPageviews": 10,
      "daysSinceLastVisit": 6,
      "lastVisit": "2026-03-20",
      "visitorCountry": "US"
    }
  ],
  "pagination": {
    "page": 0,
    "size": 25,
    "total": 142
  },
  "billing": {
    "creditsCharged": 3,
    "resultsReturned": 1
  }
}

Overview

Resources

Endpoints

Endpoint

Request body

Example request

Response

200 - Success

Error codes

Authorizations

Body

Response

​Endpoint

​Request body

​Example request

​Response

​200 - Success

​Error codes

​Related pages

Authorizations

Body

Response

Endpoint

Request body

Example request

Response

200 - Success

Error codes

Related pages