Use your CMS with News Publisher
With Apple News Format you can create articles in your existing content management system (CMS) and then publish them directly to News. You can connect your CMS to News Publisher via a plug-in. Third-party plug-ins are available for WordPress, Drupal, and other platforms. You can also write your own API code to connect your CMS to News Publisher. See the Apple News API for information about writing API calls and interpreting API responses. See Apple News Format for details on how to design and lay out articles in Apple News Format.
About the Apple News API
The Apple News API is a REST API for publishing Apple News Format articles to News. With the help of this API you can also retrieve, update, and delete published articles and get basic information about your channel and sections. For more information about Apple News API, see Apple News API.
To use the Apple News API, you need the following information, which you can request in the Settings tab in News Publisher.
API Key ID
API Key Secret: The secret is shown only when it’s first issued, but you can get the channel ID and API Key ID any time.
The Apple News API provides the following operations in News resources:
List and Read section
Read, Create, Update, Promote, and Delete article
API requests vary depending on the type of operation. For example, to read a channel, you need only supply a channel ID (plus authentication information). To create an article, you need additional information, such as a complete Apple News Format document, various API request metadata, and parts that contain images and other resources.
When you publish an article via the API, the delivery time to the News app may vary depending on the complexity of the article and the number of images it contains. You don’t need to worry about caching or other common content delivery issues—Apple manages all content distribution and delivery.
The API uses an industry-standard authorization mechanism to protect your data and ensure that only approved clients have access to your content. A command-line interface is available.
Connect your CMS to News Publisher
Go to icloud.com, sign in, then click News Publisher.
On the welcome screen, click Go to Settings, then click the link to use the Apple News API or a plug-in to connect your CMS to News Publisher.
Note: If you’ve already created an article, go to Settings > Connect CMS.
Click Get an API Key, then write down the channel ID, key ID, and secret that appear in the dialog.
You can view your API Key ID and channel ID at any time by going to Settings > Connect CMS, but the secret appears only once. You need this information when using the API key with your CMS.
Note: If you lose the API key secret, go to Settings > Connect CMS, click the API Key link, then click Replace API Key. If you replace the key, remember to enter the information for the new key in your plug-in or code, as the old key is no longer valid.
Connect your CMS to News Publisher with the Apple News API.
Deliver at least three articles from your CMS to News Publisher.
To see how your articles will look in News on your Mac with macOS 10.14 or later, click the preview button, then click View.
To view the article in News on an iPhone, iPad, or iPod touch (with iOS 9 or later or iPadOS 13 or later), click the preview button, click Copy, and share the preview link to your device (via email, AirDrop, or message, for example). Then open Safari on the device and enter the link.
News launches and the preview appears in the Drafts section.
Only articles uploaded as a bundle or delivered from your CMS can be previewed on a device.
Note: When working on the device, you must be signed in to iCloud with the Apple ID you use for News Publisher, and iCloud must be turned on for the News app.
When you’re happy with your channel and the way its articles look on iPhone, iPad, or Mac, click Submit for Approval in News Publisher.
Apple notifies you by email when your channel and content are approved. After you receive that email, return to News Publisher and complete the steps described in Publish ANF articles.