Sign in
Analytics

Get visitor by GUID with geolocation data

get/analytics/visitors/guid/{visitor_id}

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/analytics/visitors/guid/{visitor_id}
  • Auth: HTTP bearer

Path parameters

visitor_idstring required

Visitor GUID (supports enc_ prefix for encrypted IDs)

Query parameters

project_idinteger required

Project ID

environment_idinteger

Environment ID (optional)

Response

Successfully retrieved visitor with geolocation

citystring nullable
countrystring nullable
country_codestring nullable
crawler_namestring nullable
custom_dataunknown
environment_idinteger required
first_channelstring nullable

Marketing channel from the first visit (e.g. "Organic Search", "Direct")

first_referrerstring nullable

Full referrer URL from the visitor's first session

first_referrer_hostnamestring nullable

Hostname extracted from first_referrer

first_seenstring date-time required
idinteger required
ip_addressstring nullable
is_crawlerboolean required
is_euboolean nullable
last_seenstring date-time required
latitudenumber double nullable
longitudenumber double nullable
project_idinteger required
regionstring nullable
timezonestring nullable
user_agentstring nullable
visitor_idstring required

Example response

{
  "first_seen": "2024-01-01T00:00:00",
  "last_seen": "2024-01-01T00:00:00"
}

Changes

No recorded changes to this operation across all 50 revisions of this API.