Skip to main content

Category

The categories of the article.

This field is typically used to provide information about the section the article is published in (e.g. sport, hobby). Providing this information is optional, because an automatic detection of article topic is always run as part of the analysis. However, when available, it further improves the quality of the results. See our guide, for an overview and examples.

The object can be also perused to provide information about entities known to be mentioned in the article. In such situation, the taxonomy indicates the type of the entity (entity_person, entity_organization, entity_location, entity_product, entity_event, etc.) and the code stores the textual representation of the entity (e.g., Paris).

Fields

PropertyRequiredTypeDescription
taxonomyTruestringThe category taxonomy (MediaTopic for IPTC media topics, Custom for custom categories used by the publisher
codeTruestringThe name of the category