A relationship between your article and another Apple News article.



The URL for the link. Can be either 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.


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

Valid values:

  • related. The linked article is an article on the same topic, 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 will also put the article at the top of the channel feed.


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": "This is a sample sports article.", "thumbnailURL": "bundle://Football.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": [ "Football" ], "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.

object Issue

The object for defining information about an issue.