# Lytics Content API **Canonical:** https://apis.io/apis/lytics/lytics-content-api/ **Provider:** Lytics — https://apis.io/providers/lytics/ **Base URL:** https://api.lytics.io/v2 **Documentation:** https://docs.lytics.com/reference Lytics Content API is one of 34 APIs that [Lytics](https://apis.io/providers/lytics/) publishes on the [APIs.io](https://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. 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 Classification** Content classification refers to the Lytics automated process of taking text, URL, image based content and 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 imageurl curl -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 unique curl -s -H "Authorization: $LIOKEY" -H "Content-Type: text/plain" \ -XPOST "$LIOAPI/api/segment" -d ' FILTER AND ( EXISTS imageurls aspects = "article" ) FROM content WITH name = "My Articles" ALIAS my_articles ' | jq '.' # grab just those content-docs using named segment scan curl -s -H "Authorization: $LIOKEY" \ -XGET "https://api.lytics.io/api/segment/my_articles/scan?sortfield=created&limit=10" \ | jq '.' # grab recommended articles for single user curl -s -H "Authorization: $LIODATAKEY" \ -XGET "https://api.lytics.io/api/content/recommend/:your_account_id/user/user_id/123456" \ | jq '.' ``` ## Operations (30) | Method | Path | Summary | |---|---|---| | GET | `/api/content/topic` | ContentTopics | | GET | `/api/content/topic/{topic}` | ContentTopicSummary | | GET | `/api/content/rollup/{label}` | ContentTopicRollupSummary | | GET | `/api/content/topicrollup` | ContentTopicRollupList | | GET | `/api/content/topicblocklist` | Content Topic Blacklist Fetch | | POST | `/api/content/topicblocklist` | Content Topic Blacklist Create | | PUT | `/api/content/topicblocklist` | Content Topic Blacklist Update | | GET | `/api/content/topicrollup/{id}` | ContentTopicRollup Fetch | | POST | `/api/content/topicrollup/{id}` | ContentTopicRollup Create | | DELETE | `/api/content/topicrollup/{id}` | ContentTopicRollup Delete | | GET | `/api/content/doc` | ContentDocument | | GET | `/api/content/doc/classify` | Content Classify | | POST | `/api/content/doc/classify` | Content Classify | | GET | `/api/content/recommend/user/{fieldname}/{fieldval}` | Content Recommendation | | GET | `/api/content/recommend/segment/{segId}` | Content Segment Recommendation | | GET | `/api/content/recommend/{account}/user/{fieldname}/{fieldval}` | Public Content Recommendation | | GET | `/api/content/taxonomy` | Content Taxonomy | | POST | `/api/content/corpus` | Content Corpus | | GET | `/api/content/filter/topic` | Content Plot | | POST | `/api/content/doc/{docField}/{docId}/topic/{topicLabel}` | Topic Add | | DELETE | `/api/content/doc/{docField}/{docId}/topic/{topicLabel}` | Topic Remove | | POST | `/api/content/crawl` | Content Crawl | | GET | `/api/content/metrics` | Content Metrics | | GET | `/api/content/topic/cluster` | Content Topic Clusters | | POST | `/api/content/topic/cluster` | Create Content Topic Clusters | | GET | `/api/content/topic/cluster/{topicId}` | Content Topic Cluster | | POST | `/content/align` | Get content alignment with a set of topics | | POST | `/content/classify` | Classify a URL | | POST | `/content/enrich` | Enrich a URL or text with Topics | | GET | `/content/opportunity` | Get content opportunities | ## Machine-readable artifacts (6) - **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/lytics/refs/heads/main/openapi/lytics-content-api-openapi.yml - **OpenAPI Source** — https://dash.readme.com/api/v1/api-registry/1y876emrv8pb2i - **Documentation** — https://docs.lytics.com/reference - **APIReference** — https://docs.lytics.com/reference - **ToolCrosswalk** — https://raw.githubusercontent.com/api-evangelist/lytics/refs/heads/main/mcp/lytics-tool-crosswalk.yml - **OpenAPI Source** — https://dash.readme.com/api/v1/api-registry/10ej22ml8a94fx ## Other Lytics APIs (12) - [Lytics Account API](https://apis.io/apis/lytics/lytics-account-api/) - [Lytics Account Settings API](https://apis.io/apis/lytics/lytics-account-settings-api/) - [Lytics Auth API](https://apis.io/apis/lytics/lytics-auth-api/) - [Lytics Auths API](https://apis.io/apis/lytics/lytics-auths-api/) - [Lytics Catalog API](https://apis.io/apis/lytics/lytics-catalog-api/) - [Lytics Connections API](https://apis.io/apis/lytics/lytics-connections-api/) - [Lytics Data Models API](https://apis.io/apis/lytics/lytics-datamodels-api/) - [Lytics Data Upload API](https://apis.io/apis/lytics/lytics-dataupload-api/) - [Lytics Experience API](https://apis.io/apis/lytics/lytics-experience-api/) - [Lytics Flows API](https://apis.io/apis/lytics/lytics-flows-api/) - [Lytics Jobs API](https://apis.io/apis/lytics/lytics-jobs-api/) - [Lytics Metric API](https://apis.io/apis/lytics/lytics-metric-api/) ## Tags Content --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/lytics/lytics-content-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/lytics/.