Docs
Open Lodol
DocumentationIntegrationsAPI

AniPub

App · Film, TV & Fandom · 10 actions

Look up anime on AniPub, the free community catalogue of about 8,000 titles. Search by title, read a title's poster, synopsis, genres, airing status, episode count and MyAnimeList score, pull its MyAnimeList record and cast with voice actors, browse by genre or by rating, and filter by title, genres and score range. Also checks whether a title is listed and how big the catalogue has grown. No account or API key required.

Actions

ActionWhat it does
Check a title's genreAsk whether AniPub lists a title and whether it is filed under any of the genres you name, and get two yes or no answers to branch on.
Check whether a title is listedAsk whether AniPub lists an exact title, and get its id and episode count if it does.
Count the catalogueRead how many anime AniPub lists and the id of the newest one.
Filter anime by title, genre and scoreFind anime that match part of a title, every genre you name and a MyAnimeList score range, all at once, 20 to a page.
Get an animeRead one anime from AniPub: its poster and banner, synopsis, genres, airing status and dates, studio, episode count and MyAnimeList score.
Get an anime with MyAnimeList data and castRead one anime together with MyAnimeList's record of it (score, rank, popularity, synopsis, studios, themes, trailer) and its main characters with their voice actors.
List anime by genreBrowse the anime AniPub files under a genre, 20 to a page, each with its synopsis, poster and MyAnimeList score.
List top-rated animeBrowse the catalogue from the highest MyAnimeList score down, 10 to a page, each with its synopsis and poster.
Search animeFind anime by part of a title and get every match in one flat list, each with its id, slug and poster.
Search anime page by pageSearch by part of a title and get the matches a page at a time, 20 to a page, each with its synopsis and MyAnimeList score as well as its id and poster.

Check a title's genre

Ask whether AniPub lists a title and whether it is filed under any of the genres you name, and get two yes or no answers to branch on. Capitals do not matter in either. No account or API key required.

Inputs

TitletitletextRequired
The title, spelled as AniPub lists it. Capitals do not matter here, but the rest of the spelling does.
GenresgenrestextRequired
One genre, or several separated by commas. The check passes when the title is filed under any of them. Capitals do not matter.

Outputs

foundtrue/false
Whether AniPub lists the title.
genre_matchestrue/false
Whether it is filed under at least one of the genres. Always false when it is not listed.
genreslist
The genres that were asked about.
titletext
The title that was asked about.
Example output
{
  "found": true,
  "genre_matches": true,
  "genres": [
    "action"
  ],
  "title": "Black Clover"
}

Check whether a title is listed

Ask whether AniPub lists an exact title, and get its id and episode count if it does. One cheap question with a yes or no to branch on: the step for a workflow that should only go on if the title is there. No account or API key required.

Inputs

TitletitletextRequired
The title, spelled exactly as AniPub lists it, capitals included. This is an exact match: use Search anime when you only have part of a title.

Outputs

episode_countnumber
How many episodes AniPub lists for it. Null when it is not listed.
foundtrue/false
Whether AniPub lists it under that exact title.
idnumber
AniPub's number for it, which Get an anime takes. Null when it is not listed.
titletext
The title that was asked about.
Example output
{
  "episode_count": 170,
  "found": true,
  "id": 61,
  "title": "Black Clover"
}

Count the catalogue

Read how many anime AniPub lists and the id of the newest one. Keep the newest id from one run and compare it on the next to notice when titles have been added. No account or API key required.

Inputs

None.

Outputs

countnumber
How many anime AniPub lists.
latest_idnumber
The id of the newest anime. A higher number than last time means titles have been added.
Example output
{
  "count": 8438,
  "latest_id": 8438
}

Filter anime by title, genre and score

Find anime that match part of a title, every genre you name and a MyAnimeList score range, all at once, 20 to a page. Every filter is optional, so this is also the way to list, say, every romance scored 8 or better. Titles with no score on record are left out. No account or API key required.

Inputs

Title containstitletext
Optional. Part of a title to match. Leave empty to match any title.
Genresgenrestext
Optional. One genre, or several separated by commas. A match has to be filed under every one of them. Capitals do not matter.
Lowest scoremin_scorenumber
Optional. The lowest MyAnimeList score to include, from 0 to 10. 0 when empty.From 0 to 10. Default: 0.
Highest scoremax_scorenumber
Optional. The highest MyAnimeList score to include, from 0 to 10. 10 when empty.From 0 to 10. Default: 10.
Pagepagenumber
Optional. Which page, counting from 1. Ask for the next page while the previous result says it has more.At least 1. Default: 1.

Outputs

animelist
The matches on this page, in AniPub's order.
countnumber
How many anime are on this page.
genreslist
The genres every match had to carry. Empty when any genre was allowed.
has_moretrue/false
True when this page was full, so the next page may hold more. Loop on it, asking for page + 1 each time, to walk a whole list.
max_scorenumber
The highest score that was allowed.
min_scorenumber
The lowest score that was allowed.
pagenumber
Which page this is, counting from 1.
titletext
The title text that was matched, or null when any title was allowed.
Example output
{
  "anime": [
    {
      "genres": [
        "action",
        "fantasy",
        "magic"
      ],
      "id": 61,
      "image_url": "https://anipub.xyz/Black-Clover.jpg",
      "mal_score": 8.88,
      "slug": "black-clover",
      "title": "Black Clover",
      "url": "https://anipub.xyz/details/black-clover"
    }
  ],
  "count": 1,
  "genres": [
    "action",
    "fantasy"
  ],
  "has_more": false,
  "max_score": 10.0,
  "min_score": 8.0,
  "page": 1,
  "title": null
}

Get an anime

Read one anime from AniPub: its poster and banner, synopsis, genres, airing status and dates, studio, episode count and MyAnimeList score. Give the id or slug from an earlier step, or just the title. No account or API key required.

Inputs

AnimeanimetextRequired
Which anime. Give AniPub's id (61), its slug (black-clover) or the title as it is spelled on the site (Black Clover): an earlier Search anime step hands over the id or the slug, and a title typed in is looked up by its slug and then by its exact spelling.

Outputs

One anime, as AniPub lists it.

airedtext
When it aired, as text, e.g. Oct 3, 2017 to Mar 30, 2021. Null when unknown.
cover_urltext
The wide banner image, as a full address, or null.
durationtext
How long an episode runs, e.g. 25m, or null.
episode_countnumber
How many episodes AniPub lists for it, or null.
genreslist
The genres AniPub files it under, spelled as AniPub spells them. Empty when it has none.
idnumber
AniPub's number for this anime. Get an anime and Get an anime with MyAnimeList data and cast both take it.
image_urltext
The poster image, as a full address. Null when there is none.
mal_idnumber
Its MyAnimeList id, or null when AniPub has not recorded one.
mal_scorenumber
The MyAnimeList score out of 10, or null when AniPub has not recorded one.
premieredtext
The season it premiered in, e.g. Fall 2017, or null.
producerstext
The producers, as one piece of text, or null.
ratings_countnumber
How many ratings AniPub holds for it, or null.
slugtext
The title's slug, e.g. black-clover, which Get an anime also takes. Null when AniPub has not given it one.
statustext
Whether it is still airing, in AniPub's words: Finished Airing, Ongoing, and so on. Null when unknown.
studiostext
The animation studio or studios, as one piece of text, or null.
synonymstext
Other titles it is known by, as one piece of text, or null when AniPub lists none.
synopsistext
The synopsis, or null when AniPub has none.
titletext
The title, as AniPub lists it.
urltext
The anime's page on anipub.xyz, or null when it has no slug to link by.
Example output
{
  "aired": "Oct 3, 2017 to Mar 30, 2021",
  "cover_url": "https://anipub.xyz/Cover/Black-Clover.jpg",
  "duration": "25m",
  "episode_count": 170,
  "genres": [
    "action",
    "fantasy",
    "magic"
  ],
  "id": 61,
  "image_url": "https://anipub.xyz/Black-Clover.jpg",
  "mal_id": 34572,
  "mal_score": 8.88,
  "premiered": "Fall 2017",
  "producers": "TV Tokyo, Shueisha",
  "ratings_count": 45,
  "slug": "black-clover",
  "status": "Finished Airing",
  "studios": "Pierrot",
  "synonyms": "Burakku Kuroba",
  "synopsis": "Asta and Yuno were abandoned at the same church on the same day. Raised together as children, they came to know of the Wizard King, and promised that they would compete against each other for the position.",
  "title": "Black Clover",
  "url": "https://anipub.xyz/details/black-clover"
}

Get an anime with MyAnimeList data and cast

Read one anime together with MyAnimeList's record of it (score, rank, popularity, synopsis, studios, themes, trailer) and its main characters with their voice actors. The fullest picture AniPub gives of a title, in one step. The MyAnimeList part comes back empty when AniPub cannot tie it to the title, so check it before reading from it. No account or API key required.

Inputs

AnimeanimetextRequired
Which anime. Give AniPub's id (61), its slug (black-clover) or the title as it is spelled on the site (Black Clover): an earlier Search anime step hands over the id or the slug, and a title typed in is looked up by its slug and then by its exact spelling.

Outputs

animeobject
One anime, as AniPub lists it.
character_countnumber
How many characters came back. 0 means the MyAnimeList record is null too.
characterslist
The main characters, up to ten, each with their voice actors. Empty when the MyAnimeList record is null.
myanimelistobject
MyAnimeList's own record of the anime, as AniPub relays it. Null when MyAnimeList had nothing for this title, or when what it had was not for this title.
Example output
{
  "anime": {
    "aired": "Oct 3, 2017 to Mar 30, 2021",
    "cover_url": "https://anipub.xyz/Cover/Black-Clover.jpg",
    "duration": "25m",
    "episode_count": 170,
    "genres": [
      "action",
      "fantasy",
      "magic"
    ],
    "id": 61,
    "image_url": "https://anipub.xyz/Black-Clover.jpg",
    "mal_id": 34572,
    "mal_score": 8.88,
    "premiered": "Fall 2017",
    "producers": "TV Tokyo, Shueisha",
    "ratings_count": 45,
    "slug": "black-clover",
    "status": "Finished Airing",
    "studios": "Pierrot",
    "synonyms": "Burakku Kuroba",
    "synopsis": "Asta and Yuno were abandoned at the same church on the same day. Raised together as children, they came to know of the Wizard King, and promised that they would compete against each other for the position.",
    "title": "Black Clover",
    "url": "https://anipub.xyz/details/black-clover"
  },
  "character_count": 1,
  "characters": [
    {
      "favorites": 4210,
      "image_url": "https://cdn.myanimelist.net/images/characters/9/335891.jpg",
      "mal_id": 132807,
      "name": "Asta",
      "role": "Main",
      "url": "https://myanimelist.net/character/132807/Asta",
      "voice_actors": [
        {
          "image_url": "https://cdn.myanimelist.net/images/voiceactors/2/58083.jpg",
          "language": "Japanese",
          "mal_id": 42125,
          "name": "Kajiwara, Gakuto",
          "url": "https://myanimelist.net/people/42125/Gakuto_Kajiwara"
        }
      ]
    }
  ],
  "myanimelist": {
    "aired": "Oct 3, 2017 to Mar 30, 2021",
    "airing": false,
    "background": null,
    "broadcast": "Tuesdays at 18:25 (JST)",
    "demographics": [
      "Shounen"
    ],
    "duration": "23 min per ep",
    "episodes": 170,
    "favorites": 32187,
    "genres": [
      "Action",
      "Comedy",
      "Fantasy"
    ],
    "image_url": "https://cdn.myanimelist.net/images/anime/2/88336l.jpg",
    "licensors": [
      "Funimation",
      "Crunchyroll"
    ],
    "mal_id": 34572,
    "members": 1873455,
    "popularity": 56,
    "producers": [
      "TV Tokyo",
      "Shueisha"
    ],
    "rank": 371,
    "rating": "PG-13 - Teens 13 or older",
    "score": 8.14,
    "scored_by": 1054612,
    "season": "fall",
    "source": "Manga",
    "status": "Finished Airing",
    "studios": [
      "Pierrot"
    ],
    "synopsis": "Asta and Yuno were abandoned at the same church on the same day. Raised together as children, they came to know of the Wizard King, and promised that they would compete against each other for the position.",
    "themes": [
      "Adventure"
    ],
    "title": "Black Clover",
    "title_english": "Black Clover",
    "title_japanese": "\u30d6\u30e9\u30c3\u30af\u30af\u30ed\u30fc\u30d0\u30fc",
    "trailer_url": "https://www.youtube.com/watch?v=qBcAHHLhF9k",
    "type": "TV",
    "url": "https://myanimelist.net/anime/34572/Black_Clover",
    "year": 2017
  }
}

List anime by genre

Browse the anime AniPub files under a genre, 20 to a page, each with its synopsis, poster and MyAnimeList score. Ask for the next page while the result says there is more. No account or API key required.

Inputs

GenregenretextRequired
The genre to browse, as AniPub spells it: action, adventure, comedy, drama, ecchi, fantasy, harem, magic, romance, school, shounen, supernatural and the rest. Capitals do not matter.
Pagepagenumber
Optional. Which page, counting from 1. Ask for the next page while the previous result says it has more.At least 1. Default: 1.

Outputs

animelist
The anime on this page, in AniPub's order.
countnumber
How many anime are on this page.
genretext
The genre that was browsed.
has_moretrue/false
True when this page was full, so the next page may hold more. Loop on it, asking for page + 1 each time, to walk a whole list.
pagenumber
Which page this is, counting from 1.
Example output
{
  "anime": [
    {
      "id": 61,
      "image_url": "https://anipub.xyz/Black-Clover.jpg",
      "mal_score": 8.88,
      "ratings_count": 45,
      "slug": "black-clover",
      "synopsis": "Asta and Yuno were abandoned at the same church on the same day. Raised together as children, they came to know of the Wizard King, and promised that they would compete against each other for the position.",
      "title": "Black Clover",
      "url": "https://anipub.xyz/details/black-clover"
    }
  ],
  "count": 1,
  "genre": "action",
  "has_more": false,
  "page": 1
}

List top-rated anime

Browse the catalogue from the highest MyAnimeList score down, 10 to a page, each with its synopsis and poster. Page 1 is the best-rated anime AniPub lists; ask for the next page while the result says there is more. No account or API key required.

Inputs

Pagepagenumber
Optional. Which page, counting from 1. Ask for the next page while the previous result says it has more.At least 1. Default: 1.

Outputs

animelist
The anime on this page, best rated first.
countnumber
How many anime are on this page.
has_moretrue/false
True when this page was full, so the next page may hold more. Loop on it, asking for page + 1 each time, to walk a whole list.
pagenumber
Which page this is, counting from 1.
Example output
{
  "anime": [
    {
      "id": 61,
      "image_url": "https://anipub.xyz/Black-Clover.jpg",
      "mal_score": 8.88,
      "ratings_count": 45,
      "slug": "black-clover",
      "synopsis": "Asta and Yuno were abandoned at the same church on the same day. Raised together as children, they came to know of the Wizard King, and promised that they would compete against each other for the position.",
      "title": "Black Clover",
      "url": "https://anipub.xyz/details/black-clover"
    }
  ],
  "count": 1,
  "has_more": false,
  "page": 1
}

Search anime

Find anime by part of a title and get every match in one flat list, each with its id, slug and poster. Quick and unpaged, so it is the step to put before Get an anime when a workflow starts from a title. No account or API key required.

Inputs

Search forquerytextRequired
Part of a title, at least 3 characters. Capitals do not matter, and punctuation is matched as typed.

Outputs

animelist
Every match, in AniPub's order.
countnumber
How many anime matched.
querytext
What was searched for.
Example output
{
  "anime": [
    {
      "id": 61,
      "image_url": "https://anipub.xyz/Black-Clover.jpg",
      "slug": "black-clover",
      "title": "Black Clover",
      "url": "https://anipub.xyz/details/black-clover"
    }
  ],
  "count": 1,
  "query": "black clover"
}

Search anime page by page

Search by part of a title and get the matches a page at a time, 20 to a page, each with its synopsis and MyAnimeList score as well as its id and poster. Use it over Search anime when the synopsis or score matters, or when a common word would match too many titles to take in one go. No account or API key required.

Inputs

Search forquerytextRequired
Part of a title, at least 3 characters. Capitals do not matter, and punctuation is matched as typed.
Pagepagenumber
Optional. Which page, counting from 1. Ask for the next page while the previous result says it has more.At least 1. Default: 1.

Outputs

animelist
The matches on this page, in AniPub's order.
countnumber
How many anime are on this page.
has_moretrue/false
True when this page was full, so the next page may hold more. Loop on it, asking for page + 1 each time, to walk a whole list.
pagenumber
Which page this is, counting from 1.
querytext
What was searched for.
Example output
{
  "anime": [
    {
      "id": 61,
      "image_url": "https://anipub.xyz/Black-Clover.jpg",
      "mal_score": 8.88,
      "ratings_count": 45,
      "slug": "black-clover",
      "synopsis": "Asta and Yuno were abandoned at the same church on the same day. Raised together as children, they came to know of the Wizard King, and promised that they would compete against each other for the position.",
      "title": "Black Clover",
      "url": "https://anipub.xyz/details/black-clover"
    }
  ],
  "count": 1,
  "has_more": false,
  "page": 1,
  "query": "black clover"
}

AnimeThemes

Previous Page

Anthropic

Next Page

On this page

ActionsCheck a title's genreCheck whether a title is listedCount the catalogueFilter anime by title, genre and scoreGet an animeGet an anime with MyAnimeList data and castList anime by genreList top-rated animeSearch animeSearch anime page by page