A relationship between your article and another Apple News article.



The type of relationship between the article and the linked document.

Valid values:

  • related. The linked article is an article on the same topic, is part of the same dossier, or provides more information about the subjects discussed.

  • promoted. The linked article is not directly related, but deserves additional promotion because the article covers another important topic. This value also puts the promotional article at the top of the channel feed.


The URL for the link. This link can either be an Apple News link, like https://apple.news/[article_id], or a link to an article on your website, as long as the website link matches the canonicalURL metadata property of the linked article. For more information about canonicalURL, see Metadata.


You can control lists of links that users see in articles by using the links array in Metadata. If you are linking to a sponsored article, ensure that the Create an Article request uses the isSponsored flag.


{ "metadata": { "excerpt": "2018 Super Bowl", "thumbnailURL": "bundle://SuperBowl.jpg", "datePublished": "2018-09-09T14:45:45+00:00", "dateCreated": "2018-09-08T12:41:00+00:00", "dateModified": "2018-09-10T12:41:00+00:00", "authors": [ "Anne Johnson" ], "campaignData": { "sport": [ "football" ], "event": [ "Superbowl" ], "author": [ "John Appleseed" ] }, "generatorName": "Generator", "generatorVersion": "1.0", "canonicalURL": "https://example.com/articles/2015/original-article.html", "links": [ { "URL": "https://apple.news/AT6kNQslCQy6EE4bF8hpOoQ", "relationship": "related" } ] }}

See Also

Article Metadata

object Metadata

Information about your article, including author name, creation date, publication date, keywords, and excerpt.