Tag

Semantic tags are used to express the content of the article and provide better categorization and indexing.

Fields

Property	Required	Type	Description
id	True	string	ID of the tag used to refer to it from other objects
gkbId	False	string	Unique identifier of this tag in Geneea Knowledge Base
stdForm	True	string	Standard form of the tag, abstracting away from its alternative names
type	True	string	Tag type: media - tags primarily for readers; includes Geneea topics, which have feats.topic: geneea media-topic - IPTC Media Topics iab-content-taxonomy – IAB Content Taxonomy
relevance	True	number	Relevance of the tag relative to the content of the document. See this guide for more information.
mentions	False	List[TagMention]	Text segments related to this tag, when appropriate
feats	False	Map[string, string]	Custom features extending the tag information. All values are encoded as strings. See Custom Features below for the list of available keys.
gkbProperties	False	List[GkbProperty]	Geneea Knowledge Base properties

Custom Features (feats)

The feats object contains additional metadata as string key-value pairs. The available features depend on your account configuration and the tag type.

Deprecation and Duplicates

These features indicate knowledge base lifecycle changes. See Deprecated and Duplicate IDs for more information.

Key	Value Type	Examples	Description
duplicateGkbIds	Comma-separated GKB IDs	"G8ad70d13-E,Gfd6d708c-C"	Deprecated duplicate knowledge base IDs that have been merged into this tag's ID.
replacedByGkbId	GKB ID	"G22262439"	The active knowledge base ID that replaces this deprecated item.
deprecated	Boolean	"true"	Present when the knowledge base item has been deprecated or replaced.

Derived Entities

These features are present on entity-based tags when the underlying entity was derived from other entities rather than mentioned directly.

Key	Value Type	Examples	Description
derivedBy	Comma-separated derivation relation names	"country", "region,city"	Relation(s) used to derive the entity. See Derived Entities.
derivedOnly	Boolean	"true"	Present when the entity was inferred from other entities and is not mentioned directly in the text.

Knowledge Base and Classification

Key	Value Type	Examples	Description
wikidataId	Wikidata ID	"Q3052772"	External identifier linking to the corresponding Wikidata item.
gkbEntityType	Enum	"person", "location"	Entity type from the Geneea Knowledge Base.
topic	Enum	"geneea"	Marks Geneea Topics tags.
MediaTopicId	Media Topic ID	"11000000"	IPTC Media Topic identifier.
iabId	IAB Topic ID	"178"	IAB Content Taxonomy identifier.
externalId	String		Identifier linking to an Editorial Tag.

Simple Mentions

These features provide a lightweight way to locate an early occurrence of the tag in the original input text — useful for linking or highlighting without requesting the full mentions output.

The mentions are searched only in permitted paragraph types (typically just body text paragraphs) in most customer configurations, tag mentions in the title and abstract/lead paragraphs are skipped. Typically, the first such mention is returned; in very rare cases we might return another mention or no mention at all.

Key	Value Type	Examples	Description
mentionText	String	"Macron"	The surface text of the mention.
mentionParaSpecId	"<index>:<type>"	"3:BODY"	Paragraph reference — the paragraph index and its type (TITLE, ABSTRACT (lead), or BODY).
mentionParaSpecSpan	"<offset>:<length>"	"42:6"	Character span (in Unicode code points) of the mention within its paragraph. These are raw offsets into the input text, before any HTML conversion, whitespace normalization, etc.