Lytics is a customer data platform (CDP) that provides two concurrent REST APIs for managing unified user profiles, behavioral audiences, content affinity scoring, campaign flows, and real-time personalization. The v2 API (886 paths / 1,331 operations) covers accounts, authorizations, connections, schema and identity configuration, data models, streams, jobs and ML models; the v1 API still owns data collection, personalization, entity lookup and content classification. Lytics ingests data from 100+ sources, builds predictive audiences, and activates them across advertising networks, email providers, data warehouses and on-site personalization. Lytics joined Contentstack in January 2025.
Lytics publishes 34 APIs on the APIs.io network, including Account API, Account Settings API, Auth API, and 31 more. Tagged areas include Customer Data Platform, CDP, Personalization, Segmentation, and User Profiles.
The Lytics catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 1 Spectral governance ruleset.
Lytics’ developer surface includes authentication, documentation, engineering blog, pricing, changelog, support, CLI, and 49 more developer resources.
Regulatory Posture applies to this provider. Its tags matched the
Horizontal (data, software, accessibility, platform) regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it
carries 10 points of the composite. It is scored from the published contracts
themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already
holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in
front of it, and the first time that check is skipped a duplicate record is created.
Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet,
not penalised by it.
The six quality facets above are damped to 75 points between them,
because the conditional facet above carries the other
25. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 75% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/lytics: open an issue to ask a question, or submit a pull request to add artifacts.
Submit an artifact on GitHub — free →Manage your own listing — the Influence plan, $499/mo →
Account related resources of the *Lytics API*. The Account resource describes an account. An account can be a *Master* account, which means that it is a billing account. Master ...
API for creation or storage of auth tokens. Most of these tokens are created from the Integrations/Imports setup for Lytics integrations. Additionally, api tokens can be created...
Catalog exposes info about the schema of the data in Lytics. * **Entities** are Object Types, the primary one being a *User* although most accounts also have *Content* and *Camp...
Content APIs for Lytics Content Affinity Engine, allow for adding content into lytics, getting lists of content, and understanding the content and content-topics. **Content Clas...
API for creating and managing Experiences as well as all related and/or dependent models such as but not limited to Groups, Templates, Candidates, etc.
The Metric API provides access to a variety of metrics that are recorded in the Lytics platform. With this API, you can access segment-size metrics, events received per-hour, as...
Entity API, ie Personalization or Profile API. Retrieve attributes and segments an entity (most likely a user) is a member of. The *Entity* is a *User* most likely, but since Ly...
Schema management api to add/edit queries and user-fields. Lytics Query Language ============================= The Lytics Query Language is used to define the transformation of ...
Segments are named, logical expressions of users. These segments may logically be built using other segments as well. The segment api provides a list of segments built by both t...
Segment Collections are grouped/named lists of segments. Segments that participate in a collection such as **Goals** are related. The Lytics App ui has one predefined collection...
SegmentML provides a framework for building custom machine learning models directly in Lytics. Lytics SegmentML models are self-training, continuously-updating and real-time. Se...
API for creating stream models. A stream is the same as a [data stream](https://learn.lytics.com/product-docs/data-management/using-data-streams#what-are-data-streams? ) and is ...
**BETA API** Subscriptions are queries into real-time events in Lytics, most commonly listening to a list of users entering/leaving segments ie _triggers_. **Common Use Cases** ...
Get internal Lytics system events. These events are generally related to internal changes to state of an account. Common changes are CRUD Operations (Create, Update, Delete) of ...
Work is an *integration* unit, typically for imports and exports. Most run continually, while some run to completion. You generally would only use it through the Webadmin Integr...
aid: lytics
name: Lytics
description: Lytics is a customer data platform (CDP) that provides two concurrent REST APIs for managing unified user profiles,
behavioral audiences, content affinity scoring, campaign flows, and real-time personalization. The v2 API (886 paths / 1,331
operations) covers accounts, authorizations, connections, schema and identity configuration, data models, streams, jobs
and ML models; the v1 API still owns data collection, personalization, entity lookup and content classification. Lytics
ingests data from 100+ sources, builds predictive audiences, and activates them across advertising networks, email providers,
data warehouses and on-site personalization. Lytics joined Contentstack in January 2025.
type: Index
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: false
label: Hosted service · you call their endpoint
confidence: medium
source:
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: freemium
onboarding: self-serve
trial: false
try_now: true
public: false
label: Freemium · Self-serve signup
confidence: high
source:
- plans
- authentication
- rate-limits
- security
generated: '2026-09-03'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/lytics.png
url: https://raw.githubusercontent.com/api-evangelist/lytics/refs/heads/main/apis.yml
created: '2026-06-13'
modified: '2026-08-13'
specificationVersion: '0.23'
tags:
- Customer Data Platform
- CDP
- Personalization
- Segmentation
- User Profiles
- Behavioral Analytics
- Content Affinity
- Real-Time Data
- Marketing Automation
- Audience Activation
apis:
- aid: lytics:lytics-account-api
name: Lytics Account API
description: 'Account related resources of the *Lytics API*.
The Account resource describes an account. An account can be a *Master* account, which
means that it is a billing account. Master accounts have children accounts
which act more as separate projects, for same billing account. Each child
account can be used for Dev, Testing, etc., or for separate siloes of data
for sub-divisions, etc..
The Account resource has the following attributes:
| field | DataType | Description |
|-------------|------------------|---------------|
| id | string | unique id
| created | Date | Created date
| updated | Date | Last Updated Date
| domain | string | customer-assigned unique id (auto assigned to domain name). This must be unique across
lytics accounts
| email | string | primary email contact for account owner
| parent_id | string | parent account if this account is a child-account of master billing account
| name | string | account name'
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- Account
properties:
- type: OpenAPI
url: openapi/lytics-account-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-account-settings-api
name: Lytics Account Settings API
description: Account Settings describe features/settings for a Lytics account.
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- Account Settings
properties:
- type: OpenAPI
url: openapi/lytics-account-settings-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-auth-api
name: Lytics Auth API
description: 'API for creation or storage of auth tokens. Most of these
tokens are created from the Integrations/Imports setup for Lytics integrations.
Additionally, api tokens can be created/managed from this endpoint.
The oauth, config information are write only attributes that
cannot be subsequently read from the api, and is stored encrypted.'
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- Authentication
tags_raw:
- Auth
properties:
- type: OpenAPI
url: openapi/lytics-auth-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-auths-api
name: Lytics Auths API
description: Create and manage credentials and access to external systems.
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- Auths
properties:
- type: OpenAPI
url: openapi/lytics-auths-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-catalog-api
name: Lytics Catalog API
description: "Catalog exposes info about the schema of the data in Lytics.\n\n* **Entities** are Object Types, the primary\
\ one being a *User*\n although most accounts also have *Content* and *Campaign* as well.\n Custom object types\
\ may be created.\n\n* **Streams** Streams are data sources collected from api or *Integrations* (aka *Work*).\n\n* **Schema**\
\ Per entity type is list of field-types.\n Think of it as describing columns on the user table in a database."
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- Catalog
properties:
- type: OpenAPI
url: openapi/lytics-catalog-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-connections-api
name: Lytics Connections API
description: Create and manage connections to external data sources.
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- Connections
properties:
- type: OpenAPI
url: openapi/lytics-connections-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-content-api
name: Lytics Content API
description: "Content APIs for Lytics Content Affinity Engine, allow for\nadding content into lytics, getting lists of content,\
\ and\nunderstanding the content and content-topics.\n\n**Content Classification**\nContent classification refers to the\
\ Lytics automated\nprocess of taking text, URL, image based content\nand classifying it to attach topics to content documents.\n\
\n* *Content* A list of content (URLs, Email Documents, Uploaded Documents, Campaigns) and\n the topics, created dates,\
\ etc for each.\n\n* *ContentTopics* Categories/Topics are applied to each piece of content.\n\n* *User Content Affinity*\
\ Based on user interacting with content, the topics\n (derived from the content they interact with) is enriched into\
\ their\n profile.\n\nFirst, an overview of How this content gets here.\n\n* *Observed URLs* Once the lytics tag is\
\ on a Website, as users\n use the website any new URL they interact with is collected.\n\n* *Crawling* we can proactively\
\ crawl a site.\n\n* *Email Tools* We see URLs inside of email campaigns and proactively classify\n those URLs, as well\
\ as the emails themselves.\n\n* *Uploaded Content* You may upload content to the **Classify**.\n\n**Use Cases**\n\n*1)\
\ User Content Recomendations* Find content for a user\n based on their content-affinity.\n\n*2) Get List of Content*\
\ Rich query api to get content.\n\n**Examples**\n\n```\n\n# ad-hoc segment scan from content table\n# get a list of content\
\ documents that\n# - have aspects=article (aspects = article,product, etc)\n# - has imageurl\ncurl -s -H \"Authorization:\
\ $LIOKEY\" \\\n -XGET \"https://api.lytics.io/api/segment/scan?sortfield=created&limit=10\" -d '\nFILTER AND (\n EXISTS\
\ imageurls\n aspects = \"article\"\n)\nFROM content\n' | jq '.'\n\n# Create a content-segment\n# - uses \"ALIAS\" as\
\ id for create/update, must be unique\ncurl -s -H \"Authorization: $LIOKEY\" -H \"Content-Type: text/plain\" \\\n -XPOST\
\ \"$LIOAPI/api/segment\" -d '\nFILTER AND (\n EXISTS imageurls\n aspects = \"article\"\n)\nFROM content\nWITH name =\
\ \"My Articles\"\nALIAS my_articles\n' | jq '.'\n\n# grab just those content-docs using named segment scan\ncurl -s -H\
\ \"Authorization: $LIOKEY\" \\\n -XGET \"https://api.lytics.io/api/segment/my_articles/scan?sortfield=created&limit=10\"\
\ \\\n | jq '.'\n\n\n# grab recommended articles for single user\n\ncurl -s -H \"Authorization: $LIODATAKEY\" \\\n -XGET\
\ \"https://api.lytics.io/api/content/recommend/:your_account_id/user/user_id/123456\" \\\n | jq '.'\n\n```"
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- Content
properties:
- type: OpenAPI
url: openapi/lytics-content-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-experience-api
name: Lytics Experience API
description: API for creating and managing Experiences as well as all related and/or dependent models such as but not limited
to Groups, Templates, Candidates, etc.
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- Experience
properties:
- type: OpenAPI
url: openapi/lytics-experience-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-flows-api
name: Lytics Flows API
description: Create and manage flows that orchestrate multi-step audience journeys.
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- Flow
tags_raw:
- Flows
properties:
- type: OpenAPI
url: openapi/lytics-flows-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-jobs-api
name: Lytics Jobs API
description: Create and manage data import and export jobs.
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- Job
tags_raw:
- Jobs
properties:
- type: OpenAPI
url: openapi/lytics-jobs-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-metric-api
name: Lytics Metric API
description: 'The Metric API provides access to a variety of metrics that are recorded
in the Lytics platform. With this API, you can access segment-size metrics,
events received per-hour, as well as many workflow specific metrics.'
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- metric
tags_raw:
- Metric
properties:
- type: OpenAPI
url: openapi/lytics-metric-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-metrics-api
name: Lytics Metrics API
description: Query time series metrics for segments, streams, experiences, and other Lytics resources.
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- Metrics
properties:
- type: OpenAPI
url: openapi/lytics-metrics-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-ml-models-api
name: Lytics ML Models API
description: The ML Models API from Lytics — 3 operation(s) for ml models.
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- ML Models
properties:
- type: OpenAPI
url: openapi/lytics-ml-models-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-personalization-api
name: Lytics Personalization API
description: "Entity API, ie Personalization or Profile API.\n\nRetrieve attributes and segments an entity (most likely\
\ a user) is a member of.\n\nThe *Entity* is a *User* most likely, but since Lytics is organized as a Graph Database,\n\
other types of entities may be modeled such as Accounts, or Company, Content, or custom.\n\n```\n# read a single user\n\
curl -s -H \"Authorization: $LIOKEY\" \\\n -XGET \"https://api.lytics.io/api/entity/user/user_id/user123\" | jq '.'\n\
\n```"
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- Personalization
properties:
- type: OpenAPI
url: openapi/lytics-personalization-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-profiles-api
name: Lytics Profiles API
description: Get and delete user profiles.
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- Profiles
properties:
- type: OpenAPI
url: openapi/lytics-profiles-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
- aid: lytics:lytics-provider-api
name: Lytics Provider API
description: Provider is a 3rd party Lytics Integrates with (Mailchimp, Optimizely, Mixpanel, Facebook etc)
humanURL: https://docs.lytics.com/reference
baseURL: https://api.lytics.io/v2
tags:
- Providers
tags_raw:
- Provider
properties:
- type: OpenAPI
url: openapi/lytics-provider-api-openapi.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i
- type: Documentation
url: https://docs.lytics.com/reference
- type: APIReference
url: https://docs.lytics.com/reference
- type: ToolCrosswalk
url: mcp/lytics-tool-crosswalk.yml
- type: OpenAPI Source
url: https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx
# --- truncated at 32 KB (61 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lytics/refs/heads/main/apis.yml
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.