How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Lytics Content API

Content APIs for Lytics Content Affinity Engine, allow foradding content into lytics, getting lists of content, andunderstanding the content and content-topics.**Content Classification**Content classification refers to the Lytics automatedprocess of taking text, URL, image based contentand classifying it to attach topics to content documents.* *Content* A list of content (URLs, Email Documents, Uploaded Documents, Campaigns) and the topics, created dates, etc for each.* *ContentTopics* Categories/Topics are applied to each piece of content.* *User Content Affinity* Based on user interacting with content, the topics (derived from the content they interact with) is enriched into their profile.First, an overview of How this content gets here.* *Observed URLs* Once the lytics tag is on a Website, as users use the website any new URL they interact with is collected.* *Crawling* we can proactively crawl a site.* *Email Tools* We see URLs inside of email campaigns and proactively classify those URLs, as well as the emails themselves.* *Uploaded Content* You may upload content to the **Classify**.**Use Cases***1) User Content Recomendations* Find content for a user based on their content-affinity.*2) Get List of Content* Rich query api to get content.**Examples**```# ad-hoc segment scan from content table# get a list of content documents that# - have aspects=article (aspects = article,product, etc)# - has imageurlcurl -s -H "Authorization: $LIOKEY" \ -XGET "https://api.lytics.io/api/segment/scan?sortfield=created&limit=10" -d 'FILTER AND ( EXISTS imageurls aspects = "article")FROM content' | jq '.'# Create a content-segment# - uses "ALIAS" as id for create/update, must be uniquecurl -s -H "Authorization: $LIOKEY" -H "Content-Type: text/plain" \ -XPOST "$LIOAPI/api/segment" -d 'FILTER AND ( EXISTS imageurls aspects = "article")FROM contentWITH name = "My Articles"ALIAS my_articles' | jq '.'# grab just those content-docs using named segment scancurl -s -H "Authorization: $LIOKEY" \ -XGET "https://api.lytics.io/api/segment/my_articles/scan?sortfield=created&limit=10" \ | jq '.'# grab recommended articles for single usercurl -s -H "Authorization: $LIODATAKEY" \ -XGET "https://api.lytics.io/api/content/recommend/:your_account_id/user/user_id/123456" \ | jq '.'```

Lytics Content API is one of 34 APIs that Lytics publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Content. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 30 operations across 23 paths, and defines 27 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 2 base URLs: https://api.lytics.io, https://api.lytics.io/v2.

30 operations 23 paths 27 schemas 2 DELETE17 GET10 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://api.lytics.io/v2
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Lytics Content API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (ApiKeyAuth).

Paths & Operations 30

Across 23 paths, the API surfaces 30 operations — 2 DELETE, 17 GET, 10 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Content 30

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 Classifi…

