curl --request GET \
--url https://api-v1.maverickintelligence.co/v1/people \
--header 'X-API-Key: <api-key>'import requests
url = "https://api-v1.maverickintelligence.co/v1/people"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api-v1.maverickintelligence.co/v1/people', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-v1.maverickintelligence.co/v1/people",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-v1.maverickintelligence.co/v1/people"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-v1.maverickintelligence.co/v1/people")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-v1.maverickintelligence.co/v1/people")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "<string>",
"email": "<string>",
"businessEmail": "<string>",
"personalEmail": "<string>",
"emailStatus": "valid",
"emailVerification": {},
"firstName": "<string>",
"lastName": "<string>",
"title": "<string>",
"company": "<string>",
"location": "<string>",
"region": "USA",
"linkedinUrl": "<string>",
"phone": "<string>",
"profileImageUrl": "<string>",
"visitCount": 123,
"firstSeen": "2023-11-07T05:31:56Z",
"lastSeen": "2023-11-07T05:31:56Z",
"isHotLead": true,
"classifiedSeniority": "<string>",
"classifiedJobFunction": "<string>",
"trafficType": "<string>",
"adPlatform": "<string>",
"referrer": "<string>",
"utmSource": "<string>",
"utmMedium": "<string>",
"utmCampaign": "<string>",
"utmTerm": "<string>",
"utmContent": "<string>",
"campaignHistory": [
{
"campaign": "<string>",
"platform": "<string>",
"trafficType": "<string>",
"source": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
],
"trackedDomain": "<string>",
"clientRef": "<string>",
"companyData": {
"companyId": "<string>",
"name": "<string>",
"domain": "<string>",
"standardizedIndustry": "<string>",
"location": "<string>",
"employeeCount": 123
},
"pageViews": [
{
"timestamp": "2023-11-07T05:31:56Z",
"url": "<string>",
"pageTitle": "<string>",
"domain": "<string>"
}
],
"pageViewsTruncated": true
}
],
"pagination": {
"limit": 123,
"count": 123,
"nextCursor": "<string>"
},
"window": {
"visitedSince": "2023-11-07T05:31:56Z",
"visitedUntil": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"status": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"status": 123
}
}List People
Returns a paginated list of identified website visitors
curl --request GET \
--url https://api-v1.maverickintelligence.co/v1/people \
--header 'X-API-Key: <api-key>'import requests
url = "https://api-v1.maverickintelligence.co/v1/people"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api-v1.maverickintelligence.co/v1/people', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api-v1.maverickintelligence.co/v1/people",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api-v1.maverickintelligence.co/v1/people"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api-v1.maverickintelligence.co/v1/people")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-v1.maverickintelligence.co/v1/people")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "<string>",
"email": "<string>",
"businessEmail": "<string>",
"personalEmail": "<string>",
"emailStatus": "valid",
"emailVerification": {},
"firstName": "<string>",
"lastName": "<string>",
"title": "<string>",
"company": "<string>",
"location": "<string>",
"region": "USA",
"linkedinUrl": "<string>",
"phone": "<string>",
"profileImageUrl": "<string>",
"visitCount": 123,
"firstSeen": "2023-11-07T05:31:56Z",
"lastSeen": "2023-11-07T05:31:56Z",
"isHotLead": true,
"classifiedSeniority": "<string>",
"classifiedJobFunction": "<string>",
"trafficType": "<string>",
"adPlatform": "<string>",
"referrer": "<string>",
"utmSource": "<string>",
"utmMedium": "<string>",
"utmCampaign": "<string>",
"utmTerm": "<string>",
"utmContent": "<string>",
"campaignHistory": [
{
"campaign": "<string>",
"platform": "<string>",
"trafficType": "<string>",
"source": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
],
"trackedDomain": "<string>",
"clientRef": "<string>",
"companyData": {
"companyId": "<string>",
"name": "<string>",
"domain": "<string>",
"standardizedIndustry": "<string>",
"location": "<string>",
"employeeCount": 123
},
"pageViews": [
{
"timestamp": "2023-11-07T05:31:56Z",
"url": "<string>",
"pageTitle": "<string>",
"domain": "<string>"
}
],
"pageViewsTruncated": true
}
],
"pagination": {
"limit": 123,
"count": 123,
"nextCursor": "<string>"
},
"window": {
"visitedSince": "2023-11-07T05:31:56Z",
"visitedUntil": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"status": 123
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"status": 123
}
}visited_since (and optionally
visited_until); include_page_views=true adds the pages each person viewed in
that window. This mode allows limit up to 250 and orders people by when their
record last changed, so follow nextCursor to the end and deduplicate by id.
See Partners for details.
Each person includes stored acquisition attribution: referrer, utmSource,
utmMedium, utmCampaign, utmTerm, utmContent, and campaignHistory, alongside
trafficType and adPlatform. Missing scalar values are null; missing history
is []. These fields may describe an earlier campaign rather than the latest
visit. Reading them does not collect or generate missing attribution.Query Parameters
Partner domain group ID. Matches exact member hostnames (www aliases normalized), including any member site the person has visited. Intersects domain, client_ref, and the key's scope; never grants extra access. Empty group returns zero matches; missing/foreign group returns 404; invalid ID returns 400. Keep this filter when following pagination cursors.
^[A-Za-z0-9][A-Za-z0-9_-]{0,63}$Return only people who viewed at least one of these pages anywhere in their journey, not just the page they were identified on. Comma-separate for several. Paths are matched case-insensitively and ignore the host, query string and trailing slash, so /Pricing/ and https://acme.com/pricing?utm_source=x both mean /pricing. An empty or invalid value returns 400 validation_error.
"/pricing,/demo"
Return only people with at least one address in the given deliverability statuses. Comma-separate for several. Valid values: valid, invalid, catch-all, unknown, spamtrap, abuse, do_not_mail — anything else returns 400. People with no email address at all never match, including on unknown.
"valid,catch-all"
Blank any email field whose address is confirmed undeliverable (invalid, spamtrap, abuse, do_not_mail), matching what a verified CSV export does. The person is still returned, and emailVerification still reports the status, so you can see why a field came back empty. Addresses that are catch-all, unknown, or not yet verified are kept. Off by default — it empties fields existing integrations already read.
Return only people with an identified page view at or after this time (timezone required). Switches to visit-window mode: results ordered by record update time, limit up to 250, its own cursor. A person updated while paging can appear on a later page again; deduplicate by id.