Definition/Requirement

"Featured articles" are a bit different than News.

News is user submitted. Whereas "Features articles" are written by MAL's editorial team and are usually more in content. There will be some differences in the model objects.

👉 We'll dropping the word "Featured" and calling them simply as "Articles" in Jikan,.

Endpoints

Article Tags

Article Tags: https://myanimelist.net/featured/tag

$jikan->getArticleTags($request)

Categories are listed here in a similar manner to genre listing. So we can re-use the same parser here probably.

Recent Articles

Recent Articles: https://myanimelist.net/featured

$jikan->getArticles(new ArticlesRequest(int $page))

Pinned Articles

Pinned Articles: https://myanimelist.net/featured

MAL pins/sets to feature usually 4 articles at the top of the same recent articles page. I don't want to return this in getArticles as it implements Results and that work break it.

$jikan->getPinnedArticles(new ArticlesPinnedRequest())

Note: ArticlesPinnedRequest is the same as ArticlesRequest but without the pagination. Pinned articles are only on the first page.

Article By Tag

News By Tag: https://myanimelist.net/featured/tag/events

$jikan->getArticleByTag(new ArticleByTagRequest(string $tag, int $page))

Article Search

Article Search: https://myanimelist.net/featured/search?cat=featured&q=ghost+in+the+shell

$jikan->getArticleSearch(new ArticleSearchRequest(string $query, int $page))

Response Objects

Tags

Unlike News, a category here is a Tag itself as there's no higher hierarchy.
We'll simply re-use the same approach as genre listing. where a list of MalUrl is returned.

Could possibly re-use TagMeta from News as well.

ArticleByID

MAL URL: https://myanimelist.net/featured/2380/Anime_Expo__Lookback_Special
https://myanimelist.net/featured/2378/Ni_no_Kuni__Cross_Worlds_Global_Version_Release_on_the_Horizon
https://myanimelist.net/featured/1087/The_Philosophy_Behind_Ghost_in_the_Shell

Results

The following will implement Results.

• Recent Articles
• Article By Tag
• Article Search

getResults() will return an array of ArticleListItem

ArticleListItem