Visitors

Get Visitor Statistics

Counts over the visitor stream, filtered.

companies counts UNIQUE BY IP, contacts does not - the two series are not comparable row for row and should not be charted as if they were.

post/visitors/{resource}/statistics

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/visitors/{resource}/statistics
  • Auth: HTTP bearer

Path parameters

resource'contacts' | 'companies' required

What to count.

Query parameters

include_botsboolean

Also count bot and crawler traffic. Off by default: events from self-identified crawlers, headless browsers, HTTP libraries and datacenter/cloud networks are excluded.

include_internalboolean

Also count internal traffic. Off by default: the graph8 app (app.graph8.com), local development hosts and your own team members (member emails and company email domains) are excluded.

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

object[] required

Filter conditions, each {field, operator, value} - e.g. {"field": "received_at", "operator": "greaterThanOrEqual", "value": "2025-01-01"}. An empty list means no filtering. Left as an open shape because the operator vocabulary is the app's and still moves; an enum here would reject a filter the app accepts.

Response

Successful Response

Changes

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