LYlytics
Content

Content Topic Clusters

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.

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

Query parameters

account_idstring

Your Lytics account ID.

limitstring

number of label rollups to produce

directionstring

direction to follow topic dependencies, either "in" or "out"

penaltystring

penalty to apply as traversal depth increases, where a lower value introduces a higher penalty

thresholdstring

threshold at which neighbor topics are determined, where a lower value introduces a more lenient rule

Response

OK

messagestring
statusnumber

Example response

{
  "data": {
    "clusters": [
      [
        "Baking",
        "Cakes",
        "Cupakes",
        "Cookies"
      ],
      [
        "Grilling",
        "Beef",
        "Chicken",
        "Steak"
      ]
    ],
    "coverage": 0.2062
  },
  "message": "success",
  "status": 200
}

Changes

No recorded changes to this operation across all 1 revision of this API.