Apple News API

Publish and manage Apple News Format articles.

Overview

The Apple News API delivers Apple News Format articles to be published in the Apple News app and helps you manage and monitor those articles after they’ve been published.

Based on representational state transfer (REST) technology, the Apple News API has typical RESTful characteristics, which means that it:

  • Does operations on a set of resources. Resources are objects that have a type, associated data, and relationships to other resources. In the Apple News API, resources include channels, sections that you’ve set up for your channels (for example, Sports or Politics), and the articles that you want to publish and manage.

  • Has stateless operations. Interactions with the create, read, update, and delete (CRUD) operations are handled using only the information that comes with the request—no previous information or state is assumed. Therefore, requests made using the Apple News API must include all information required to complete the operation within the request.

Topics

First Steps

Publishing and Managing Apple News Format Articles: Main Steps

Get the prerequisites and main steps for using the Apple News API.

Apple News API Field Types

Understand the standard field types used in the Apple News API.

About the News Security Model

Learn how the Apple News API authenticates clients, authorizes your news channel using an API key, and enforces confidentiality.

Channel

Read Channel Information

Get details about your channel including name, corresponding website, and default section.

object Channel

See the fields returned by the read channel endpoint.

object ChannelLinks

See the links returned by the read channel endpoint.

object ChannelResponse

See which objects make up the channel response.

Sections

List All Sections

See a list of available sections in your channel.

Read Section Information

Get the specified section's name and channel, and learn whether it’s a default section.

Promote Articles in a Section

Set the list of promoted articles for the specified section.

object Section

See the fields returned by the section endpoints.

object SectionLinks

See the links returned by the section endpoints.

object SectionResponse

See which objects make up the section response.

object PromoteArticleRequest

See the required field for the promote article request.

object PromoteArticleResponse

See the field returned by the promote article response.

Articles

Create an Article

Publish an article to your channel.

Read Article Information

Retrieve information about an article, such as the revision number, maturity rating, and so on.

Search Articles in a Channel

See a list of all articles in a channel that match the specified search criteria.

Search Articles in a Section

See a list of all articles in a section that match the specified search criteria.

Update an Article

Update an existing article in your channel.

Delete an Article

Delete the specified article from your channel.

object Article

See the fields returned by the article endpoints.

object ArticleLinks

See the links returned by the article endpoints.

object ArticleResponse

See which objects make up the publish article, read article, and update article responses.

object Meta

See the object that wraps the throttling information that's returned for the publish article and read article endpoints.

object Throttling

See the object that wraps the throttling information that's returned for the create article and update article endpoints.

object Create Article Metadata Fields

See the optional metadata fields for the create article request.

object Update Article Metadata Fields

See the metadata fields for the update article request.

object SearchResponse

See the fields returned by the search article endpoints.

Errors

Error Messages

Understand the error message format for the Apple News API.

object Warning

See the properties of a warning returned by the Apple News API.

object Error

See the properties of an error returned by the Apple News API.

type Code

See the error codes returned by the Apple News API.

type Status

See the HTTP status codes returned by the Apple News API.

See Also

Article Publication and Management

What's New in the Apple News API

Check out new features and enhancements.