Analytics
Analytics - Taxonomies

Get Label Distribution

Changed on

Get label distribution.

Analyzes label usage including:

  • Top labels by assignment count
  • Label popularity percentages
  • Confidence by label

Use Cases:

  • Understand label usage
  • Identify most common categories
  • Balance taxonomy coverage
get/v1/analytics/taxonomies/{taxonomy_id}/labels

Request

  • Base URL: https://api.mixpeek.com
  • URL: https://api.mixpeek.com/v1/analytics/taxonomies/{taxonomy_id}/labels
  • Auth: HTTP bearer and API key in header X-Namespace

Path parameters

taxonomy_idstring required

Query parameters

hoursinteger
limitinteger

Response

Successful Response

taxonomy_idstring required
total_labelsinteger required

Distinct labels that received at least one assignment in the window. This is the TRUE count and is not capped by limit; it used to be len(labels), i.e. the page size. Note it counts labels SEEN, so it is not the taxonomy's label vocabulary and cannot tell you which nodes are empty.

labels_returnedinteger

How many labels this page actually carries. Lower than total_labels means the response is truncated by limit.

total_assignmentsinteger

Assignments across ALL labels in the window, uncapped. Each LabelMetric.percentage is computed against this, so the percentages are shares of the whole rather than of the page.

truncatedboolean

True when labels were dropped by limit.

Changes

  • 61a175e8eb9aRevision changes
    • warning

      removed the optional property from the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 7dc0581791b2Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status