# MediaService

Access generic anime or manga workflows through `anilist.media`.

Use this service when code should work with either media type. Use `anilist.anime` or `anilist.manga` when you want domain-specific helpers.

## Methods

| Method | Auth | Returns |
| --- | --- | --- |
| `getMediaById(id)` | No | `Media` |
| `getMediaList(userId, mediaType, status?)` | Depends on list privacy | `MediaListCollection` |
| `getMediaListByUsername(userName, mediaType, status?)` | Depends on list privacy | `MediaListCollection` |
| `getGenres()` | No | `GenreCollection` |
| `getMediaTags(status?)` | No | `MediaTagCollection` |
| `getAiringSchedule(id)` | No | `AiringSchedule` |
| `getAiringSchedulesByMedia(mediaId, page?, perPage?)` | No | `Page.airingSchedules` |
| `getReviews(mediaId, page?, perPage?)` | No | `Page.reviews` |
| `getRecommendationsPage(mediaId, page?, perPage?)` | No | `Page.recommendations` |
| `saveReview(input)` | Yes | `SaveReview` |
| `rateReview(reviewId, rating?)` | Yes | `RateReview` |
| `deleteReview(id)` | Yes | `DeleteReview` |
| `saveRecommendation(mediaId, mediaRecommendationId, rating?)` | Yes | `SaveRecommendation` |

`mediaType` is `"ANIME"` or `"MANGA"`. `status` is an optional
`MediaListStatus` filter.

Selected calls use normalized roots: `media` for `getMediaById` and
`mediaListCollection` for list methods. See the
[selection migration guide](../selection-migration.md).

## Lookup Any Media

```typescript
const media = await anilist.media.getMediaById(16498);

console.log(media.Media?.type);
console.log(media.Media?.title?.userPreferred);
```

```typescript
const { media: selectedMedia } = await anilist.media.getMediaById(16498, {
	select: { media: { id: true, type: true, title: { userPreferred: true } } },
});
```

## Read A User List

```typescript
const animeList = await anilist.media.getMediaListByUsername(
	"example_user",
	"ANIME",
);

for (const group of animeList.MediaListCollection?.lists ?? []) {
	console.log(group?.entries?.length ?? 0);
}
```