Lytics API

Name: Lytics API
Brand: Lytics API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentAnalyticsProduct AnalyticsapiKey10 EndpointsREST

For Agents

Send events to a Lytics stream, look up entity profiles, and create or query audience segments inside the Lytics customer data platform.

Install Jentic One Beta

Connect the Lytics API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Lytics 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 Lytics API.

Collect data into a named stream via POST /collect/json/{streamName}

List streams configured in the workspace and inspect a specific stream's metadata

Look up an entity (user profile) by entity type, field name, and field value

GET STARTED

Start building with Lytics API

Explore with Jentic

View OpenAPI Document

Use Cases

Patterns agents use Lytics API for, with concrete tasks.

★ Server-side event collection into a CDP

Backend services and analytics pipelines stream events into Lytics via POST /collect/json/{streamName} so user activity is captured outside the browser. This is preferred over client-side tags for transaction events, server jobs, and integrations from third-party tools, since it avoids ad-blocking and ensures the event arrives even if the browser tab closes.

POST /collect/json/web with a JSON payload containing user_id, event 'order_completed', and order amount.

Audience segmentation and activation

Marketing teams build segments inside Lytics — for example 'high-intent buyers viewed pricing in last 7 days' — and then activate them downstream into ad networks or email tools. POST /api/segment creates a segment, GET /api/segment lists existing ones, and PUT /api/segment/{segmentId} updates the rules. The structured endpoints make segments diffable in version control or generated by an AI agent from natural-language briefs.

POST /api/segment with the rules for 'viewed pricing twice in last 7 days' and confirm the segment is created with a returned segmentId.

Entity profile lookup for personalisation

Personalisation services look up a single user's Lytics profile in real time before rendering a page or sending an email. GET /api/entity/{entityType}/{fieldName}/{fieldValue} returns the profile by an indexed field (such as email or user ID), and POST /api/entity scans for entities matching a broader query. This powers next-best-content and dynamic email content decisions.

GET /api/entity/user/email/jane@example.com and return the user's segment memberships and last-seen timestamp.

Agent-driven CDP automation via Jentic

An AI agent is asked 'create a segment for users who viewed our pricing page twice in the last 7 days and tell me how many match'. Jentic stores the Lytics Authorization key in MAXsystem and exposes the segment-create and entity-scan operations by intent so the agent can chain segmentation with profile lookups.

Search Jentic for 'create lytics segment', execute POST /api/segment with the rules, then call POST /api/entity to count matching profiles.

Key Endpoints

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

METHOD

PATH

DESCRIPTION

GET

/api/entity/{entityType}/{fieldName}/{fieldValue}

Get entity by indexed field

POST

/api/entity

Scan entities by query

GET

/api/segment

List segments

POST

/api/segment

Create segment

PUT

/api/segment/{segmentId}

Update segment

DELETE

/api/segment/{segmentId}

Delete segment

POST

/collect/json/{streamName}

Collect events into a named stream

GET

/api/entity/{entityType}/{fieldName}/{fieldValue}

Get entity by indexed field

POST

/api/entity

Scan entities by query

GET

/api/segment

List segments

POST

/api/segment

Create segment

PUT

/api/segment/{segmentId}

Update segment

DELETE

Why Jentic?

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

Credential isolation

The Lytics Authorization API key is held encrypted in the Jentic MAXsystem vault. Jentic attaches it as the Authorization header on every request to api.lytics.io, keeping the raw key out of the agent's context and logs.

Intent-based discovery

Agents search by intent such as 'create lytics segment', 'lookup user profile', or 'send event to stream', and Jentic returns the matching Lytics operation with its parameter schema for direct execution.

Time to first call

Direct Lytics integration: 1-3 days to wire authentication, model the entity/segment/stream surface, and handle pagination on entity scans. Through Jentic: under 1 hour — search, load schema, execute.

FAQs

Specific to using Lytics API through Jentic.

Why is there no official OpenAPI spec for Lytics API?

Lytics does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Lytics 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 Lytics API use?

The Lytics API uses an Authorization header carrying an API key. Send the key as the Authorization value on every request to api.lytics.io. Through Jentic, the key is stored encrypted in MAXsystem and injected per request, so it never enters the agent's prompt.

Can I create a segment programmatically and count its members?

Yes. POST /api/segment creates the segment with the provided rules, GET /api/segment/{segmentId} returns its current definition, and POST /api/entity can scan for entities matching the rules so you can count members. PUT and DELETE on /api/segment/{segmentId} let you keep the segment in lockstep with rule changes.

What are the rate limits for the Lytics API?

Concrete rate limits are not declared in this spec. Expect per-account limits scaled to your Lytics plan — design clients to back off on 429 responses and prefer batched event payloads over per-event calls into /collect/json/{streamName}.

How do I send events into Lytics through Jentic?

Search Jentic for 'lytics collect event', load POST /collect/json/{streamName}, and execute it with the stream name and event payload. Jentic injects the Authorization API key automatically and the event lands in the named stream for segment evaluation.

Lytics API

Connect the Lytics API to your agent

Capabilities

Start building with Lytics API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs