GoSquared Tracking API

Name: GoSquared Tracking API
Brand: GoSquared Tracking API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentAnalyticsProduct AnalyticsapiKey2 EndpointsREST

For Agents

Send server-side pageview and event records to GoSquared real-time analytics with visitor identification across any device or runtime.

Install Jentic One Beta

Connect the GoSquared Tracking API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the GoSquared Tracking API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with GoSquared Tracking API.

Record a pageview with URL, referrer, and visitor identifier

Send a custom event with arbitrary properties for product analytics

Identify a visitor by email or external_id to feed the People CRM

GET STARTED

Start building with GoSquared Tracking API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use GoSquared Tracking API for, with concrete tasks.

★ Server-Side Event Tracking

Send conversion, signup, and purchase events from your backend or worker fleet to GoSquared without depending on a browser SDK. POST /event with a project key, person identifier, event name, and JSON properties to record activity even when the user has ad-blockers enabled or the action happens off-page.

POST /event with name 'signup-completed', person email user@example.com, properties {'plan':'pro','utm_source':'launch'} to the GoSquared project.

Real-Time Pageview Logging

Log a pageview every time a server-rendered route is hit so the GoSquared real-time dashboard reflects traffic regardless of client environment. This pattern is useful for SSR sites where the JS SDK loads slowly, for CLI usage tracking, and for embedded experiences that lack a DOM altogether.

POST /pageview with url 'https://example.com/dashboard', title 'Dashboard', and the visitor's anonymous_id captured from the session cookie.

Pipeline Replay into GoSquared

Forward events from an existing data pipeline (Segment, Kafka, custom warehouse export) into GoSquared so the marketing and product teams can keep using the GoSquared dashboard. The two-endpoint surface keeps the integration small and durable, and GoSquared handles deduplication and rate limiting on the server side.

Read events from the kafka topic 'product-events' and POST each one to /event with the GoSquared project key, mapping pipeline fields to the expected payload.

AI Agent Telemetry

An AI agent emits its own usage telemetry to GoSquared by calling /event with structured properties such as tool name, latency, and outcome. Through Jentic, the agent discovers the operation by intent and uses a vault-stored project key, so the analytics token is never exposed in agent prompts or logs.

Send a POST to /event named 'tool-called' with properties {'tool':'search','duration_ms':842,'success':true} so the team can see agent usage in real time.

Key Endpoints

2 endpoints — jentic publishes the only available openapi specification for gosquared tracking api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/event

Record a custom event

POST

/pageview

Record a pageview

POST

/event

Record a custom event

POST

/pageview

Record a pageview

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The GoSquared project key is stored encrypted in the Jentic vault (MAXsystem). Agents reference it by name and Jentic appends it as the api_key query parameter at execution time, so the raw token does not reach agent prompts.

Intent-based discovery

Agents search by intent (e.g., 'track a signup event') and Jentic returns POST /event with input schema, so the agent calls the right endpoint without reading vendor docs.

Time to first call

Direct GoSquared integration: a few hours for the two endpoints. Through Jentic: under 15 minutes from search to first event.

FAQs

Specific to using GoSquared Tracking API through Jentic.

Why is there no official OpenAPI spec for GoSquared Tracking API?

GoSquared does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call GoSquared Tracking API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the GoSquared Tracking API use?

The project key is passed in the request as a query parameter. Use the project token from your GoSquared dashboard. Through Jentic, the project key is stored in the encrypted vault and appended at execution time so it does not appear in agent prompts.

Can I send custom event properties to GoSquared?

Yes. POST /event accepts a JSON body with name, person identifier, and a properties object containing arbitrary key-value pairs. Properties are indexed in GoSquared and can be filtered in the dashboard or used to drive triggers in GoSquared People.

How do I record a pageview from a server-side renderer?

POST /pageview with the visitor identifier (anonymous or person id), the page URL, and optional title. This avoids the JS SDK on slow first-paint pages and ensures pageview counts even when ad-blockers run.

How do I integrate the GoSquared Tracking API with an AI agent through Jentic?

Run pip install jentic, search 'track an event' to find POST /event, load the schema, and execute. Jentic appends the project key from the vault. Get started at https://app.jentic.com/sign-up.

GoSquared Tracking API

Connect the GoSquared Tracking API to your agent

Capabilities

Start building with GoSquared Tracking API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs