Manga API endpoint
Returns a ranked list of manga from AniList. `sort` defaults to `TRENDING_DESC`; other values are `POPULARITY_DESC`, `SCORE_DESC`, `FAVOURITES_DESC`, `START_DATE_DESC` and `UPDATED_AT_DESC`. Filter by `format`, `genre` or `status`. Paged with `page` (default 1) and `per_page` (default 20, max 50); `has_next_page` shows if more exist.
/manga/rankingsReturns a filterable, sorted manga ranking.
Query parameters:
sort (optional, default TRENDING_DESC) — one of TRENDING_DESC, POPULARITY_DESC, SCORE_DESC, FAVOURITES_DESC, START_DATE_DESC, UPDATED_AT_DESC.format (optional) — one of MANGA, NOVEL, ONE_SHOT.genre (optional) — e.g. Fantasy.status (optional) — one of FINISHED, RELEASING, NOT_YET_RELEASED, CANCELLED, HIATUS.page (optional, default 1); per_page (optional, default 20, max 50).Response includes the echoed filters, total, has_next_page, and results[] (same shape as manga search).
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| id_mal | 20 | |
| type | 20 | MANGA in all 20 |
| title | 20 | |
| format | 20 | MANGA in all 20 |
| status | 20 | FINISHED (13), RELEASING (7) |
| description | 20 | median 624 characters |
| start_date | 20 | |
| end_date | 13 | |
| chapters | 13 | 141 to 706, median 207 |
| volumes | 13 | 13 to 74, median 24 |
| average_score | 20 | 78 to 92, median 84 |
| mean_score | 20 | 78 to 92, median 84 |
| popularity | 20 | 120,069 to 334,728, median 174,638 |
| favourites | 20 | 8,633 to 48,387, median 14,990 |
| trending | 20 | 1 to 60, median 6 |
| genres | 20 | median 4 entries |
| tags | 20 | median 30 entries |
| country_of_origin | 20 | JP (18), KR (2) |
| cover_image | 20 | s4.anilist.co |
| banner_image | 20 | s4.anilist.co |
| site_url | 20 | anilist.co |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| sort | string | No | Order: TRENDING_DESC, POPULARITY_DESC, SCORE_DESC, FAVOURITES_DESC, START_DATE_DESC, UPDATED_AT_DESC. Default TRENDING_DESC. Allowed values: TRENDING_DESC, POPULARITY_DESC, SCORE_DESC, FAVOURITES_DESC, START_DATE_DESC, UPDATED_AT_DESC. | ||
| format | string | No | Format filter: MANGA, NOVEL, ONE_SHOT. Allowed values: MANGA, NOVEL, ONE_SHOT. | ||
| genre | string | No | Genre filter, e.g. Fantasy. | ||
| status | string | No | Status filter: FINISHED, RELEASING, NOT_YET_RELEASED, CANCELLED, HIATUS. Allowed values: FINISHED, RELEASING, NOT_YET_RELEASED, CANCELLED, HIATUS. | ||
| page | integer | No | 1-based page number, default 1 | ||
| per_page | integer | No | Results per page, default 20, max 50 | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/manga/rankings?sort=TRENDING_DESC&format=MANGA&status=FINISHED&page=1" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"sort": "POPULARITY_DESC",
"format": "MANGA",
"page": 1,
"per_page": 20,
"total": 5000,
"has_next_page": true,
"results": [
{
"id": 105398,
"title": {
"romaji": "Chainsaw Man"
},
"format": "MANGA",
"average_score": 84
}
]
}
}Request schema
No body schema
Response schema
#/definitions/anime.mangaRankingsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | anime.MangaRankingsResponse | No | ||||
| data.format | string | No | MANGA | |||
| data.genre | string | No | Fantasy | |||
| data.has_next_page | boolean | No | true | |||
| data.page | integer | No | 1 | |||
| data.per_page | integer | No | 20 | |||
| data.results | array | No | Media record, 50 fields: average_score, banner_image, chapters, country_of_origin, cover_image, description, duration, end_date, episodes, favourites, format, genres and 18 more. Described under Manga Detail API. | |||
| data.sort | string | No | TRENDING_DESC | |||
| data.status | string | No | RELEASING | |||
| data.total | integer | No | 5000 | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/manga/rankings?sort=TRENDING_DESC&format=MANGA&status=FINISHED&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"