Article

Represents an input article to be analyzed.

Fields

Property	Required	Type	Description
id	True	string	Unique identifier for the article.
title	False	string	Title of the article.
lead	False	string	Lead paragraph (also called abstract or summary).
text	False	string	Main body of the article. Required if paraSpecs is missing or empty. Cannot be used together with paraSpecs.
paraSpecs	False	List[ParaSpec]	Alternative to using title, lead, and text. Defines structured article paragraphs. Mutually exclusive with those three fields.
language	False	string	Language of the article, in ISO 639 format (e.g., en, fr). If not specified, language will be detected automatically.
publishDate	False	string	Publication date of the article in ISO 8601 format (e.g., 2025-01-01T12:00:00Z).
categories	False	List[Category]	Topic categories or sections (e.g., "Politics", "Technology"). Supports both standard and custom taxonomies.
recommendation	False	Recommendation	Optional recommendation settings (e.g., for suggesting related articles or images).
metadata	False	Map[string, string]	Arbitrary metadata related to the article (e.g., source, author, URL).