Website Visits

Fetch and search website visits tracked by the ContactLevel pixel.

Get website visit

GET

https://a.contactlevel.com

/api/website-visits/{visit_id}

Retrieve a single website visit by its unique identifier. Returns visit details including URL, visit type (ad_click or return), referrer, visitor location, browser, and session duration. Set include_contacts=true to include resolved contacts.

Get website visit › path Parameters

visit_id

string · required

Get website visit › query Parameters

include_contacts

boolean

Default: false

Get website visit › Responses

Successful Response

FetchWebsiteVisitResponse

required

The website visit details. Includes resolved contacts when include_contacts=true.

Search website visits

POST

https://a.contactlevel.com

/api/website-visits/search

Search website visits within your organization with optional filters on visit type (ad_click or return), audience, location, browser, platform, recording availability, and landing URL.

Search website visits › Request Body

SearchWebsiteVisitRequest

Filter by stored visit type: ad_click (campaign-attributed) or return. Omit to include both.

Example: ad_click

Filter visits by audience.

Example: d290f1ee-6c54-4b01-90e6-d701748f0851

Filter by visitor's country.

Example: US

Filter by visitor's city.

Example: San Francisco

Filter by visitor's IP address.

Example: 203.0.113.42

Filter by browser name.

Example: Chrome

Filter by platform (e.g. macOS, Windows, Linux).

Example: macOS

Filter to only visits that have a session recording.

Example: true

Filter by landing page URL.

Example: https://acmecorp.com/pricing

limit

integer · min: 1 · max: 100

Maximum number of results to return.

Default: 25

Search website visits › Responses

Successful Response

SearchWebsiteVisitResponse

WebsiteVisitModel[] · required

Website visits matching the search criteria.

Search website visits by contact

POST

https://a.contactlevel.com

/api/website-visits/contacts/search

Search for website visits linked to contacts matching the provided filters. Searches contacts by name, job title, company, location, or LinkedIn URL, then returns website visits associated with those contacts via identity resolution. Optionally filter visits by type (ad_click or return).

Search website visits by contact › Request Body

ListContactWebsiteVisitsRequest

Filter by stored visit type: ad_click (campaign-attributed) or return. Omit to include both.

Example: ad_click

Filter by contact's first name.

Example: Sarah

Filter by contact's last name.

Example: Chen

Filter by contact's job title.

Example: VP Marketing

Filter by functional area.

Example: Marketing

Filter by company name.

Example: Acme Corp

Filter by company domain.

Example: acmecorp.com

Filter by contact's city.

Example: San Francisco

Filter by contact's state or region.

Example: CA

Filter by contact's country.

Example: US

Filter by postal code.

Example: 94105

Filter by LinkedIn profile URL.

Example: https://linkedin.com/in/sarachen

page

integer · min: 1

Page number (1-indexed).

Example: 1

Default: 1

page_size

integer · min: 1 · max: 100

Number of results per page.

Example: 25

Default: 25

Search website visits by contact › Responses

Successful Response

ListContactWebsiteVisitsResponse

WebsiteVisitModel[] · required

Website visits associated with matching contacts.

total

integer · required

Total number of matching website visits.

Example: 42

page

integer · required

Current page number.

Example: 1

page_size

integer · required

Number of results per page.

Example: 25

Search website visits by company

POST

https://a.contactlevel.com

/api/website-visits/companies/search

Search for website visits linked to companies matching the provided filters. Searches companies by name, domain, industry, location, or size, then returns website visits associated with those companies via identity resolution. Optionally filter visits by type (ad_click or return).

Search website visits by company › Request Body

ListCompanyWebsiteVisitsRequest

Filter by stored visit type: ad_click (campaign-attributed) or return. Omit to include both.

Example: ad_click

Filter by company ID directly. When provided, other company filters are ignored.

Example: b2c3d4e5-f6a7-8901-bcde-f12345678901

Filter by company name.

Example: Acme Corp

Filter by company domain.

Example: acmecorp.com

Filter by industry.

Example: Software

Filter by city.

Example: San Francisco

Filter by state.

Example: CA

Filter by country.

Example: US

Filter by ZIP code.

Example: 94105

Filter by employee count range.

Example: 201-500

Filter by revenue range.

Example: $50M-$100M

Filter by LinkedIn company URL.

Example: https://linkedin.com/company/acmecorp

page

integer · min: 1

Page number (1-indexed).

Example: 1

Default: 1

page_size

integer · min: 1 · max: 100

Number of results per page.

Example: 25

Default: 25

