See the fields returned by the article endpoints.
- Apple News API 1.0.0+
Text that appears alongside article headlines — author name, channel name, subtitle, and so on.
Maximum length: 100 characters.
metadata from the Apple News Format article.
The date and time the article was created.
The content of the article, as an Apple News Format document.
The unique identifier of the article.
Candidate To Be Featured
A Boolean value that indicates whether or not this article should be considered for featuring in News.
A Boolean value that indicates whether this article should be public (live) or should be a preview that is only visible to members of your channel. Set
false to publish the article immediately and make it visible to all News users.
If your channel has not yet been approved to publish articles in Apple News Format, setting
false results in an
true if your channel has not yet been approved to publish articles in Apple News Format;
false if your channel has been approved.
A Boolean value that indicates whether this article consists of sponsored content for promotional purposes. Sponsored content must be marked as such; channels that do not follow this policy may be suspended.
is, if you do not want the sponsored article to appear in your channel’s feed, set sections to
 (an empty array).
The URL of the channel in which the article appears.
A string value that indicates the viewing audience for the content. The types of audiences or ratings are
null if unspecified. A
MATURE rating indicates explicit content that is only appropriate for a specific audience.
The date and time this article was last modified.
The current revision token for the article.
The latest revision must be sent when issuing a request to Update an Article.
The value of this field must match the latest revision from an earlier Create, Read, or Update Article call. This field prevents multiple users from updating an article simultaneously, which would result in data loss.
The URL to the article within the News app. The
share field applies only on devices with iOS 9 or later installed.
The current state of the article, which can be one of the following:
PROCESSING: The article has been published and is in processing.
LIVE: The article has been published, has finished processing, and is visible in the News app.
PROCESSING: A previous version of the article is visible in the News app, and an update is currently in processing.
TAKEN: The article was previously visible in the News app, but was taken down.
FAILED: The article failed during processing and is not visible in the News app.
FAILED: A previous version of the article is visible in the News app, but an update failed during processing.
DUPLICATE. The article is a duplicate of another article and is not visible in the News app.
The title of the article, as specified in the Apple News Format document.
A list of warning messages indicating nonfatal problems with the article.