Contents

Read Article Information

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

URL

GET https://news-api.apple.com/articles/{articleId}

Path Parameters

NameTypeDescription
articleId Requiredstring

The UUID or the Share URL ID of the article to get.

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
ArticleResponse

  • The request was successful.

  • The Apple News team optimized the article. Contact your Apple News technical representative if you need to update or delete the article.

400Bad Request
Content-Type: application/json
Error

  • MISSING. You didn’t include the Article UUID or the Share URL ID field in the request. Key path: articleId.

  • INVALID_TYPE. The value you specified for the article is not of the correct type for that field. Key path: articleId.

401Unauthorized
Content-Type: application/json
Error

You didn’t include the Authorization header. Key path: N/A

403Forbidden
Content-Type: application/json
Error

You tried to access an article your API key doesn’t have permission to access. Key path: N/A

404Not Found
Content-Type: application/json
Error

  • The endpoint you tried to access doesn’t exist. Key path: N/A

  • The article you tried to access doesn’t exist. Key path: articleId.

Discussion

Use the Read Article Information endpoint to retrieve information about the article (Article), article links (ArticleLinks), meta (Meta), and optional metadata fields (Create Article Metadata Fields).

Example

See Also

Articles