Search website visits by company › Responses

Successful Response

ListCompanyWebsiteVisitsResponse

WebsiteVisitModel[] · required

Website visits associated with matching companies.

total

integer · required

Total number of matching website visits.

Example: 87

page

integer · required

Current page number.

Example: 1

page_size

integer · required

Number of results per page.

Example: 25

Companies Organization

Get website visit

GET

https://a.contactlevel.com

/api/website-visits/{visit_id}

Get website visit › path Parameters

visit_id

string · required

Get website visit › query Parameters

include_contacts

boolean

Default: false

Get website visit › Responses

Successful Response

FetchWebsiteVisitResponse

required

The website visit details. Includes resolved contacts when include_contacts=true.

Search website visits

POST

https://a.contactlevel.com

/api/website-visits/search

Search website visits within your organization with optional filters on visit type (ad_click or return), audience, location, browser, platform, recording availability, and landing URL.

Search website visits › Request Body

SearchWebsiteVisitRequest

Filter by stored visit type: ad_click (campaign-attributed) or return. Omit to include both.

Example: ad_click

Filter visits by audience.

Example: d290f1ee-6c54-4b01-90e6-d701748f0851

Filter by visitor's country.

Example: US

Filter by visitor's city.

Example: San Francisco

Filter by visitor's IP address.

Example: 203.0.113.42

Filter by browser name.

Example: Chrome

Filter by platform (e.g. macOS, Windows, Linux).

Example: macOS

Filter to only visits that have a session recording.

Example: true

Filter by landing page URL.

Example: https://acmecorp.com/pricing

limit

integer · min: 1 · max: 100

Maximum number of results to return.

Default: 25

Search website visits › Responses

Successful Response

SearchWebsiteVisitResponse

WebsiteVisitModel[] · required

Website visits matching the search criteria.

Search website visits by contact

POST

https://a.contactlevel.com

/api/website-visits/contacts/search

Search website visits by contact › Request Body

ListContactWebsiteVisitsRequest

Filter by stored visit type: ad_click (campaign-attributed) or return. Omit to include both.

Example: ad_click

Filter by contact's first name.

Example: Sarah

Filter by contact's last name.

Example: Chen

Filter by contact's job title.

Example: VP Marketing

Filter by functional area.

Example: Marketing

Filter by company name.

Example: Acme Corp

Filter by company domain.

Example: acmecorp.com

Filter by contact's city.

Example: San Francisco

Filter by contact's state or region.

Example: CA

Filter by contact's country.

Example: US

Filter by postal code.

Example: 94105

Filter by LinkedIn profile URL.

Example: https://linkedin.com/in/sarachen

page

integer · min: 1

Page number (1-indexed).

Example: 1

Default: 1

page_size

integer · min: 1 · max: 100

Number of results per page.

Example: 25

Default: 25

Search website visits by contact › Responses

Successful Response

ListContactWebsiteVisitsResponse

WebsiteVisitModel[] · required

Website visits associated with matching contacts.

total

integer · required

Total number of matching website visits.

Example: 42

page

integer · required

Current page number.

Example: 1

page_size

integer · required

Number of results per page.

Example: 25

Search website visits by company

POST

https://a.contactlevel.com

/api/website-visits/companies/search

Search website visits by company › Request Body

ListCompanyWebsiteVisitsRequest

Filter by stored visit type: ad_click (campaign-attributed) or return. Omit to include both.

Example: ad_click

Filter by company ID directly. When provided, other company filters are ignored.

Example: b2c3d4e5-f6a7-8901-bcde-f12345678901

Filter by company name.

Example: Acme Corp

Filter by company domain.

Example: acmecorp.com

Filter by industry.

Example: Software

Filter by city.

Example: San Francisco

Filter by state.

Example: CA

Filter by country.

Example: US

Filter by ZIP code.

Example: 94105

Filter by employee count range.

Example: 201-500

Filter by revenue range.

Example: $50M-$100M

Filter by LinkedIn company URL.

Example: https://linkedin.com/company/acmecorp

page

integer · min: 1

Page number (1-indexed).

Example: 1

Default: 1

page_size

integer · min: 1 · max: 100

Number of results per page.

Example: 25

Default: 25

Search website visits by company › Responses

Successful Response

ListCompanyWebsiteVisitsResponse

WebsiteVisitModel[] · required

Website visits associated with matching companies.

total

integer · required

Total number of matching website visits.

Example: 87

page

integer · required

Current page number.

Example: 1

page_size

integer · required

Number of results per page.

Example: 25