GET
/api/content/topic
ContentTopics
ContentTopics 2 params → 200
GET
/api/content/topic/{topic}
ContentTopicSummary
ContentTopicSummary 2 params → 200
GET
/api/content/rollup/{label}
ContentTopicRollupSummary
ContentTopicRollupSummary 2 params → 200
GET
/api/content/topicrollup
ContentTopicRollupList
ContentTopicRollupList → 200
GET
/api/content/topicblocklist
Content Topic Blacklist Fetch
Content Topic Blacklist Fetch → 200
POST
/api/content/topicblocklist
Content Topic Blacklist Create
Content Topic Blacklist Create → 200
PUT
/api/content/topicblocklist
Content Topic Blacklist Update
Content Topic Blacklist Update → 200
GET
/api/content/topicrollup/{id}
ContentTopicRollup Fetch
ContentTopicRollup Fetch 2 params → 200
POST
/api/content/topicrollup/{id}
ContentTopicRollup Create
ContentTopicRollup Create 2 params → 201
DELETE
/api/content/topicrollup/{id}
ContentTopicRollup Delete
ContentTopicRollup Delete 2 params → 204
GET
/api/content/doc
ContentDocument
ContentDocument 3 params → 200
GET
/api/content/doc/classify
Content Classify
Content Classify Debug 3 params → 200
POST
/api/content/doc/classify
Content Classify
Content Classify 3 params → 200
GET
/api/content/recommend/user/{fieldname}/{fieldval}
Content Recommendation
Content Recommendation 12 params → 200
GET
/api/content/recommend/segment/{segId}
Content Segment Recommendation
Content Segment Recommendation 6 params → 200
GET
/api/content/recommend/{account}/user/{fieldname}/{fieldval}
Public Content Recommendation
Public Content Recommendation 13 params → 200
GET
/api/content/taxonomy
Content Taxonomy
Content Taxonomy 8 params → 200
POST
/api/content/corpus
Content Corpus
Content Corpus 4 params → 200
GET
/api/content/filter/topic
Content Plot
Content Plot 5 params → 200
POST
/api/content/doc/{docField}/{docId}/topic/{topicLabel}
Topic Add
Topic Add 5 params → 200
DELETE
/api/content/doc/{docField}/{docId}/topic/{topicLabel}
Topic Remove
Topic Remove 5 params → 204
POST
/api/content/crawl
Content Crawl
Content Crawl 3 params → 200
GET
/api/content/metrics
Content Metrics
Content Metrics → 200
GET
/api/content/topic/cluster
Content Topic Clusters
Content Topic Clusters 5 params → 200
POST
/api/content/topic/cluster
Create Content Topic Clusters
Create Content Topic Clusters 5 params → 200
GET
/api/content/topic/cluster/{topicId}
Content Topic Cluster
Content Topic Cluster 5 params → 200
POST
/content/align
Get content alignment with a set of topics
3 params body → 200400500
POST
/content/classify
Classify a URL
1 param → 200400500
POST
/content/enrich
Enrich a URL or text with Topics
2 params → 200400500
GET
/content/opportunity
Get content opportunities
1 param → 200400500

Schemas 27

The contract defines 27 schemas that model the data the API accepts and returns. The most detailed are lioerrors.ApiV2ErrorOut (4 properties), models.ApiResponse (4 properties), models.ContentOpportunityTopic (4 properties), models.ContentOpportunityDimension (3 properties). Each schema is shown below with its type and property counts.

ContentClassifyModel
object
3 properties
ContentTopicsModel
object
3 properties
ContentDocumentModel
object
3 properties
ContentTopicBlocklistModel
object
3 properties
ContentSegmentRecommendationModel
object
3 properties
ContentCorpusModel
object
3 properties
ContentTaxonomyModel
object
3 properties
ContentTopicSummaryModel
object
3 properties
ContentTopicClustersModel
object
3 properties
ContentCrawlModel
ContentRecommendationModel
object
3 properties
ContentTopicRollupModel
object
1 property
ContentTopicRollupListModel
object
1 property
ContentMetricsModel
object
3 properties
TopicCurationModel
object
3 properties
ContentPlotModel
object
3 properties
ContentTopicRollupSummaryModel
object
3 properties
models.ContentClassifyResp
object
2 properties
models.ApiErrorResponse
object
3 properties
models.ContentAlignResp
object
1 property
models.ContentOpportunityResp
object
1 property
models.ContentOpportunityTopic
object
4 properties
models.ContentEnrichResp
object
3 properties
lioerrors.ApiV2ErrorOut
object
4 properties
models.ContentOpportunityDimension
object
3 properties
models.ApiResponse
object
4 properties
models.ContentAlignReq
object
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

lytics-content-api-openapi.yml Raw ↑

Other APIs Lytics publishes across the network.

Lytics Account API
Lytics Account Settings API
Lytics Auth API
Lytics Auths API
Lytics Catalog API
Lytics Connections API
Lytics Data Models API
Lytics Data Upload API
Lytics Experience API
Lytics Flows API
Lytics Jobs API
Lytics Metric API
Where this information came from

This is an independent, third-party profile of Lytics Content API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.