---
title: "Content Topic Clusters"
method: GET
path: "/api/content/topic/cluster"
tags: ["Content"]
---

# Content Topic Clusters

`GET /api/content/topic/cluster`

## Request

- Base URL: `https://api.lytics.io`
- URL: `https://api.lytics.io/api/content/topic/cluster`
- Auth: API key in header `Authorization`

Get a collection of the most central topics in account's topic graph, with each topic's corresponding cluster.  This endpoint is meant
to be used as a means to experiment with the `limit`, `direction`, `penalty`, and `threshold` parameters to create a set of clusters
that encompass meaningful topics and the coverage of topics that these clusters SUMMIZE in terms of relative centrality.  Once values
for those parameters yield a set of optimal clusters, they should be sent to the topic clusters POST endpoint to create topic rollups.

## Query parameters

- `account_id` string
- `limit` string
- `direction` string
- `penalty` string
- `threshold` string

## Response `200`

OK

- ContentTopicClustersModel
  - `data` object
    - `clusters` array[]
      - unknown[]
        - unknown
    - `coverage` number
  - `message` string
  - `status` number

---

[API](https://skmtc.dev/lytics/apis/v1-lytics-api.md) - [All operations](https://skmtc.dev/lytics/apis/v1-lytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lytics/apis/v1-lytics-api/revisions/339fd1d88486?raw)