Query visitor data via API key
curl --request GET \
--url https://api.aws53.cloud/v1/data \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.aws53.cloud/v1/data"
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.aws53.cloud/v1/data', 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.aws53.cloud/v1/data",
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.aws53.cloud/v1/data"
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.aws53.cloud/v1/data")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aws53.cloud/v1/data")
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": [
{
"email": "visitor@example.test",
"emailHash": "b4fc5fb69efd3d88836a56aa432758b35b3ee9a4e30848f5d8f5f66209cd2822",
"emailHashes": {
"sha256": "b4fc5fb69efd3d88836a56aa432758b35b3ee9a4e30848f5d8f5f66209cd2822",
"sha1": "e5f6d0c61a56c87aa2e870e8ffd7ce552cd88366",
"md5": "b6321d878decf6402a73283b5f41c0e6"
},
"emails": [
"visitor@example.test"
],
"businessEmails": [
"visitor@example.test"
],
"personalEmails": [],
"phones": [],
"phonesDnc": null,
"firstName": null,
"lastName": null,
"middleName": null,
"fullName": null,
"emailDomain": "example.test",
"allEmails": [
"visitor@example.test"
],
"primaryPhone": null,
"allPhones": null,
"phonesDNC": null,
"ageRange": null,
"gender": null,
"hasChildren": null,
"isHomeowner": null,
"isMarried": null,
"personalAddress": null,
"personalZip": null,
"city": null,
"state": null,
"country": null,
"countryCode": null,
"personalTimezone": null,
"companyName": null,
"companyDomain": null,
"companyLinkedinUrl": null,
"companyAddress": null,
"companyCity": null,
"companyState": null,
"companyCountry": null,
"companyZipCode": null,
"companyEmployeeCount": null,
"companyTotalRevenue": null,
"companySizeRange": null,
"companyRevenueRange": null,
"jobTitle": null,
"headline": null,
"seniority": null,
"seniorityLevel2": null,
"seniorityLevelRaw": null,
"department": null,
"department2": null,
"departmentRaw": null,
"industry": null,
"linkedinUrl": null,
"photoUrl": null,
"linkedinUrn": null,
"skillsSummary": null,
"photoB2Url": null,
"companyLogoB2Url": null,
"company": null,
"companyZip": null,
"companySize": null,
"companySizeCategory": null,
"companyRevenue": null,
"companyIndustry": null,
"seniorityRaw": null,
"sessions": 1,
"pageviews": 1,
"pricingPageViews": 0,
"demoPageViews": 0,
"checkoutPageViews": 0,
"enrichmentLevel": "email_only",
"enrichmentScore": 0,
"intentScore": "low",
"firstSeenAt": "2026-01-01T00:00:00Z",
"lastSeenAt": "2026-01-01T00:00:00Z",
"firstSeen": "2026-01-01T00:00:00Z",
"lastSeen": "2026-01-01T00:00:00Z",
"daysSinceVisit": 0,
"landingPage": "https://www.example.test/",
"visitedPages": [
"https://www.example.test/"
],
"referrer": null,
"referrerDomain": null,
"utmSource": null,
"utmMedium": null,
"utmCampaign": null,
"utmTerm": null,
"utmContent": null,
"gclid": null,
"fbclid": null,
"googleGbraid": null,
"googleWbraid": null,
"googleGadSource": null,
"googleCampaignId": null,
"bingClickId": null,
"linkedinClickId": null,
"klaviyoTrackingId": null,
"hubspotAccountId": null,
"hubspotCampaignId": null,
"hubspotNetwork": null,
"msclkid": null,
"liFatId": null,
"gbraid": null,
"wbraid": null,
"channel": null,
"pixels": [
"11111111-1111-4111-8111-111111111111"
],
"pixelId": "11111111-1111-4111-8111-111111111111",
"pixelDetails": [
{
"id": "11111111-1111-4111-8111-111111111111",
"name": "Example Pixel",
"domain": "www.example.test"
}
],
"domains": [
"www.example.test"
],
"customAttribution": null
}
],
"meta": {
"page": 1,
"limit": 50,
"total": 1,
"totalPages": 1,
"hasMore": false
}
}Visitors
Query visitor data via API key
Returns resolved identified-person data for the organization owning the X-API-Key. Without email, the operation returns 50 people per one-based page, newest activity first; with email, it returns that person plus a session journey and summary. Identity aliases are represented as one person. timeframe supports today, 24h, 3d, 7d, 14d, 30d, mtd, 90d, ytd, and all; reads also return a frozen asOf and historical-coverage metadata. domain and pixelId are alternative scope mechanisms and cannot be combined. The read is rate-limited per API key; use the response rate-limit headers for pacing. Recent events and enrichment changes may appear after a short processing delay.
GET
/
v1
/
data
Query visitor data via API key
curl --request GET \
--url https://api.aws53.cloud/v1/data \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.aws53.cloud/v1/data"
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.aws53.cloud/v1/data', 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.aws53.cloud/v1/data",
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.aws53.cloud/v1/data"
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.aws53.cloud/v1/data")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aws53.cloud/v1/data")
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": [
{
"email": "visitor@example.test",
"emailHash": "b4fc5fb69efd3d88836a56aa432758b35b3ee9a4e30848f5d8f5f66209cd2822",
"emailHashes": {
"sha256": "b4fc5fb69efd3d88836a56aa432758b35b3ee9a4e30848f5d8f5f66209cd2822",
"sha1": "e5f6d0c61a56c87aa2e870e8ffd7ce552cd88366",
"md5": "b6321d878decf6402a73283b5f41c0e6"
},
"emails": [
"visitor@example.test"
],
"businessEmails": [
"visitor@example.test"
],
"personalEmails": [],
"phones": [],
"phonesDnc": null,
"firstName": null,
"lastName": null,
"middleName": null,
"fullName": null,
"emailDomain": "example.test",
"allEmails": [
"visitor@example.test"
],
"primaryPhone": null,
"allPhones": null,
"phonesDNC": null,
"ageRange": null,
"gender": null,
"hasChildren": null,
"isHomeowner": null,
"isMarried": null,
"personalAddress": null,
"personalZip": null,
"city": null,
"state": null,
"country": null,
"countryCode": null,
"personalTimezone": null,
"companyName": null,
"companyDomain": null,
"companyLinkedinUrl": null,
"companyAddress": null,
"companyCity": null,
"companyState": null,
"companyCountry": null,
"companyZipCode": null,
"companyEmployeeCount": null,
"companyTotalRevenue": null,
"companySizeRange": null,
"companyRevenueRange": null,
"jobTitle": null,
"headline": null,
"seniority": null,
"seniorityLevel2": null,
"seniorityLevelRaw": null,
"department": null,
"department2": null,
"departmentRaw": null,
"industry": null,
"linkedinUrl": null,
"photoUrl": null,
"linkedinUrn": null,
"skillsSummary": null,
"photoB2Url": null,
"companyLogoB2Url": null,
"company": null,
"companyZip": null,
"companySize": null,
"companySizeCategory": null,
"companyRevenue": null,
"companyIndustry": null,
"seniorityRaw": null,
"sessions": 1,
"pageviews": 1,
"pricingPageViews": 0,
"demoPageViews": 0,
"checkoutPageViews": 0,
"enrichmentLevel": "email_only",
"enrichmentScore": 0,
"intentScore": "low",
"firstSeenAt": "2026-01-01T00:00:00Z",
"lastSeenAt": "2026-01-01T00:00:00Z",
"firstSeen": "2026-01-01T00:00:00Z",
"lastSeen": "2026-01-01T00:00:00Z",
"daysSinceVisit": 0,
"landingPage": "https://www.example.test/",
"visitedPages": [
"https://www.example.test/"
],
"referrer": null,
"referrerDomain": null,
"utmSource": null,
"utmMedium": null,
"utmCampaign": null,
"utmTerm": null,
"utmContent": null,
"gclid": null,
"fbclid": null,
"googleGbraid": null,
"googleWbraid": null,
"googleGadSource": null,
"googleCampaignId": null,
"bingClickId": null,
"linkedinClickId": null,
"klaviyoTrackingId": null,
"hubspotAccountId": null,
"hubspotCampaignId": null,
"hubspotNetwork": null,
"msclkid": null,
"liFatId": null,
"gbraid": null,
"wbraid": null,
"channel": null,
"pixels": [
"11111111-1111-4111-8111-111111111111"
],
"pixelId": "11111111-1111-4111-8111-111111111111",
"pixelDetails": [
{
"id": "11111111-1111-4111-8111-111111111111",
"name": "Example Pixel",
"domain": "www.example.test"
}
],
"domains": [
"www.example.test"
],
"customAttribution": null
}
],
"meta": {
"page": 1,
"limit": 50,
"total": 1,
"totalPages": 1,
"hasMore": false
}
}Authorizations
Organization API key (sk_...). Get yours from Settings > API Keys in the dashboard.
Query Parameters
Exact primary or known alias email. When present, the response is a single visitor journey rather than a list.
Example:
"alex@example.test"
One-based page number for visitor-list mode. Each page contains up to 50 rows.
Required range:
x >= 1Example:
1
Activity window: today, 24h, 3d, 7d, 14d, 30d, mtd, 90d, ytd, or all.
Available options:
24h, 7d, 14d, 30d, 90d, all, today, 3d, mtd, ytd Example:
"30d"
Restrict visitor-list results to a tracked website domain. Mutually exclusive with pixelId.
Example:
"example.test"
Restrict results to one pixel owned by the API-key organization. An inaccessible or deleted pixel returns 403.
Example:
"00000000-0000-4000-8000-000000000001"
Was this page helpful?